Portable installation

Install Capsule where Codex runs.

Capsule is a local-first Codex plugin and MCP server. The repository includes its MCP manifest, lifecycle hooks, tests, audits, and platform-neutral local state paths.

1. Clone and verify

git clone https://github.com/hakiyaka/capsule.git
cd capsule
npm test
npm run verify

Node.js 18 or newer is required. Python 3 is needed only for optional Python benchmarks.

Optional: pin a verified release

For reproducibility, use the v1.0.7 release instead of the moving main branch. Download the source archive and its SHA-256 sidecar; verify the archive before unpacking it. The project is intentionally clone/release based and is not published as the unrelated public npm package named capsule.

2. Register the local plugin

Add the repository root as a local Codex plugin. The bundled .codex-plugin/plugin.json and .mcp.json register the single capsule MCP server and lifecycle hooks. Trust the hooks when Codex asks, then restart Codex.

3. Verify the runtime

{"action":"doctor","payload":{}}

For deliberate global hook management, use npm run hooks:install, npm run hooks:status, and npm run hooks:restore. Keep the default local plugin path unless you explicitly need a global installation.

4. Measure before making claims

Run the benchmark that matches your workload. Capsule intentionally passes through explicit full-output requests, failures, unsafe syntax, and token-negative candidates. A successful installation proves availability, not a universal savings rate.

For troubleshooting, open the issue tracker with a minimal reproduction, or read SECURITY.md for private disclosures.