overlord-cli 0.2606041635.0 → 0.2606050806.0

package/bin/_cli/new-ticket.mjs

@@ -48,10 +48,10 @@ function parseFlags(args) {
 
 function buildUsage(commandName) {
   if (commandName === 'prompt') {
-    return 'Usage: ovld prompt --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
+    return 'Usage: ovld prompt --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id-or-name>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
   }
 
-  return 'Usage: ovld create --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
+  return 'Usage: ovld create --objectives-json \'[{"objective":"..."}]\' [--objectives-file <path>] [--title "..."] [--acceptance-criteria "..."] [--available-tools "..."] [--for-human] [--priority low|medium|high|urgent] [--project-id <id-or-name>] [--agent <agent>] [--model <identifier>] [--delegate <agent>]';
 }
 
 function resolveForHumanFlag(flags) {
@@ -305,15 +305,17 @@ async function createTicket(platformUrl, bearerToken, localSecret, organizationI
   return data.ticket;
 }
 
-function resolveProject(projects, projectId) {
-  if (!projectId) return null;
+export function resolveProject(projects, projectIdOrName) {
+  if (!projectIdOrName) return null;
 
-  const project = projects.find(candidate => candidate.id === projectId);
-  if (!project) {
-    throw new Error(`Unknown project ID: ${projectId}`);
-  }
+  const byId = projects.find(candidate => candidate.id === projectIdOrName);
+  if (byId) return byId;
+
+  const lowerName = projectIdOrName.toLowerCase();
+  const byName = projects.find(candidate => candidate.name?.toLowerCase() === lowerName);
+  if (byName) return byName;
 
-  return project;
+  throw new Error(`Unknown project: ${projectIdOrName}`);
 }
 
 function resolveAgent(agent) {
@@ -424,7 +426,8 @@ Creates a ticket after interactive numbered project selection.
 
 Examples:
   ovld create --objectives-json '[{"objective":"Implement login page"}]'
-  ovld create --objectives-json '[{"objective":"Fix sync bug"}]' --project-id <project-id>
+  ovld create --objectives-json '[{"objective":"Fix sync bug"}]' --project-id <id-or-name>
+  ovld create --objectives-json '[{"objective":"Fix sync bug"}]' --project-id "My Project"
 `);
     return;
   }

package/bin/_cli/protocol.mjs

@@ -2836,10 +2836,12 @@ Project discovery:
   You can also discover the project explicitly:
 
     ovld protocol discover-project
-    ovld protocol discover-project --project-id <project-uuid>
+    ovld protocol discover-project --project-id <id-or-name>
+    ovld protocol discover-project --project-id "My Project"
     ovld protocol discover-project --working-directory /path/to/repo
 
   Use --project-id to override automatic resolution on discover, prompt, or ticket creation.
+  Accepts a UUID or a project name (names are unique per organization).
   Use --personal to create a private ticket without assigning any project.
 
 Subcommands:
@@ -2912,7 +2914,7 @@ discover-project:
     Resolve the Overlord project that corresponds to the current (or given) working directory.
     Uses the caller's configured "Local working directory" for matching.
   Optional:
-    --project-id <uuid>       Resolve this project directly; skips working-directory matching
+    --project-id <id-or-name> Resolve this project directly; skips working-directory matching
     --working-directory <path>  Directory to match (default: current working directory)
     --device-fingerprint <fp>   Prefer resource directories for this registered device
     --device-hostname <name>    Register/update device metadata when fingerprint is provided
@@ -2982,7 +2984,7 @@ search-tickets:
     --status <csv>             Comma-separated statuses, e.g. "draft,next-up,execute"
     --include-completed <bool> Include completed tickets (default: false)
     --limit <n>                Max results 1..50 (default: 8)
-    --project-id <uuid>        Restrict to a single project
+    --project-id <id-or-name>  Restrict to a single project
     --created-by <uuid>        Restrict to tickets created by this user
     --updated-after <iso>      Updated_at >= ISO timestamp
     --updated-before <iso>     Updated_at <= ISO timestamp
@@ -3134,7 +3136,7 @@ prompt:
   Optional:
     --title <text>
     --priority <level>        low | medium | high | urgent
-    --project-id <id>         Explicit project; skips working-directory resolution
+    --project-id <id-or-name> Explicit project (UUID or name); skips working-directory resolution
     --personal                Create the ticket without assigning a project
     --working-directory <path> Override cwd for project resolution (default: cwd)
     --acceptance-criteria <text>
@@ -3173,7 +3175,7 @@ create:
     --session-key <key>
     --ticket-id <ticket_id>
     --working-directory <path>  Resolve project by your configured local working directory (default: cwd)
-    --project-id <id>           Explicit project for standalone draft creation
+    --project-id <id-or-name>   Explicit project (UUID or name) for standalone draft creation
     --personal                  Create a private standalone draft without a project
     --title <text>
     --priority <level>        low | medium | high | urgent
@@ -3219,7 +3221,7 @@ record-work:
   Optional:
     --title <text>            Auto-derived from objective if omitted
     --priority <level>        low | medium | high | urgent
-    --project-id <id>         Skip cwd resolution and use this project explicitly
+    --project-id <id-or-name> Skip cwd resolution and use this project explicitly (UUID or name)
     --working-directory <path> Override cwd for project resolution
     --personal                Create a private ticket when no project should be associated
     --artifacts-json <json>
@@ -3421,8 +3423,10 @@ Examples:
   ovld protocol auth-status
   ovld protocol discover-project
   ovld protocol discover-project --project-id <project-uuid>
+  ovld protocol discover-project --project-id "My Project"              # resolve by name
   ovld protocol discover-project --working-directory /path/to/repo
   ovld protocol prompt --agent codex --objective "Implement feature X"   # auto-resolves project from cwd
+  ovld protocol prompt --project-id "My Project" --objective "Fix bug"   # resolve project by name
   ovld protocol attach --ticket-id 1:899
   ovld protocol attach --ticket-id 1:899 --external-session-id null
   ovld protocol connect --ticket-id 1:899

package/bin/_cli/setup.mjs

@@ -1945,7 +1945,10 @@ function installCodexPermissions() {
 // ---------------------------------------------------------------------------
 
 export async function runSetupCommand(args) {
-  const agent = args[0];
+  const yesFlag = args.includes('--yes') || args.includes('-y') ||
+    /^(1|true|yes|on)$/i.test(String(process.env.AGENT_POD_OVERLORD ?? '').trim());
+  const filteredArgs = args.filter(a => a !== '--yes' && a !== '-y');
+  const agent = filteredArgs[0];
 
   if (agent === '--help' || agent === '-h' || agent === 'help') {
     console.log(`Usage:
@@ -1956,7 +1959,10 @@ export async function runSetupCommand(args) {
   ovld setup antigravity  Install Overlord Antigravity plugin (agy) and protocol policy rules
   ovld setup opencode  Install Overlord connector for OpenCode
   ovld setup all       Prepare all supported agents
-  ovld doctor          Validate installed connectors and check for CLI updates`);
+  ovld doctor          Validate installed connectors and check for CLI updates
+
+Options:
+  --yes, -y            Auto-approve all prompts (for non-interactive / pod environments)`);
     return;
   }
 
@@ -2025,7 +2031,7 @@ export async function runSetupCommand(args) {
       console.log('Agent plugins/connectors prepared successfully!\n');
 
       printAgentPermissionsDescription();
-      const shouldInstallPermissions = await askYesNo(
+      const shouldInstallPermissions = yesFlag || await askYesNo(
         'Would you like to configure agent permissions for Overlord protocol access?',
         true
       );
@@ -2072,7 +2078,7 @@ export async function runSetupCommand(args) {
     if (agentsThatNeedPermissions.length > 0) {
       console.log();
       printAgentPermissionsDescription();
-      const shouldInstallPermissions = await askYesNo(
+      const shouldInstallPermissions = yesFlag || await askYesNo(
         'Would you like to configure agent permissions for Overlord protocol access?',
         true
       );
@@ -2107,7 +2113,7 @@ export async function runSetupCommand(args) {
     if (['claude', 'codex', 'opencode'].includes(agent)) {
       console.log();
       printAgentPermissionsDescription();
-      const shouldInstallPermissions = await askYesNo(
+      const shouldInstallPermissions = yesFlag || await askYesNo(
         'Would you like to configure agent permissions for Overlord protocol access?',
         true
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "0.2606041635.0",
+  "version": "0.2606050806.0",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "homepage": "https://www.ovld.ai/docs/",
   "type": "module",

package/plugins/claude/commands/record-work.md

@@ -24,6 +24,6 @@ After the command succeeds, report the new `TICKET_ID`.
 Rules:
 - Do NOT use this for in-progress work. Use `/prompt` for that.
 - The CLI validates that every changed git-tracked file is represented in `changeRationales` unless `--skip-file-change-check` is passed.
-- If project resolution fails, re-run with `--project-id <id>` or `--personal`.
+- If project resolution fails, re-run with `--project-id <id-or-name>` or `--personal`.
 
 

package/plugins/claude/skills/overlord-ticket/reference/cli.md

@@ -134,11 +134,12 @@ To inspect project resolution explicitly:
 
 ```bash
 ovld protocol discover-project
-ovld protocol discover-project --project-id <project_uuid>
+ovld protocol discover-project --project-id <id-or-name>
+ovld protocol discover-project --project-id "My Project"
 ovld protocol discover-project --working-directory /path/to/repo
 ```
 
-Use `--project-id` when the project id is already known. Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
+Use `--project-id` when the project ID or name is already known (names are unique per organization, matched case-insensitively). Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
 
 ## Creating Projects
 

package/plugins/cursor/skills/overlord-ticket/reference/cli.md

@@ -134,11 +134,12 @@ To inspect project resolution explicitly:
 
 ```bash
 ovld protocol discover-project
-ovld protocol discover-project --project-id <project_uuid>
+ovld protocol discover-project --project-id <id-or-name>
+ovld protocol discover-project --project-id "My Project"
 ovld protocol discover-project --working-directory /path/to/repo
 ```
 
-Use `--project-id` when the project id is already known. Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
+Use `--project-id` when the project ID or name is already known (names are unique per organization, matched case-insensitively). Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
 
 ## Creating Projects
 

package/plugins/overlord/scripts/overlord-mcp.mjs

@@ -64,7 +64,8 @@ const tools = [
       properties: {
         project_id: {
           type: 'string',
-          description: 'Project UUID to resolve directly. Skips working-directory matching.'
+          description:
+            'Project UUID or name to resolve directly. Skips working-directory matching. Names are unique per organization and matched case-insensitively.'
         },
         working_directory: {
           type: 'string',
@@ -1170,6 +1171,11 @@ const searchTicketsTool = {
       limit: {
         type: 'number',
         description: 'Maximum number of results to return (1–50, default 8).'
+      },
+      project_id: {
+        type: 'string',
+        description:
+          'Optional project UUID or name to restrict results. Names are matched case-insensitively.'
       }
     }
   },
@@ -1177,7 +1183,8 @@ const searchTicketsTool = {
     query: args.query,
     statuses: Array.isArray(args.statuses) ? args.statuses.join(',') : args.statuses,
     'include-completed': args.include_completed,
-    limit: args.limit
+    limit: args.limit,
+    'project-id': args.project_id
   }),
   subcommand: 'search-tickets'
 };

package/plugins/overlord/skills/overlord-ticket/reference/cli.md

@@ -134,11 +134,12 @@ To inspect project resolution explicitly:
 
 ```bash
 ovld protocol discover-project
-ovld protocol discover-project --project-id <project_uuid>
+ovld protocol discover-project --project-id <id-or-name>
+ovld protocol discover-project --project-id "My Project"
 ovld protocol discover-project --working-directory /path/to/repo
 ```
 
-Use `--project-id` when the project id is already known. Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
+Use `--project-id` when the project ID or name is already known (names are unique per organization, matched case-insensitively). Use `--working-directory` to override cwd path matching. If the runtime has an `OVERLORD_DEVICE_FINGERPRINT`, pass `--device-fingerprint "$OVERLORD_DEVICE_FINGERPRINT"` so resource-directory matching prefers the current device.
 
 ## Creating Projects