A
actual-software/actual-cli
Architecture questions, answered from your ADRs
View on GitHub ↗Link checked 2026-11-12 · automated check blocked (HTTP 429), status unconfirmed
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"actual-software-actual-cli": {
"command": "npx",
"args": ["@actualai/actual"]
}
}
}Parsed from the README we fetched on 2026-11-06; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"actual-software-actual-cli": {
"command": "npx",
"args": ["@actualai/actual"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio actual-software-actual-cli -- npx @actualai/actual
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 8 ★ · actual-software/actual-cli · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-07 · last seen 2026-11-14 · seen 8× · listed by 1 sources
- Score
- score 103 · 8 ★ · 1 sources · repo
- Install
npx @actualai/actual
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @actualai/actual. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
actual-software/actual-cli；first catalogued 2026-11-07；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.Actual.ai CLI
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Architecture questions, answered from your ADRs.
Use it through the Actual.ai Skill , which wraps the Actual.ai CLI for your coding agent.
## Quickstart
### Install Actual.ai Skill — Claude Code CLI
Start with the Actual.ai Skill. The skill wraps the Actual.ai CLI so your coding agent can use it, and installs the CLI for you on first run. Run each step as its own copy/paste.
Step 1 — add the actual-skill repo as a marketplace:
/plugin marketplace add actual-software/actual-skill
Step 2 — install the plugin:
/plugin install actual-cli@actual-cli-skills
Step 3 — reload plugins so Claude Code CLI loads the newly installed plugin:
/reload-plugins
Step 4 — run the skill in your coding agent:
/actual
The first time you run it, the skill asks for your permission to install the Actual.ai CLI for you. For example:
/actual
The actual CLI is not installed. Should I install it with:
npm install -g @actualai/actual
Then I'll verify it with actual --version.
Manual install Actual.ai CLI — npm / npx
The skill installs the CLI for you, so you only need a manual install for scripts and CI or to run the CLI outside an agent.
Step 1 — install the CLI globally:
npm install -g @actualai/actual
Or skip the install and run any command with npx @actualai/actual .
Step 2 — sign in with browser OAuth:
actual login
Step 3 — ask your first architecture question:
actual advisor "Should new services talk over gRPC or REST?"
Install Actual.ai CLI — Homebrew
bash
brew install actual-software/actual/actual
Install Actual.ai CLI — Manual download / Build from source
Each release in the releases repository (binaries are published separately from source) has one archive per platform: actual-darwin-arm64.tar.gz, actual-darwin-x64.tar.gz, actual-linux-arm64.tar.gz, and actual-linux-x64.tar.gz. Each holds a single actual binary. Download the one for your platform, extract it, move the binary onto your PATH, and run it. On Apple Silicon:
bash
curl -fsSLO https://github.com/actual-software/actual-releases/releases/latest/download/actual-darwin-arm64.tar.gz
tar -xzf actual-darwin-arm64.tar.gz
sudo mv ./actual /usr/local/bin/actual
# macOS, if you downloaded the archive in a browser: remove quarantine before running
xattr -dr com.apple.quarantine /usr/local/bin/actual
actual --version
actual self-update upgrades a binary installed this way after checking the new release's signature, but only in a directory you can write without sudo. To use it, put actual somewhere you own, such as ~/.local/bin, instead of /usr/local/bin. See docs/SELFUPDATE.md.
To build from source you need a C compiler for the tree-sitter native dependencies:
bash
# macOS: Xcode command-line tools (usually already installed)
xcode-select --install
# Debian/Ubuntu
sudo apt-get install build-essential
cargo install --git https://github.com/actual-software/actual-cli.git actual-cli
Check a downloaded release
From v0.12.0, the release workflow publishes SHA256SUMS, which lists every archive, on both the source release page and the releases mirror. A signer adds SHA256SUMS.minisig, a minisign signature over that list, by hand after publication. A new release can remain unsigned until that step finishes; if the signature is missing, try again later. Releases through v0.11.0 carry neither file. For a signed release, check the signature first:
Use it through the Actual.ai Skill , which wraps the Actual.ai CLI for your coding agent.
## Quickstart
### Install Actual.ai Skill — Claude Code CLI
Start with the Actual.ai Skill. The skill wraps the Actual.ai CLI so your coding agent can use it, and installs the CLI for you on first run. Run each step as its own copy/paste.
Step 1 — add the actual-skill repo as a marketplace:
/plugin marketplace add actual-software/actual-skill
Step 2 — install the plugin:
/plugin install actual-cli@actual-cli-skills
Step 3 — reload plugins so Claude Code CLI loads the newly installed plugin:
/reload-plugins
Step 4 — run the skill in your coding agent:
/actual
The first time you run it, the skill asks for your permission to install the Actual.ai CLI for you. For example:
/actual
The actual CLI is not installed. Should I install it with:
npm install -g @actualai/actual
Then I'll verify it with actual --version.
Manual install Actual.ai CLI — npm / npx
The skill installs the CLI for you, so you only need a manual install for scripts and CI or to run the CLI outside an agent.
Step 1 — install the CLI globally:
npm install -g @actualai/actual
Or skip the install and run any command with npx @actualai/actual .
Step 2 — sign in with browser OAuth:
actual login
Step 3 — ask your first architecture question:
actual advisor "Should new services talk over gRPC or REST?"
Install Actual.ai CLI — Homebrew
bash
brew install actual-software/actual/actual
Install Actual.ai CLI — Manual download / Build from source
Each release in the releases repository (binaries are published separately from source) has one archive per platform: actual-darwin-arm64.tar.gz, actual-darwin-x64.tar.gz, actual-linux-arm64.tar.gz, and actual-linux-x64.tar.gz. Each holds a single actual binary. Download the one for your platform, extract it, move the binary onto your PATH, and run it. On Apple Silicon:
bash
curl -fsSLO https://github.com/actual-software/actual-releases/releases/latest/download/actual-darwin-arm64.tar.gz
tar -xzf actual-darwin-arm64.tar.gz
sudo mv ./actual /usr/local/bin/actual
# macOS, if you downloaded the archive in a browser: remove quarantine before running
xattr -dr com.apple.quarantine /usr/local/bin/actual
actual --version
actual self-update upgrades a binary installed this way after checking the new release's signature, but only in a directory you can write without sudo. To use it, put actual somewhere you own, such as ~/.local/bin, instead of /usr/local/bin. See docs/SELFUPDATE.md.
To build from source you need a C compiler for the tree-sitter native dependencies:
bash
# macOS: Xcode command-line tools (usually already installed)
xcode-select --install
# Debian/Ubuntu
sudo apt-get install build-essential
cargo install --git https://github.com/actual-software/actual-cli.git actual-cli
Check a downloaded release
From v0.12.0, the release workflow publishes SHA256SUMS, which lists every archive, on both the source release page and the releases mirror. A signer adds SHA256SUMS.minisig, a minisign signature over that list, by hand after publication. A new release can remain unsigned until that step finishes; if the signature is missing, try again later. Releases through v0.11.0 carry neither file. For a signed release, check the signature first:
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/actual-software-actual-cli/)
- Source
- github · https://github.com/actual-software/actual-cli
- Browse by field
- Open source
- Traction
- 8 ★
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.