{"_id":"@ai-agencee/cli","_rev":"3-4c7fb8eb96f25bbb8d52a06e92f83fc2","name":"@ai-agencee/cli","dist-tags":{"latest":"1.4.5"},"versions":{"1.4.1":{"name":"@ai-agencee/cli","version":"1.4.1","_id":"@ai-agencee/cli@1.4.1","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"bin":{"ai-kit":"dist/bin/ai-kit.js"},"dist":{"shasum":"774c37db259418de2cdb618886bd08a8ee8812ad","tarball":"https://registry.npmjs.org/@ai-agencee/cli/-/cli-1.4.1.tgz","fileCount":62,"integrity":"sha512-8yDKroqL9pPaev/QzjHDot5DCutfOpvBunA6jVJ6PPdaTgxr+TLxzzuR/7ovMmWFXfarwGBxqrscFzXh8dLv3g==","signatures":[{"sig":"MEUCIQDV1qZkOJsXJ/PAeiEmLleApMGY/CpBacCjDTntq+XFoQIgQ4t9kgp4pz9pFY2vOr4iBFokVjiivIOYMwnUsxZYbys=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":127327},"main":"./dist/src/index.js","type":"commonjs","_from":"file:ai-agencee-cli-1.4.1.tgz","types":"./dist/src/index.d.ts","scripts":{"lint":"tsc --noEmit","test":"jest","build":"tsc"},"_npmUser":{"name":"formular.dev","email":"pianatadeo@hotmail.com"},"_resolved":"/tmp/8844e5ab34cba338d16f8a19526fe204/ai-agencee-cli-1.4.1.tgz","_integrity":"sha512-8yDKroqL9pPaev/QzjHDot5DCutfOpvBunA6jVJ6PPdaTgxr+TLxzzuR/7ovMmWFXfarwGBxqrscFzXh8dLv3g==","_npmVersion":"10.8.2","description":"CLI for AI Agencee","directories":{},"_nodeVersion":"20.20.0","dependencies":{"commander":"^14.0.3","@ai-agencee/mcp":"^1.3.0","@ai-agencee/core":"^1.1.0","@ai-agencee/engine":"^1.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.2.0","ts-jest":"^29.1.5","typescript":"^5.4.5","@types/jest":"^30.0.0","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/cli_1.4.1_1772914852431_0.9046066422749939","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is legacy and no longer maintained."},"1.4.5":{"name":"@ai-agencee/cli","version":"1.4.5","_id":"@ai-agencee/cli@1.4.5","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"bin":{"ai-kit":"dist/bin/ai-kit.js"},"dist":{"shasum":"5290e6e2a853c94511ecfcb6a5d0e7b644f11139","tarball":"https://registry.npmjs.org/@ai-agencee/cli/-/cli-1.4.5.tgz","fileCount":466,"integrity":"sha512-87zExgEdJ8gA+cnmCYvOD5m0A/v66WvREUjcngXFrNGLQQaDQvViXvLx6eYuiEwwH4gOyQn1fLEFJGliA5p0eQ==","signatures":[{"sig":"MEYCIQC5XkEWjJIW42mai3daaE+67kejuUT9ER3vUpQHqwpa2wIhAJdsgME4mzTokiFRmFXnCufXYRbxidymVV+etam5LOBq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":796321},"main":"./dist/src/index.js","type":"commonjs","types":"./dist/src/index.d.ts","gitHead":"057758a6bf88ee28e086d4976f26e2d4ecfbe7b0","scripts":{"lint":"tsc --noEmit","test":"jest","build":"tsc","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"formular.dev","email":"pianatadeo@hotmail.com"},"_npmVersion":"10.9.0","description":"CLI for AI Agencee","directories":{},"_nodeVersion":"24.12.0","dependencies":{"ink":"^6.8.0","ora":"^9.4.0","chalk":"^5.6.2","react":"^19.2.6","prompts":"^2.4.2","chokidar":"^4.0.3","commander":"^14.0.3","cosmiconfig":"^9.0.1","@ai-agencee/mcp":"workspace:^","@ai-agencee/core":"workspace:^","@ai-agencee/engine":"workspace:^","@ai-agencee/connectors":"workspace:^"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.3.0","ts-jest":"^29.4.9","typescript":"^5.9.3","@types/jest":"^30.0.0","@types/node":"^25.6.0","@types/react":"^19.2.14","@types/prompts":"^2.4.9"},"_npmOperationalInternal":{"tmp":"tmp/cli_1.4.5_1778145968753_0.3289037294413246","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is legacy and no longer maintained."}},"time":{"created":"2026-03-07T20:20:52.255Z","modified":"2026-07-01T08:49:58.293Z","1.4.1":"2026-03-07T20:20:52.620Z","1.4.5":"2026-05-07T09:26:09.033Z"},"description":"CLI for AI Agencee","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"readme":"# @ai-agencee/cli\r\n\r\n[![npm](https://img.shields.io/npm/v/@ai-agencee/cli)](https://www.npmjs.com/package/@ai-agencee/cli)\r\n[![license](https://img.shields.io/npm/l/@ai-agencee/cli)](https://github.com/binaryjack/ai-agencee/blob/main/LICENSE)\r\n\r\nCLI tool for the **AI Agencee** toolkit. Scaffold AI rule files, validate projects, run multi-lane DAG agent workflows, launch the MCP server, plan features interactively, and benchmark LLM providers — all from a single `ai-kit` command.\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install -g @ai-agencee/cli\r\n# or run without installing:\r\nnpx @ai-agencee/cli <command>\r\n```\r\n\r\n> **Node ≥ 20** required. CommonJS module.\r\n\r\n---\r\n\r\n## Commands\r\n\r\n### `ai-kit init`\r\n\r\nScaffold AI rule files into the current project from the bundled template.\r\n\r\n```bash\r\nai-kit init\r\nai-kit init --strict   # Enable ULTRA_HIGH strict standards (OWNER rules)\r\n```\r\n\r\nCreates the following structure (prompts before overwriting existing files):\r\n\r\n```\r\n.github/\r\n├── copilot-instructions.md\r\n└── ai/\r\n    ├── manifest.xml\r\n    ├── pipeline.xml\r\n    ├── architecture-rules.xml\r\n    └── quality-gates.xml\r\nsrc/.ai/\r\n├── bootstrap.md\r\n├── rules.md\r\n└── patterns.md\r\n```\r\n\r\n---\r\n\r\n### `ai-kit sync`\r\n\r\nSync AI rule files with the latest template version. Overwrites files that have diverged from the template; leaves customised files that are already up to date.\r\n\r\n```bash\r\nai-kit sync\r\n```\r\n\r\nOutput:\r\n```\r\nok:       .github/copilot-instructions.md\r\nsynced:   .github/ai/quality-gates.xml\r\ndiverged: src/.ai/rules.md\r\n```\r\n\r\n| Status | Meaning |\r\n|--------|---------|\r\n| `ok` | Matches template — no change |\r\n| `synced` | Was missing — created |\r\n| `diverged` | Differed from template — updated |\r\n\r\n---\r\n\r\n### `ai-kit check`\r\n\r\nValidate project structure against ULTRA_HIGH rules. Exits with code `1` if any rule fails.\r\n\r\n```bash\r\nai-kit check\r\n```\r\n\r\nChecks performed:\r\n- Every file in `REQUIRED_FILES` exists\r\n- All source file names are `kebab-case`\r\n- No forbidden patterns (`class `, ` any `, `useImperativeHandle`) in `.ts`/`.js` files\r\n\r\n```\r\npass: required-file:.github/copilot-instructions.md\r\npass: naming:kebab-case\r\nfail: forbidden-pattern: class  — found in src/components/MyComponent.tsx\r\n```\r\n\r\n---\r\n\r\n### `ai-kit agent:dag [dag-file]`\r\n\r\nRun a multi-lane supervised DAG execution. Defaults to `agents/dag.json` in the current directory.\r\n\r\n```bash\r\nai-kit agent:dag\r\nai-kit agent:dag agents/my-workflow.json\r\nai-kit agent:dag --dry-run                     # Validate config, print execution plan\r\nai-kit agent:dag --verbose                     # Per-checkpoint output\r\nai-kit agent:dag --interactive                 # Pause at human-review checkpoints\r\nai-kit agent:dag --budget 0.50                 # Abort if spend exceeds $0.50\r\nai-kit agent:dag --provider openai             # Force a specific LLM provider\r\nai-kit agent:dag -p /path/to/project           # Specify project root\r\n```\r\n\r\n#### Options\r\n\r\n| Flag | Description |\r\n|------|-------------|\r\n| `[dag-file]` | Path to `dag.json` (default: `agents/dag.json`) |\r\n| `-p, --project <path>` | Project root directory (default: cwd) |\r\n| `-v, --verbose` | Detailed per-checkpoint output |\r\n| `--dry-run` | Validate DAG and print execution plan — no LLM calls |\r\n| `-i, --interactive` | Pause at `needs-human-review` checkpoints |\r\n| `--budget <usd>` | USD spend cap — aborts when exceeded |\r\n| `--provider <name>` | Force provider: `anthropic \\| openai \\| vscode \\| mock` |\r\n\r\n#### Provider setup\r\n\r\n| Provider | Requirement |\r\n|----------|-------------|\r\n| `anthropic` | `ANTHROPIC_API_KEY` env var |\r\n| `openai` | `OPENAI_API_KEY` env var |\r\n| `vscode` | Running inside VS Code with Copilot (no key needed) |\r\n| `mock` | No LLM calls — useful for CI and testing |\r\n\r\n---\r\n\r\n### `ai-kit agent:plan`\r\n\r\nRun the interactive 5-phase planning system. Guides a BA agent through discovery, synthesis, decomposition, dependency wiring, and execution.\r\n\r\n```bash\r\nai-kit agent:plan\r\nai-kit agent:plan --start-from decompose       # Resume from a specific phase\r\nai-kit agent:plan --provider vscode            # Use VS Code Copilot — no API key\r\nai-kit agent:plan --skip-approval              # Non-interactive / CI mode\r\nai-kit agent:plan --verbose\r\nai-kit agent:plan --model-router-config agents/model-router.json\r\n```\r\n\r\n#### Phases\r\n\r\n| Phase | What happens |\r\n|-------|-------------|\r\n| `discover` | BA ↔ User structured interview |\r\n| `synthesize` | BA produces plan skeleton; user approves |\r\n| `decompose` | Each specialist agent fills in tasks (parallel) |\r\n| `wire` | Dependency graph and alignment gates resolved |\r\n| `execute` | PlanOrchestrator runs the wired plan via DAG engine |\r\n\r\n#### Options\r\n\r\n| Flag | Description |\r\n|------|-------------|\r\n| `-p, --project <path>` | Project root (default: cwd) |\r\n| `-a, --agents-dir <path>` | Directory containing agent/supervisor JSON (default: `<project>/agents`) |\r\n| `--start-from <phase>` | Resume: `discover \\| synthesize \\| decompose \\| wire \\| execute` |\r\n| `--skip-approval` | Skip user approval gates |\r\n| `-v, --verbose` | Verbose DAG output during execution phase |\r\n| `--provider <name>` | LLM provider: `anthropic \\| openai \\| vscode` (auto-detects from env) |\r\n| `--model-router-config <path>` | Path to custom `model-router.json` |\r\n\r\n---\r\n\r\n### `ai-kit agent:benchmark`\r\n\r\nBenchmark registered LLM providers — measures latency, throughput, and cost per request.\r\n\r\n```bash\r\nai-kit agent:benchmark\r\nai-kit agent:benchmark --providers anthropic,openai\r\nai-kit agent:benchmark --suite code-review --runs 3\r\nai-kit agent:benchmark --output results.json\r\n```\r\n\r\n#### Options\r\n\r\n| Flag | Description |\r\n|------|-------------|\r\n| `--providers <names>` | Comma-separated providers to test (default: all registered) |\r\n| `--suite <name>` | Prompt suite: `minimal \\| code-review` (default: `minimal`) |\r\n| `--runs <n>` | Repetitions per prompt (default: `1`) |\r\n| `--router-file <path>` | Path to `model-router.json` (default: `agents/model-router.json`) |\r\n| `-p, --project <path>` | Project root |\r\n| `--output <file>` | Write JSON report to this file |\r\n\r\n---\r\n\r\n### `ai-kit visualize`\r\n\r\nGenerate a visual summary of the DAG definition — lanes, dependencies, barriers, and supervisor assignments.\r\n\r\n```bash\r\nai-kit visualize\r\nai-kit visualize agents/my-workflow.json\r\nai-kit visualize --format mermaid    # Output as Mermaid diagram\r\nai-kit visualize --output graph.md\r\n```\r\n\r\n---\r\n\r\n### `ai-kit mcp`\r\n\r\nStart the MCP server (delegates to [`@ai-agencee/mcp`](https://www.npmjs.com/package/@ai-agencee/mcp)) and print VS Code / Claude Desktop configuration snippets.\r\n\r\n```bash\r\nai-kit mcp\r\n```\r\n\r\n---\r\n\r\n### `ai-kit data`\r\n\r\nManage persistent run data and tenant registry.\r\n\r\n```bash\r\nai-kit data tenants                 # List all registered tenants\r\nai-kit data export --tenant <id>    # Export run data for a tenant\r\nai-kit data delete --tenant <id>    # Delete all run data for a tenant\r\n```\r\n\r\n---\r\n\r\n## Example: full workflow from scratch\r\n\r\n```bash\r\n# 1. Scaffold AI rules into your project\r\ncd my-project\r\nai-kit init --strict\r\n\r\n# 2. Validate everything is in order\r\nai-kit check\r\n\r\n# 3. Dry-run to inspect the DAG before spending tokens\r\nai-kit agent:dag --dry-run\r\n\r\n# 4. Run with VS Code Copilot — no API keys\r\nai-kit agent:dag --provider vscode --verbose\r\n\r\n# 5. Interactive planning session\r\nai-kit agent:plan --provider vscode\r\n```\r\n\r\n---\r\n\r\n## Related Packages\r\n\r\n| Package | Description |\r\n|---------|-------------|\r\n| [`@ai-agencee/core`](https://www.npmjs.com/package/@ai-agencee/core) | File system utilities and project validation |\r\n| [`@ai-agencee/engine`](https://www.npmjs.com/package/@ai-agencee/engine) | Multi-lane supervised DAG execution engine |\r\n| [`@ai-agencee/mcp`](https://www.npmjs.com/package/@ai-agencee/mcp) | MCP server for AI assistant integration |\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — see [LICENSE](https://github.com/binaryjack/ai-agencee/blob/main/LICENSE)\r\n","readmeFilename":"README.md"}