AI tools and CLI

The Mac app bundles the local runtime. You do not need an npm installation or a Terminal command to use the app.

Connect Claude Code or Codex

Open Settings > AI tools. Recon can detect the Claude Code and Codex command-line tools, the Codex app, and ChatGPT's bundled Codex. A provider API key is an optional fallback.

Choose Repair connection to register the local memory tools and install current guidance.

In-session memory tools

Supported agent sessions use three memory operations:

• recon_context: read relevant facts, prior decisions, rejected directions, and receipts before work
• recon_capture: save a durable decision, correction, rejection, lesson, or root cause when it lands
• recon_finish: close the Work session after you sign off

These are agent memory tools, not ordinary shell commands. They do not mean Recon records every message.

Optional Terminal command

Choose Install command line tool in Settings if you want to run recon from new Terminal windows. This links the signed command bundled with the app; it does not install an npm package.

Command	Use it for
recon ingest [path]	Build or refresh source memory for a project or selected path.
recon context "question"	Read relevant code facts, decisions, and receipts from Terminal.
recon check [path]	Find where agent instructions disagree with code or remembered decisions.
recon fix [path]	Prepare grounded corrections for stale agent-context files and ask before applying them.
recon hooks install	Opt in to git hooks that refresh changed files after pulls, merges, and rebases.
recon skills status	Check whether the Recon guidance is installed and current.

The app and command read the same local store. Do not run overlapping ingests.

Usage and budgets

Model-backed work uses the Claude Code, Codex, or provider account you choose. Settings > AI usage shows calls, model, timing, and reported or estimated tokens. Subscription tools do not expose a reliable dollar budget, so daily background limits use whole model calls.