@cortices/agent 0.4.23

package/README.md

@@ -0,0 +1,104 @@
+# @cortices/agent
+
+Connect your AI coding agents to [Cortices](https://cortices.io) — a real-time dashboard to monitor, chat with, and manage your agents from anywhere. Works behind NAT with no port forwarding needed.
+
+## Supported Agents
+
+| Agent | Type Flag | Requirement |
+|-------|-----------|-------------|
+| Claude Code | `--agent claude` (default) | [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) |
+| OpenAI Codex | `--agent codex` | [Codex CLI](https://github.com/openai/codex) |
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @cortices/agent
+
+# Run your agent (sign up at https://cortices.io for an API key)
+cortices --api-key ck_your_key_here --dir ~/my-project
+```
+
+Your agent appears in your [dashboard](https://cortices.io/dashboard) instantly.
+
+## Options
+
+```
+--api-key KEY     Your Cortices API key (required)
+--dir DIR         Working directory (default: current directory)
+--name NAME       Agent name shown in dashboard (default: directory name)
+--agent TYPE      Agent backend: claude (default), codex
+--interactive     Require approval for each tool call from the dashboard
+--verbose, -v     Show detailed debug logs
+```
+
+## Install as a Background Service
+
+Run your agent as a persistent service that starts on boot and auto-restarts on failure. Requires **systemd** (Linux) or **launchd** (macOS).
+
+```bash
+# Install
+cortices install --api-key ck_xxx --dir /path/to/project --name my-agent
+
+# Manage
+cortices list          # List installed agents
+cortices status NAME   # Check agent status
+cortices uninstall NAME # Remove agent
+```
+
+### Viewing Logs
+
+```bash
+# Linux
+tail -f ~/.cortices/logs/NAME.log
+
+# macOS
+tail -f ~/Library/Logs/Cortices/NAME.log
+```
+
+### No systemd/launchd?
+
+If your system doesn't support systemd or launchd (e.g. containers, WSL1), run the agent directly in a tmux or screen session:
+
+```bash
+tmux new -s my-agent
+cortices --api-key ck_xxx --dir /path/to/project --name my-agent
+# Ctrl+B, D to detach
+```
+
+Note: without a service manager, restart and upgrade commands from the dashboard will disconnect the agent and it won't auto-restart. You'll need to manually re-run it.
+
+## LLM Authentication
+
+Configure your agent's LLM credentials from the dashboard **Vault** (lock icon on the agent page).
+
+**Subscription login** — Use your existing Claude Pro/Max or ChatGPT Plus/Pro subscription. Log in on the agent machine first:
+
+```bash
+# Claude Code
+claude auth login
+
+# Codex
+codex login
+```
+
+**API key** — Paste your key in the Vault. Supported providers depend on agent type:
+
+| Agent | Providers |
+|-------|-----------|
+| Claude Code | Anthropic API, OpenRouter, AWS Bedrock, Custom |
+| Codex | OpenAI API, OpenRouter, Custom |
+
+## Permission Modes
+
+- **Auto-approve (default)** — the agent executes tools automatically; you watch from the dashboard
+- **Interactive (`--interactive`)** — every tool call requires your approval before it runs (Claude Code only)
+
+## Requirements
+
+- Node.js 18+
+- The CLI for your chosen agent type ([Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [Codex](https://github.com/openai/codex))
+
+## Learn More
+
+Visit [cortices.io](https://cortices.io) to get started.

package/bin/cortices-claude.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+import { existsSync } from 'fs'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const bytecode = resolve(__dirname, '..', 'dist', 'claude-daemon.cjs')  // bytecode loader
+const bundled = resolve(__dirname, '..', 'dist', 'claude-daemon.mjs')   // esbuild ESM
+const source = resolve(__dirname, '..', 'claude-daemon.ts')             // dev source
+
+try {
+  if (existsSync(bytecode)) {
+    execFileSync('node', [bytecode, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else if (existsSync(bundled)) {
+    execFileSync('node', [bundled, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else {
+    execFileSync('npx', ['tsx', source, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  }
+} catch (e) {
+  process.exit(e.status || 1)
+}

package/bin/cortices-codex.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+import { existsSync } from 'fs'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const bytecode = resolve(__dirname, '..', 'dist', 'codex-daemon.cjs')  // bytecode loader
+const bundled = resolve(__dirname, '..', 'dist', 'codex-daemon.mjs')   // esbuild ESM
+const source = resolve(__dirname, '..', 'codex-daemon.ts')             // dev source
+
+try {
+  if (existsSync(bytecode)) {
+    execFileSync('node', [bytecode, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else if (existsSync(bundled)) {
+    execFileSync('node', [bundled, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else {
+    execFileSync('npx', ['tsx', source, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  }
+} catch (e) {
+  process.exit(e.status || 1)
+}

package/bin/cortices-native.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+import { existsSync } from 'fs'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const bytecode = resolve(__dirname, '..', 'dist', 'cortices-daemon.cjs')
+const bundled = resolve(__dirname, '..', 'dist', 'cortices-daemon.mjs')
+const source = resolve(__dirname, '..', 'cortices-daemon.ts')
+
+try {
+  if (existsSync(bytecode)) {
+    execFileSync('node', [bytecode, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else if (existsSync(bundled)) {
+    execFileSync('node', [bundled, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else {
+    execFileSync('npx', ['tsx', source, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  }
+} catch (e) {
+  process.exit(e.status || 1)
+}

package/bin/cortices-opencode.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+import { existsSync } from 'fs'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const bytecode = resolve(__dirname, '..', 'dist', 'opencode-daemon.cjs')  // bytecode loader
+const bundled = resolve(__dirname, '..', 'dist', 'opencode-daemon.mjs')   // esbuild ESM
+const source = resolve(__dirname, '..', 'opencode-daemon.ts')             // dev source
+
+try {
+  if (existsSync(bytecode)) {
+    execFileSync('node', [bytecode, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else if (existsSync(bundled)) {
+    execFileSync('node', [bundled, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else {
+    execFileSync('npx', ['tsx', source, ...process.argv.slice(2)], {
+      stdio: 'inherit', env: process.env,
+    })
+  }
+} catch (e) {
+  process.exit(e.status || 1)
+}

package/bin/cortices.mjs

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+import { dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+import { existsSync } from 'fs'
+import { execFileSync } from 'child_process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+const args = process.argv.slice(2)
+const SERVICE_COMMANDS = ['install', 'uninstall', 'restart', 'list', 'status']
+const TOOL_COMMANDS = ['schedule', 'plan', 'memory', 'notify']
+
+// 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)
+
+Service 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
+
+Agent tools:
+  schedule   Manage scheduled tasks
+  plan       Manage long-running plans
+  memory     Manage user memories
+  notify     Send notifications to dashboard
+
+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 schedule list
+  cortices notify send --title "Build failed" --severity warning
+  cortices --api-key ck_xxx --dir /path/to/project    # run in foreground`)
+  process.exit(0)
+}
+
+// ── Agent tool subcommands ──────────────────────────────────────────────────
+if (args[0] && TOOL_COMMANDS.includes(args[0])) {
+  const tool = args[0]
+  const toolArgs = args.slice(1)
+
+  // Resolve script: prefer compiled dist, fall back to source
+  const scriptMjs = resolve(__dirname, '..', 'dist', 'scripts', `${tool}.mjs`)
+  const scriptTs = resolve(__dirname, '..', 'scripts', `${tool}.ts`)
+
+  try {
+    if (existsSync(scriptMjs)) {
+      execFileSync('node', [scriptMjs, ...toolArgs], {
+        stdio: 'inherit', env: process.env,
+      })
+    } else if (existsSync(scriptTs)) {
+      execFileSync('npx', ['tsx', scriptTs, ...toolArgs], {
+        stdio: 'inherit', env: process.env,
+      })
+    } else {
+      console.error(`Script not found for '${tool}'. Run 'npm run build' in the agent directory.`)
+      process.exit(1)
+    }
+  } catch (e) {
+    process.exit(e.status || 1)
+  }
+  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]) {
+  agentType = args[agentIdx + 1].toLowerCase()
+  args.splice(agentIdx, 2) // remove --agent and its value from args
+}
+
+const VALID_TYPES = ['claude', 'codex', 'opencode', 'native']
+if (!VALID_TYPES.includes(agentType)) {
+  console.error(`Unknown agent type: ${agentType}. Use: ${VALID_TYPES.join(', ')}`)
+  process.exit(1)
+}
+
+// 'native' type uses cortices-daemon.ts, others use <type>-daemon.ts
+const daemonName = agentType === 'native' ? 'cortices-daemon' : `${agentType}-daemon`
+const bytecode = resolve(__dirname, '..', 'dist', `${daemonName}.cjs`)
+const bundled = resolve(__dirname, '..', 'dist', `${daemonName}.mjs`)
+const source = resolve(__dirname, '..', `${daemonName}.ts`)
+
+try {
+  if (existsSync(bytecode)) {
+    execFileSync('node', [bytecode, ...args], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else if (existsSync(bundled)) {
+    execFileSync('node', [bundled, ...args], {
+      stdio: 'inherit', env: process.env,
+    })
+  } else {
+    execFileSync('npx', ['tsx', source, ...args], {
+      stdio: 'inherit', env: process.env,
+    })
+  }
+} catch (e) {
+  process.exit(e.status || 1)
+}