@scribe.cool/cli

Manage projects, generate invoices, and track work evidence from the command line. Part of the Scribe ecosystem.

Install

bun add -g @scribe.cool/cli

Requires Bun and the Scribe desktop app to initialize the local database.

Commands

Projects

scribe project list [--with-stats]          # List all projects
scribe project show <name>                  # Project details + roots
scribe project create --name "..."          # Create project group
scribe project discover                     # Scan filesystem for new repos
scribe project unassigned                   # List unassigned roots
scribe project assign <project> <path>      # Assign root to project
scribe project link-client <project> <client>  # Link project to client for billing

Clients

scribe client list                          # List all clients
scribe client create --name "..." --email "..." --rate 17500  # Rate in cents/hr
scribe client show <name>                   # Client details

Invoices

scribe invoice list [--status draft|sent|paid]
scribe invoice create --client "..." --description "..." --rate 1000000 --quantity 1
scribe invoice pdf <number> [--template mandala|minimal]
scribe invoice send <number> [--to email]
scribe invoice renumber <number-or-id> --to "OPL-2026-05-01"

renumber manually sets an invoice's number — a one-off for pulling legacy INV-* invoices into the per-client {ABBR}-{YYYY}-{MM}-{NN} scheme. It refuses a number already used by another invoice.

Two PDF templates:

• mandala — watercolor teal/gold design with work breakdown
• minimal — clean white, professional

Amounts are in cents ($10,000 = 1000000).

Timeline Summary

scribe summary --last-month
scribe summary --since 2026-01-01 --until 2026-01-31

Shows event counts, active projects, and per-source breakdown for a billing period.

Activity Report

scribe report                                          # last 7 days, terminal table
scribe report --days 30 --filter client --pdf ./r.pdf  # 30-day client PDF
scribe report --start 2026-06-01 --end 2026-06-07 --html ./week.html
scribe report --days 14 --json                         # raw JSON for agents/scripts

Full activity report (total time, source mix, per-project rollups, highlights). Default stdout is human-readable; --json preserves the machine-readable payload; --html / --pdf write files via the shared core report pipeline. See the bundled reporting skill for agent playbooks.

Business Info

scribe org info                             # Show business info + payment methods
scribe org set --company "..." --email "..." --address "..."
scribe org payment add --type wire --label "Wire Transfer" --detail "bank=..."

Connect your coding agent (MCP)

The desktop app exposes a localhost-only MCP server at http://localhost:3748/api/mcp that gives coding agents (Claude Code, Cursor, …) access to your local Scribe data.

scribe mcp connect                          # register with Claude Code (user scope)
scribe mcp connect --print                  # print the command + manual setup

scribe mcp connect runs claude mcp add --transport http -s user scribe-desktop http://localhost:3748/api/mcp when the Claude Code CLI is available, and otherwise prints instructions for connecting other agents. The desktop app must be running.

Other

scribe search "query"                       # Full-text search
scribe login                                # Authenticate with hub
scribe env ls                               # Environment variables

Claude Code Plugin

Scribe also ships as a Claude Code plugin with skills and session hooks:

claude plugin install scribe@b-open-io

The plugin auto-detects your project from the working directory and provides invoice and project management skills that guide AI agents through the CLI workflow.

Documentation

Full docs at getscribe.ai/docs/cli

License

MIT