$ actual adr-botAI context for your
codebase. Always current.
actual analyzes your repo, matches it against your team's Architectural Decisions, and writes them into AI context files — keeping every coding agent aligned, automatically.
How it works
Three steps to
architecturally aligned agents
Codebase Analysis
Understand your repo instantly
actual inspects your languages, frameworks, and existing conventions to build a precise taxonomy — no manual config required.
Context File Management
Context files that stay in sync
Architectural Decisions are fetched, tailored to your codebase, and written into CLAUDE.md, AGENTS.md, or Cursor rules — updated on every sync.
Architectural Guardrails
Keep every agent on the same page
Your team's decisions become hard constraints for AI agents. No more architectural drift, no more inconsistent patterns across PRs.
Installation
Up and running in
one command
Homebrew
macOS & Linux
brew install actual-software/actual/actualInstalls the native binary. Run actual adr-bot from any repo.
macOS Gatekeeper
The binary isn't codesigned yet — our Apple Developer Program application is pending. On first run, macOS will block it. Remove the quarantine flag once after install:
xattr -dr com.apple.quarantine $(which actual)npx
Zero install
npx actual adr-botNo install needed. Works anywhere Node is available — great for CI and quick tries.
Then run
actual auth # verify your Claude Code auth
actual adr-bot # analyze, fetch ADRs, write CLAUDE.md