CLI

corp is the terminal-first interface for TheCorporation. Every mutating command goes through the same governance kernel as the REST API, producing identical git commits whether run locally or against the hosted backend.

Install

Download a pre-built binary (recommended):

# macOS (Apple Silicon)
curl -L https://releases.thecorporation.ai/corp/latest/corp-aarch64-apple-darwin -o corp
chmod +x corp && sudo mv corp /usr/local/bin/

# macOS (Intel)
curl -L https://releases.thecorporation.ai/corp/latest/corp-x86_64-apple-darwin -o corp
chmod +x corp && sudo mv corp /usr/local/bin/

# Linux (x86_64)
curl -L https://releases.thecorporation.ai/corp/latest/corp-x86_64-unknown-linux-gnu -o corp
chmod +x corp && sudo mv corp /usr/local/bin/

Via npx (no install required):

npx -y @thecorporation/corp

Build from source (requires Rust 1.78+):

cargo install corp-cli

Setup

corp setup

This configures your API URL and token. For a local dev backend skip setup and use --local:

corp --local form create --name "Acme AI LLC"

Global flags

Flag	Description
--local	Run entirely locally with no server. State is written to ./corp-data (override with --data-dir or CORP_DATA_DIR)
--data-dir <path>	Override the local data directory (used with --local)
--json	Output machine-readable JSON (for scripting and CI)
--quiet	Suppress informational output, print only IDs or key values

Local mode

Run the full stack without an account or network connection:

corp --local --data-dir ./data form create --name "Acme Corp" --entity-type c_corp --jurisdiction DE
corp --local --data-dir ./data cap-table show
corp --local --data-dir ./data governance create-meeting --date 2026-04-01

Local mode uses the git storage backend — every operation is a commit in ./data.

Short ID prefixes and @last

Most commands accept a short prefix instead of a full ID:

corp cap-table show-grant ent_a1b2      # matches any ID starting with ent_a1b2

Use @last to reference the most recently created resource of a given type:

corp form create --name "Acme" --entity-type llc --jurisdiction WY
corp cap-table issue --cap-table-id @last --instrument-id <ID> --shares 1000000
corp contacts create --name "Jane Founder" --category founder

Core workflow

corp form create --name "Acme AI LLC" --entity-type llc --jurisdiction WY
corp cap-table show
corp governance create-meeting --date 2026-04-15 --body-id <BODY_ID>
corp finance create-invoice --customer "Client" --amount-cents 500000 --currency usd --description "Services" --due-date 2026-05-15
corp agents list

Command groups

Group	Purpose
form	Entity formation — create, inspect, and manage entities
cap-table	Cap table, instruments, rounds, SAFEs, grants, conversions
governance	Meetings, votes, resolutions, board consents
finance	GL accounts, journal entries, invoices, payments, payroll, bank accounts
contacts	Stakeholder and signer directory
agents	Deploy and manage autonomous agents
work-items	Tasks and tracked work
services	Integrations and external service configs
admin	API keys, workspace settings
execution	Inspect intents and receipts

JSON output

Every command supports --json for pipeline integration:

corp form create --name "Acme" --entity-type c_corp --jurisdiction DE --json
corp cap-table show --json | jq '.shares_outstanding'
corp contacts list --json

What’s next

• Commands Reference — full generated command list
• Self-Hosting — run the backend locally