$ actual advisor

Architecture questions,
answered from your ADRs.

The Advisor answers org-scoped architecture questions from your team's Architectural Decision Records (ADRs) — right in the terminal, each answer citing the decisions it drew on.

Install Now

actual-software/actual-cli

actual advisor

How it works

Three steps to

grounded architecture answers

Browser OAuth in seconds

actual login establishes your Actual AI platform identity. Credentials are stored locally and tokens are never printed.

Ask in plain language

Org-scoped architecture answers

actual advisor "<question>" queries your organization's ADRs and returns an answer scoped to your team. No context files to manage.

Grounded in your ADRs

Every answer cites its sources

The Advisor lists the Architectural Decision Records it drew on, each with a confidence score, so you can trace any answer back to the decision behind it.

Installation

Install automatically with the

Actual skill

Claude Code

Recommended

Install the Actual Skill

Claude Code checks your plans and code changes against your repository's decisions.

1. Install the skill
Run these in a Claude Code session, one at a time.
/plugin marketplace add actual-software/actual-skill
/plugin install actual-cli@actual-cli-skills
2. Reload plugins
Run this in the same Claude Code session so it picks up the new skill.
/reload-plugins
3. Install the CLI
The first time the skill runs, it will help you install the Actual CLI.
4. Plan a change
Ask Claude Code to plan or implement a feature. It flags anything that conflicts with a decision.

Or install directly

Homebrew

macOS & Linux

brew install actual-software/actual/actual

Installs the native binary. Sign in with actual login, then ask the Advisor.

npx

Zero install

npx @actualai/actual login

No install needed. Works anywhere Node is available — great for CI and quick tries.

Clawhub

OpenClaw

clawhub install actual

Installs the skill, which installs the binary automatically and teaches your coding agent to run the actual CLI.

Frequently asked questions

The CLI brings your team's architecture knowledge to the terminal. Sign in, then ask the Advisor an architecture question and it answers from your organization's Architecture Decision Records, citing the records it drew on, each with a confidence score.

Install it with Homebrew (brew install actual-software/actual/actual) or run it directly with npx. Sign in once with actual login, then ask questions with actual advisor "<question>" from anywhere.

Upgrade each the way you installed it. For the CLI, run brew upgrade actual-software/actual/actual or npm install -g @actualai/actual@latest. For the skill, run claude plugin marketplace update actual-cli-skills, then claude plugin update actual-cli@actual-cli-skills, and start a new Claude Code session. Your sign-in and rules are kept.Read the upgrade guide →

Every answer is grounded in your team's Architecture Decision Records. The Advisor retrieves the ADRs relevant to your question and cites them, so you can trace any answer back to the decision behind it.

Architecture questions, answered from your ADRs.