capyai 0.2.0

package/README.md

@@ -0,0 +1,79 @@
+# capy-cli
+
+Agent orchestrator with quality gates for [Capy.ai](https://capy.ai). Zero dependencies.
+
+Works with Claude Code, Codex, OpenClaw, or any AI agent that can run shell commands.
+
+## Install
+
+```bash
+npm i -g capy-cli
+capy init
+```
+
+Or set env vars directly:
+
+```bash
+export CAPY_API_KEY=capy_...
+export CAPY_PROJECT_ID=...
+```
+
+## Usage
+
+```bash
+# Start work
+capy captain "Implement feature X. Files: src/foo.ts. Tests required."
+capy build "Fix typo in README"
+
+# Monitor
+capy status
+capy watch <thread-id>
+
+# Review + approve
+capy review <task-id>
+capy approve <task-id>
+capy retry <task-id> --fix="fix the failing test"
+```
+
+Every command supports `--json` for machine-readable output.
+
+## Quality Gates
+
+`capy review` checks pass/fail gates:
+
+| Gate | What it checks |
+|------|---------------|
+| `pr_exists` | PR was created |
+| `pr_open` | PR is open or merged |
+| `ci` | CI checks passing |
+| `greptile` | No unaddressed Greptile issues |
+| `greptile_check` | Greptile GitHub status check |
+| `threads` | No unresolved review threads |
+| `tests` | Diff includes test files |
+
+Configure which gates run via `capy config quality.reviewProvider greptile|capy|both|none`.
+
+## For Agents
+
+```bash
+capy review TASK-1 --json   # parse quality.pass boolean
+capy status --json           # full state dump
+```
+
+## Config
+
+```bash
+capy config defaultModel gpt-5.4
+capy config quality.reviewProvider both
+capy config notifyCommand "notify-send {text}"
+```
+
+Env vars: `CAPY_API_KEY`, `CAPY_PROJECT_ID`, `CAPY_SERVER`, `CAPY_ENV_FILE`, `GREPTILE_API_KEY`.
+
+## Requirements
+
+Node.js 18+ or Bun. GitHub CLI (`gh`) for quality gate checks.
+
+## License
+
+MIT

package/bin/capy.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+
+const cmd = process.argv[2];
+
+if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+  const { version } = require("../package.json");
+  console.log(`capy — agent orchestrator with quality gates
+
+Usage: capy <command> [args] [flags]
+
+Agents:
+  captain <prompt>         Start Captain thread
+  build <prompt>           Start Build agent
+  threads [list|get|msg|stop|messages]
+
+Tasks:
+  status                   Dashboard
+  list [status]            List tasks
+  get <id>                 Task details
+  start/stop/msg <id>      Control tasks
+  diff <id>                View diff
+  pr <id> [title]          Create PR
+
+Quality:
+  review <id>              Gate check
+  re-review <id>           Trigger Greptile re-review
+  approve <id> [--force]   Approve if gates pass
+  retry <id> [--fix="..."] Retry with context
+
+Monitoring:
+  watch/unwatch <id>       Auto-poll + notify
+  watches                  List watches
+
+Config:
+  init                     Interactive setup
+  config [key] [value]     Get/set config
+  models                   List models
+  tools                    All commands + env vars
+
+Flags:
+  --json  --model=<id>  --opus  --sonnet  --fast
+
+v${version}
+`);
+  process.exit(0);
+}
+
+try {
+  const { run } = await import("../dist/capy.js");
+  await run(cmd, process.argv.slice(3));
+} catch (e) {
+  if (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "MODULE_NOT_FOUND") {
+    console.error("capy: not built. Run: bun run build");
+    process.exit(1);
+  }
+  console.error(e.message);
+  process.exit(1);
+}

package/bin/capy.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env bun
+
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+
+const cmd = process.argv[2];
+
+if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+  console.log(`capy — agent orchestrator with quality gates
+
+Usage: capy <command> [args] [flags]
+
+Agents:
+  captain <prompt>         Start Captain thread
+  build <prompt>           Start Build agent
+  threads [list|get|msg|stop|messages]
+
+Tasks:
+  status                   Dashboard
+  list [status]            List tasks
+  get <id>                 Task details
+  start/stop/msg <id>      Control tasks
+  diff <id>                View diff
+  pr <id> [title]          Create PR
+
+Quality:
+  review <id>              Gate check
+  re-review <id>           Trigger Greptile re-review
+  approve <id> [--force]   Approve if gates pass
+  retry <id> [--fix="..."] Retry with context
+
+Monitoring:
+  watch/unwatch <id>       Auto-poll + notify
+  watches                  List watches
+
+Config:
+  init                     Interactive setup
+  config [key] [value]     Get/set config
+  models                   List models
+  tools                    All commands + env vars
+
+Flags:
+  --json  --model=<id>  --opus  --sonnet  --fast
+
+v${version}
+`);
+  process.exit(0);
+}
+
+try {
+  const { run } = await import("../src/cli.js");
+  await run(cmd, process.argv.slice(3));
+} catch (e: unknown) {
+  const err = e as Error & { code?: string };
+  if (err.code === "MODULE_NOT_FOUND" || err.code === "ERR_MODULE_NOT_FOUND") {
+    console.error("capy: broken install. Reinstall: npm i -g capy-cli");
+    process.exit(1);
+  }
+  console.error(err.message);
+  process.exit(1);
+}