Skip to main content
audacity is a local, Claude-Code-style coding agent for your terminal whose brain is your AI Reserve API key — it talks only to the AI Reserve gateway, never to an external Claude or OpenAI endpoint. The model can read files, search, edit, and run commands in your working directory, with explicit approval required for anything that mutates state.
On first run it prompts for your aireserve_api_… key and a model, then saves them to ~/.audacity/config.json (mode 600) — enter the key once and it is remembered across every shell and session on the machine.

Session commands

Permissions model

Read-only tools (read_file, list_files, grep) run without prompting. Mutating tools (edit_file, write_file, run_bash) show you exactly what will run and ask for approval first — bypass with --yes/-y or the /auto toggle. In one-shot mode, mutating tools always require -y.
Because the CLI resends the full conversation each turn, long working sessions naturally benefit from provider-side prompt caching — repeated context is billed at cached-input rates on supported models, and cached token counts are metered per request in your usage reporting.