![\"Discord\"](\"https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white\"){kind=icon}
\n ![\"npm\"](\"https://img.shields.io/npm/v/@hoilab/ada-cli?style=flat-square\")
\n\n
\n █████╗ ██████╗ █████╗\n ██╔══██╗██╔══██╗██╔══██╗\n ███████║██║ ██║███████║\n ██╔══██║██║ ██║██╔══██║\n ██║ ██║██████╔╝██║ ██║\n ╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝\n\n\n\n
\n
🇬🇧 English · 🇪🇸 Español
\n\n> Ada CLI is HOILAB's fork of [pi.dev](https://pi.dev) (`earendil-works/pi`): the `pi` binary becomes `ada-cli`, config moves to `~/.ada/`, and the fork auto-syncs with upstream daily so security fixes and new models land immediately. See [ADA-CLI.md](../../ADA-CLI.md) for the full sync mechanics. New issues and PRs from new contributors are auto-closed by default — see [CONTRIBUTING.md](../../CONTRIBUTING.md).\n\n---\n\nAda CLI is a coding agent built on pi.dev's proven minimal terminal core, with an **Ada Intelligence Engine** layered on top: autonomous goal pursuit with a mandatory evidence-backed judge, sandboxed parallel workflows, a traceability graph that gates \"done\" on observed evidence, durable cross-session memory with a tamper-evident audit log and PII scanning, encrypted secrets, and a native desktop app — all wired to the same `settings.json` your terminal already uses.\n\nWhere most coding agents ask you to trust a single long-running chat, Ada is built to be **auditable**: every autonomous action either has cited evidence behind it or it doesn't happen.\n\n- **Everything is optional and inspectable.** The core stays as minimal as pi.dev's — four tools (`read`, `write`, `edit`, `bash`) by default. Autonomy, memory, and orchestration are opt-in layers you can turn off in `settings.json`.\n- **Autonomy requires a signed-off contract.** The [Goal Engine](#ada-intelligence-engine) won't touch a codebase until you `/goal approve` its plan, runs fixed TDD phases, and never marks work `done` without a judge citing evidence for it.\n- **Nothing is \"done\" on the model's word alone.** The [Work Graph](#ada-intelligence-engine) gates completion on observed evidence — a passing test, a real diff, a verified command — not a claim in the transcript.\n- **Memory is compliance-ready by default.** The [Memory Engine](#ada-intelligence-engine) blocks PII before it's ever written to disk and keeps a hash-chained audit log of every write and rejection.\n- **Secrets stay off disk, and out of reach of the agent.** The built-in [Vault](#ada-intelligence-engine) is a local encrypted store shared across the CLI, desktop app, and subagents of an unlocked session. Provider credentials and MCP tokens never enter the model's context. An explicit `@vault:NAME` reference *does* expand into the prompt — that is its purpose, so the model can use the secret in a command — but the expansion is redacted in everything persisted and displayed. The agent cannot read the vault: `core/aprobacion/politica.ts` denies it permanently, and that denial survives `yolo`.\n- **Teams get a GUI, not just a terminal.** The [Ada Desktop](../../desktop/) app (Tauri + Next.js) reads the exact same SDK and config as the CLI — no parallel product to maintain.\n- **Extensible instead of opinionated.** No baked-in MCP, sub-agent framework, or permission popups — build exactly the workflow you need with [extensions](docs/extensions.md), [skills](docs/skills.md), or third-party [Ada packages](docs/packages.md). See [Philosophy](#philosophy).\n\n## Getting Started\n\n```bash\nnpm install -g --ignore-scripts @hoilab/ada-cli\n```\n\n```bash\nexport ANTHROPIC_API_KEY=sk-ant-...\nada-cli\n```\n\nOr authenticate with an existing subscription: run `ada-cli`, then `/login`. First run in a new project asks you to trust the folder — see [Project Trust](docs/security.md).\n\nCompliance controls in detail — ledger, retention purge, machine policy,\nart. 9 detection, OTLP and SBOM — with what each one proves and what it does\nnot: [Compliance](docs/compliance.md).\n\nFull walkthrough: [Quickstart](docs/quickstart.md) · [Providers & models](docs/providers.md) · [Windows](docs/windows.md) · [Termux](docs/termux.md) · [tmux](docs/tmux.md)\n\n### One limitation of the published package\n\n`ada-cli session![\"Exy](\"docs/images/exy.png\")