# actual — ask the Advisor from your terminal

> actual is a CLI that connects your terminal to the Advisor: sign in once, then ask org-scoped architecture questions and get answers grounded in your team's Architectural Decision Records (ADRs).

Install via Homebrew: `brew install actual-software/actual/actual`
Zero-install (Node required): `npx @actualai/actual <command>`

## Commands

- `actual login` — Sign in to the Actual AI platform via browser OAuth (required before `advisor`)
- `actual advisor "<question>"` — Ask an org-scoped architecture question answered from your team's ADRs
- `actual whoami` — Show the signed-in Actual AI account, organization, and granted scopes
- `actual logout` — Sign out and clear local Actual AI credentials

## Key Flags (actual login)

- `--org <ORG_ID>` — Organization to sign in to; required for accounts in more than one org
- `--no-browser` — Print the sign-in URL instead of opening a browser (useful over SSH)
- `--api-url <URL>` — Auth server base URL; falls back to ACTUAL_AUTH_URL

## Key Flags (actual advisor)

- `--org <ORG>` — Organization to scope the query to; defaults to the signed-in org
- `--repo <REPO>` — Scope the query to one connected repository (UUID); omitted, the query runs at org level
- `--api-url <URL>` — Advisor API base URL; falls back to ACTUAL_API_URL, else the production api-service

## Docs

- [Getting Started & Command Reference](https://actual.ai/cli/docs.md): Install, browser sign-in, and the advisor command reference with flags

## Optional

- [Product overview](https://actual.ai/cli/index.md): Homepage — tagline, install instructions, how it works
- [actual.ai](https://actual.ai/): Main product site with pricing, about, blog, and agent documentation