@cortices/agent 0.3.18 → 0.3.20

package/bin/cortices.mjs

@@ -7,8 +7,41 @@ import { execFileSync } from 'child_process'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 
-// Determine agent type from --agent flag (default: claude)
 const args = process.argv.slice(2)
+const SERVICE_COMMANDS = ['install', 'uninstall', 'restart', 'list', 'status']
+
+// Show top-level help
+if (args.length === 0 || args[0] === '-h' || args[0] === '--help') {
+  console.log(`cortices — AI agent dashboard CLI
+
+Usage:
+  cortices <command> [options]
+  cortices [options]                 Run agent in foreground (default: claude)
+
+Commands:
+  install    Install agent as a background service
+  uninstall  Remove agent service
+  restart    Restart agent service(s)
+  upgrade    Check for updates and upgrade all agents
+  list       List installed agent services
+  status     Show agent service status
+
+Run options:
+  --agent TYPE       Agent backend: claude (default), codex, opencode, native
+  --dir DIR          Working directory (default: current directory)
+  --name NAME        Agent name shown in dashboard
+  --api-key KEY      Cortices API key for authentication
+  --interactive      Start with interactive permission mode
+
+Examples:
+  cortices install --api-key ck_xxx --dir /path/to/project --name my-agent
+  cortices restart my-agent
+  cortices list
+  cortices --api-key ck_xxx --dir /path/to/project    # run in foreground`)
+  process.exit(0)
+}
+
+// Determine agent type from --agent flag (default: claude)
 let agentType = 'claude'
 const agentIdx = args.indexOf('--agent')
 if (agentIdx !== -1 && args[agentIdx + 1]) {