Acolyte

A terminal-first AI coding agent. Open-source, observable, and built for developer control.

A lifecycle-driven agent with strong defaults, behavioral guards, and transparent execution. Every decision visible, every behavior overridable.

Quick start

bun install
bun run start init   # prompts for provider API key, writes .env
bun run dev           # starts server + CLI client

See all commands: bun run start help

Validate

bun run verify        # lint + typecheck + all tests
bun test              # all tests
bun run test:unit     # unit tests only
bun run test:int      # integration tests
bun run test:tui      # visual regression tests
bun run test:perf     # performance baselines

Documentation

• Index
• Why Acolyte
• Contributing
• Benchmarks
• Agent policy

License

MIT