$ 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.

actual advisor

How it works

Three steps to

grounded architecture answers

Sign in once

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

Up and running in

one command

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.
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.