All shelves / Mods / Workflow
actual-cli
By actual-software
actual-cli is a Claude Code workflow mod by actual-software.
For Actual AI, which keeps agents on a team's architecture decisions, draws a row of how many ADRs reached context and adds a file's rules beside each read.
Draws
Install
The marketplace name is actual-cli-skills.
/plugin marketplace add actual-software/actual-skill /plugin install actual-cli@actual-cli-skills
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 1.4.1
- License
- Apache-2.0
- Repo stars
- 5
- Last change
- 2026-10-16
What it can reach
- Draws in the session
- Reaches the network or an outside service
- Sees tool calls
- Calls another program on this machine
The row reads Actual AI: 3 of 12 ADRs added to context, shows 0 of N from the start, and updates after each reply in the background, so no reply waits on it. After /clear it counts the new session. It steps aside while a survey is showing, and [-] collapses the band. It shows nothing outside a repository with .actual/rules/, when the rules hold no decision, or when the CLI is missing or predates actual session summary. ACTUAL_PLAN_GATE=off leaves the row on. The same Claude Code as the briefing: 2.1.287 or later, or 2.1.285 and 2.1.286 with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS set to 1. The band is in the terminal and the desktop app, not in VS Code or claude -p. Where the mod loads, briefing is capped at 48,000 characters per session by default, and the agent is told once when the cap is hit. A governed Read, or a read-only shell read, gets the rules for that file beside the result. A file written without being read first is briefed with the write. The model never reads the one-line transcript reports, and they are not counted against the cap. The skill runs actual adr-bot, which reads the repository and fetches the team's ADRs from Actual AI, then writes guidance into CLAUDE.md, AGENTS.md, or Cursor rules. An architecture question goes to the Actual advisor, which answers from those ADRs. Onboarding is at https://app.actual.ai, and the command reference is at https://actual.ai/cli/docs. The first /actual asks permission to npm install -g @actualai/actual. ACTUAL_RULES_BRIEF=off turns briefing off while the checks keep running. The author measured 212 local sessions: four in five file reads went through cat, head, sed -n, or grep rather than Read.
The marketplace name is actual-cli-skills. The marketplace source is ./. The row of ADRs added to context is why this page files it under workflow. jev-rules draws a pane of which project rules Jev gave Claude, and names them on a line under the prompt. claude-jev has Jev judge each edit against your instruction files and cite a broken rule by file and line, and sends a thin subagent brief back once. This one adds the team's rules for a file as Claude reads it, and counts the ADRs that reached context. The row and the briefing beside a read are this mod. The plan check, when the agent leaves plan mode, and the check of the turn's changes belong to the skill. The README says the transcript lines never touch that verdict. The actual command is the CLI the skill installs, a separate program.
Demo

What it hooks into
session.startWhen a session startsturn.completeWhen a turn endsclassic.SessionStartA Claude Code eventui.renderDraws into the sessionAbovePromptPanecommand.runWhen you run its slash command/rules-briefclassic.PostToolUseA Claude Code eventclassic.PreToolUseA Claude Code eventtool.callAround a tool call, where it can hold oneBashRead
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/rules-briefWhat rule briefing has done this session, and where it stayed quiet
Hooks 6
SessionStart · startup|resume|clear|compact|fork"${CLAUDE_PLUGIN_ROOT}"/hooks/preflight.shUserPromptSubmit"${CLAUDE_PLUGIN_ROOT}"/hooks/turn-start.shPreToolUse · ExitPlanMode"${CLAUDE_PLUGIN_ROOT}"/hooks/plan-gate.shPreToolUse · Edit|Write"${CLAUDE_PLUGIN_ROOT}"/hooks/rules-brief.shPostToolUse · Read"${CLAUDE_PLUGIN_ROOT}"/hooks/rules-brief.shStop"${CLAUDE_PLUGIN_ROOT}"/hooks/impl-gate.sh
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- actual-software
- Category
- Workflow
- Marketplace
- actual-cli-skills
- Version
- 1.4.1
- License
- Apache-2.0
- Repo stars
- 5
- Last change
- 2026-10-16
- Language
- Shell
- Files
- 46