CLI Commands Reference

Generated from crates/corp-cli/src/commands/ in the v2 codebase.

corp

Top-level built-in commands

Subcommand	Description
corp status	Show workspace status summary (active entity, pending actions)
corp next	Show recommended next steps for the active entity
corp context	Show current CLI context (API URL, workspace, active entity)
corp use	Set the active entity for subsequent commands

corp use

Set the active entity for subsequent commands

Arguments

Argument	Type	Required	Description
--entity-ref	String	yes	Entity ID or name prefix

corp admin

administrative operations (workspace management, API keys, health).

Subcommand	Description
corp admin health	Check API health
corp admin workspaces	List all workspaces (super-admin only)
corp admin workspace-entities	List entities in a workspace (super-admin only)
corp admin api-keys	List API keys for the current workspace (keys use the corp_ prefix)
corp admin create-api-key	Create a new API key (keys use the corp_ prefix)
corp admin revoke-api-key	Revoke an API key (by key ID from corp admin api-keys)

corp admin workspace-entities

List entities in a workspace (super-admin only)

Arguments

Argument	Type	Required	Description
--workspace-id	String	yes	Workspace ID (from corp admin workspaces)

corp admin create-api-key

Create a new API key (keys use the corp_ prefix)

Arguments

Argument	Type	Required	Description
--name	String	yes	Key display name (for identification in the dashboard)
--scopes	String	no	Comma-separated list of scopes. Valid values:
--entity-id	String	no	Restrict key to a specific entity ID (from corp entities list, optional)

corp admin revoke-api-key

Revoke an API key (by key ID from corp admin api-keys)

Arguments

Argument	Type	Required	Description
--key-id	String	yes	API key ID to revoke (from corp admin api-keys; keys use the corp_ prefix)

corp agents

AI agent management.

Subcommand	Description
corp agents list	List agents in the workspace
corp agents show	Show an agent
corp agents create	Create a new agent
corp agents update	Update an agent
corp agents add-skill	Add a skill to an agent
corp agents remove-skill	Remove a skill from an agent
corp agents pause	Pause an agent — stops processing new tasks
corp agents resume	Resume a paused agent
corp agents delete	Permanently delete an agent

corp agents show

Show an agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)

corp agents create

Create a new agent

Arguments

Argument	Type	Required	Description
--name	String	yes	—
--prompt	String	no	—
--model	String	no	—
--entity-id	String	no	—

corp agents update

Update an agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)
--name	String	no	New display name
--prompt	String	no	—
--model	String	no	—

corp agents add-skill

Add a skill to an agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)
--name	String	yes	—
--description	String	yes	—
--instructions	String	no	—

corp agents remove-skill

Remove a skill from an agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)
--name	String	yes	Skill name to remove

corp agents pause

Pause an agent — stops processing new tasks

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)

corp agents resume

Resume a paused agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)

corp agents delete

Permanently delete an agent

Arguments

Argument	Type	Required	Description
--agent-ref	String	yes	Agent ID (from corp agents list)

corp cap-table

corp cap-table — cap table management.

Subcommand	Description
corp cap-table show	Show the cap table aggregate for the active (or specified) entity
corp cap-table init	Initialize a new cap table for the entity
corp cap-table grants	List equity grants
corp cap-table show-grant	Show a single equity grant
corp cap-table issue	Issue shares (create an equity grant)
corp cap-table safes	List SAFE notes
corp cap-table issue-safe	Issue a SAFE note
corp cap-table convert-safe	Convert a SAFE note to equity
corp cap-table valuations	List valuations
corp cap-table create-valuation	Create a valuation
corp cap-table submit-valuation	Submit a valuation for review (draft → submitted)
corp cap-table approve-valuation	Approve a submitted valuation (submitted → approved)
corp cap-table transfers	List share transfers
corp cap-table create-transfer	Create a share transfer
corp cap-table approve-transfer	Approve a share transfer (pending → approved)
corp cap-table execute-transfer	Execute an approved share transfer (approved → executed)
corp cap-table rounds	List funding rounds
corp cap-table create-round	Create a funding round
corp cap-table advance-round	Advance a funding round to the next stage
corp cap-table close-round	Close a funding round
corp cap-table holders	List all holders
corp cap-table create-holder	Create a holder
corp cap-table vesting	List vesting schedules
corp cap-table create-vesting	Create a vesting schedule for a grant
corp cap-table materialize-vesting	Materialize vesting events for a schedule
corp cap-table vest-event	Vest a scheduled vesting event
corp cap-table instruments	List instruments
corp cap-table create-instrument	Create an instrument
corp cap-table forfeit-event	Forfeit a scheduled vesting event
corp cap-table terminate-vesting	Terminate a vesting schedule (forfeits all remaining scheduled events)
corp cap-table vest-due	Vest all due events for a schedule (bulk vest)
corp cap-table positions	List positions (holdings)
corp cap-table create-position	Create a position (holding)
corp cap-table apply-delta	Apply a delta to an existing position
corp cap-table investor-ledger	List investor ledger entries
corp cap-table create-ledger-entry	Create an investor ledger entry
corp cap-table legal-entities	List legal entities (corporate structure)
corp cap-table create-legal-entity	Create a legal entity node
corp cap-table control-links	List control links between legal entities
corp cap-table create-control-link	Create a control link between two legal entities
corp cap-table repurchase-rights	List repurchase rights
corp cap-table create-repurchase-right	Create a repurchase right on a grant
corp cap-table activate-repurchase	Activate a repurchase right (draft → active)
corp cap-table close-repurchase	Close a repurchase right (mark as exercised)
corp cap-table waive-repurchase	Waive a repurchase right
corp cap-table exercise-option	Exercise stock options (convert option grant to shares)

corp cap-table show

Show the cap table aggregate for the active (or specified) entity

Arguments

Argument	Type	Required	Description
--entity-ref	String	no	Entity ID (defaults to active entity)

corp cap-table show-grant

Show a single equity grant

Arguments

Argument	Type	Required	Description
--grant-id	String	yes	Grant ID (from corp cap-table grants)

corp cap-table issue

Issue shares (create an equity grant)

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--instrument-id	String	yes	Instrument ID (from corp cap-table instruments)
--recipient-contact-id	String	yes	Recipient contact ID (from corp contacts list)
--recipient-name	String	yes	Recipient display name
--grant-type	String	yes	Grant type [possible values: common_stock, preferred_stock, membership_unit, stock_option, iso, nso, rsa]
--shares	i64	yes	Number of shares to issue
--price-per-share-cents	i64	no	Price per share in cents (e.g. $0.001 = 0; optional, omit for grants at no cost)
--resolution-id	String	no	Resolution ID linking this grant to a board approval (from corp governance)

corp cap-table issue-safe

Issue a SAFE note

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--investor-contact-id	String	yes	Investor contact ID (from corp contacts list)
--investor-name	String	yes	Investor display name
--safe-type	String	yes	SAFE type [possible values: post_money, pre_money, mfn]
--investment-amount-cents	i64	yes	Investment amount in cents
--valuation-cap-cents	i64	no	Valuation cap in cents (optional)
--discount-percent	u32	no	Discount percentage, e.g. 20 for 20% (optional)

corp cap-table convert-safe

Convert a SAFE note to equity

Arguments

Argument	Type	Required	Description
--safe-id	String	yes	SAFE note ID (from corp cap-table safes)
--instrument-id	String	yes	Target instrument to convert into (e.g. Series Seed Preferred)
--conversion-shares	i64	no	Number of shares the investor receives (auto-calculated from SAFE terms if omitted)
--holder-id	String	yes	Holder record for the investor

corp cap-table create-valuation

Create a valuation

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--valuation-type	String	yes	Valuation type [possible values: four_oh_nine_a, fair_market_value, other]
--methodology	String	yes	Valuation methodology [possible values: income, market, asset, backsolve, hybrid, other]
--valuation-amount-cents	i64	yes	Valuation amount in cents
--effective-date	String	yes	Effective date (YYYY-MM-DD)
--prepared-by	String	no	Name or firm that prepared the valuation (optional)

corp cap-table submit-valuation

Submit a valuation for review (draft → submitted)

Arguments

Argument	Type	Required	Description
--valuation-id	String	yes	Valuation ID (from corp cap-table valuations)

corp cap-table approve-valuation

Approve a submitted valuation (submitted → approved)

Arguments

Argument	Type	Required	Description
--valuation-id	String	yes	Valuation ID (from corp cap-table valuations)
--approved-by	String	yes	Name of the approver

corp cap-table create-transfer

Create a share transfer

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--from-holder-id	String	yes	From holder ID (from corp cap-table holders)
--to-holder-id	String	yes	To holder ID (from corp cap-table holders)
--instrument-id	String	yes	Instrument ID (from corp cap-table instruments)
--shares	i64	yes	Number of shares to transfer
--transfer-type	String	yes	Transfer type [possible values: gift, trust_transfer, secondary_sale, estate, other]
--price-per-share-cents	i64	no	Price per share in cents (e.g. $0.001 = 0; optional)

corp cap-table approve-transfer

Approve a share transfer (pending → approved)

Arguments

Argument	Type	Required	Description
--transfer-id	String	yes	Transfer ID (from corp cap-table transfers)

corp cap-table execute-transfer

Execute an approved share transfer (approved → executed)

Arguments

Argument	Type	Required	Description
--transfer-id	String	yes	Transfer ID (from corp cap-table transfers)

corp cap-table create-round

Create a funding round

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--name	String	yes	Round name (e.g. Seed, Series A)
--target-amount-cents	i64	yes	Target raise amount in cents
--price-per-share-cents	i64	no	Price per share in cents (e.g. $0.001 = 0; optional)

corp cap-table advance-round

Advance a funding round to the next stage

Arguments

Argument	Type	Required	Description
--round-id	String	yes	Round ID (from corp cap-table rounds)

corp cap-table close-round

Close a funding round

Arguments

Argument	Type	Required	Description
--round-id	String	yes	Round ID (from corp cap-table rounds)

corp cap-table create-holder

Create a holder

Arguments

Argument	Type	Required	Description
--name	String	yes	Holder display name
--holder-type	String	yes	Holder type [possible values: individual, entity, trust]
--contact-id	String	no	Contact ID to link (from corp contacts list; optional)

corp cap-table create-vesting

Create a vesting schedule for a grant

Arguments

Argument	Type	Required	Description
--grant-id	String	yes	—
--total-shares	i64	yes	—
--start-date	String	yes	—
--template	String	yes	—
--cliff-months	u32	yes	—
--total-months	u32	yes	—

corp cap-table materialize-vesting

Materialize vesting events for a schedule

Arguments

Argument	Type	Required	Description
--schedule-id	String	yes	—

corp cap-table vest-event

Vest a scheduled vesting event

Arguments

Argument	Type	Required	Description
--event-id	String	yes	Vesting event ID

corp cap-table create-instrument

Create an instrument

Arguments

Argument	Type	Required	Description
--cap-table-id	String	yes	Cap table ID (from corp cap-table show)
--symbol	String	yes	Short symbol, e.g. CS-A or PREF-SEED
--kind	String	yes	Instrument kind [possible values: common_equity, preferred_equity, membership_unit, option_grant, safe, convertible_note, warrant]
--authorized-units	i64	no	Authorized unit count (optional)
--par-value	String	no	Par value per unit (decimal string, e.g. “0.00001”; optional)
--issue-price-cents	i64	no	Issue price in cents (optional)
--liquidation-preference	String	no	Liquidation preference description (preferred only; optional)

corp cap-table forfeit-event

Forfeit a scheduled vesting event

Arguments

Argument	Type	Required	Description
--event-id	String	yes	Vesting event ID

corp cap-table terminate-vesting

Terminate a vesting schedule (forfeits all remaining scheduled events)

Arguments

Argument	Type	Required	Description
--schedule-id	String	yes	Vesting schedule ID
--termination-date	String	yes	Termination date (YYYY-MM-DD)

corp cap-table vest-due

Vest all due events for a schedule (bulk vest)

Arguments

Argument	Type	Required	Description
--schedule-id	String	yes	—

corp cap-table create-position

Create a position (holding)

Arguments

Argument	Type	Required	Description
--holder-id	String	yes	Holder ID (from corp cap-table holders)
--instrument-id	String	yes	Instrument ID (from corp cap-table instruments)
--quantity-units	i64	yes	Quantity of units held
--principal-cents	i64	no	Principal amount in cents (optional)
--source-reference	String	no	Source reference (e.g. grant ID, safe ID)

corp cap-table apply-delta

Apply a delta to an existing position

Arguments

Argument	Type	Required	Description
--position-id	String	yes	Position ID (from corp cap-table positions)
--quantity-delta	i64	yes	Quantity change (positive to increase, negative to decrease)
--principal-delta	i64	no	Principal change in cents (optional)
--source-reference	String	no	Source reference for this adjustment

corp cap-table create-ledger-entry

Create an investor ledger entry

Arguments

Argument	Type	Required	Description
--investor-id	String	yes	Investor holder ID (from corp cap-table holders)
--investor-name	String	yes	Investor display name
--entry-type	String	yes	Entry type [possible values: investment, conversion, distribution, repurchase, other]
--amount-cents	i64	yes	Amount in cents
--shares-received	i64	no	Number of shares received (optional)
--pro-rata-eligible	bool	yes	Whether investor is pro-rata eligible
--memo	String	no	Memo note (optional)
--effective-date	String	yes	Effective date (YYYY-MM-DD)
--safe-note-id	String	no	SAFE note ID to link (optional)
--funding-round-id	String	no	Funding round ID to link (optional)

corp cap-table create-legal-entity

Create a legal entity node

Arguments

Argument	Type	Required	Description
--name	String	yes	Legal entity name
--role	String	yes	Role [possible values: operating, control, investment, nonprofit, spv, other]
--linked-entity-id	String	no	Entity ID to link (optional)

corp cap-table create-control-link

Create a control link between two legal entities

Arguments

Argument	Type	Required	Description
--parent-legal-entity-id	String	yes	Parent legal entity ID (from corp cap-table legal-entities)
--child-legal-entity-id	String	yes	Child legal entity ID (from corp cap-table legal-entities)
--control-type	String	yes	Control type [possible values: voting, board, economic, contractual]
--voting-power-bps	i32	no	Voting power in basis points (e.g. 5100 = 51%; optional)
--notes	String	no	Descriptive notes (optional)

corp cap-table create-repurchase-right

Create a repurchase right on a grant

Arguments

Argument	Type	Required	Description
--grant-id	String	yes	Grant ID (from corp cap-table grants)
--share-count	i64	yes	Number of shares subject to repurchase
--price-per-share-cents	i64	yes	Repurchase price per share in cents
--expiration-date	String	no	Expiration date (YYYY-MM-DD; optional)

corp cap-table activate-repurchase

Activate a repurchase right (draft → active)

Arguments

Argument	Type	Required	Description
--rr-id	String	yes	Repurchase right ID (from corp cap-table repurchase-rights)

corp cap-table close-repurchase

Close a repurchase right (mark as exercised)

Arguments

Argument	Type	Required	Description
--rr-id	String	yes	Repurchase right ID (from corp cap-table repurchase-rights)

corp cap-table waive-repurchase

Waive a repurchase right

Arguments

Argument	Type	Required	Description
--rr-id	String	yes	Repurchase right ID (from corp cap-table repurchase-rights)

corp cap-table exercise-option

Exercise stock options (convert option grant to shares)

Arguments

Argument	Type	Required	Description
--grant-id	String	yes	Grant ID (from corp cap-table grants)
--holder-id	String	yes	Holder ID for the exercising party (from corp cap-table holders)
--shares	i64	yes	Number of shares to exercise
--exercise-date	String	no	Exercise date (YYYY-MM-DD; defaults to today)

corp contacts

contact management.

Subcommand	Description
corp contacts list	List contacts for the active entity
corp contacts show	Show contact details
corp contacts add	Add a new contact
corp contacts edit	Update a contact

corp contacts show

Show contact details

Arguments

Argument	Type	Required	Description
--contact-ref	String	yes	Contact ID (from corp contacts list)

corp contacts add

Add a new contact

Arguments

Argument	Type	Required	Description
--name	String	yes	—
--email	String	no	—
--phone	String	no	—
--contact-type	String	no	—
--category	String	no	—

corp contacts edit

Update a contact

Arguments

Argument	Type	Required	Description
--contact-ref	String	yes	Contact ID (from corp contacts list)
--name	String	no	New display name
--email	String	no	New email address
--category	String	no	New category
--phone	String	no	Phone number

corp entities

manage legal entities.

Subcommand	Description
corp entities list	List all entities in the workspace
corp entities show	Show entity details including formation status and key dates
corp entities create	Create a new corporate entity and begin formation
corp entities dissolve	Dissolve an entity (irreversible)

corp entities show

Show entity details including formation status and key dates

Arguments

Argument	Type	Required	Description
--entity-ref	String	yes	Entity ID or name prefix

corp entities create

Create a new corporate entity and begin formation

Arguments

Argument	Type	Required	Description
--name	String	yes	Legal name of the entity (e.g. Anthropic PBC)
--entity-type	String	yes	Entity type: c_corp or llc
--jurisdiction	String	yes	US state code (e.g. DE, CA, WY, NV)

corp entities dissolve

Dissolve an entity (irreversible)

Arguments

Argument	Type	Required	Description
--entity-ref	String	yes	Entity ID or name prefix
--reason	String	no	Reason for dissolution (recorded in governance records)

corp execution

execution intents, obligations, and receipts.

Subcommand	Description
corp execution intents	List intents for the active entity
corp execution show-intent	Show a single intent
corp execution create-intent	Create an execution intent
corp execution evaluate-intent	Evaluate an intent (pending → evaluated)
corp execution authorize-intent	Authorize an intent (evaluated → authorized)
corp execution execute-intent	Mark intent as executed (authorized → executed)
corp execution cancel-intent	Cancel an intent (any non-executed state → cancelled)
corp execution update-intent	Update an intent’s metadata or description
corp execution obligations	List obligations for the active entity
corp execution show-obligation	Show a single obligation
corp execution create-obligation	Create an obligation
corp execution start-obligation	Begin work (required → in_progress)
corp execution fulfill-obligation	Mark as fulfilled (in_progress → fulfilled)
corp execution waive-obligation	Waive — no longer required
corp execution update-obligation	Update an obligation
corp execution receipts	List execution receipts
corp execution show-receipt	Show a single receipt
corp execution create-receipt	Create an execution receipt (records an idempotent execution result)

corp execution show-intent

Show a single intent

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)

corp execution create-intent

Create an execution intent

Arguments

Argument	Type	Required	Description
--intent-type	String	yes	Dotted type (e.g. equity.grant.issue, governance.resolution.approve)
--description	String	yes	What this intent authorizes
--authority-tier	String	yes	Required authorization: tier1, tier2, or tier3

corp execution evaluate-intent

Evaluate an intent (pending → evaluated)

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)

corp execution authorize-intent

Authorize an intent (evaluated → authorized)

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)

corp execution execute-intent

Mark intent as executed (authorized → executed)

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)

corp execution cancel-intent

Cancel an intent (any non-executed state → cancelled)

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)

corp execution update-intent

Update an intent’s metadata or description

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID (from corp execution intents)
--description	String	no	New description

corp execution show-obligation

Show a single obligation

Arguments

Argument	Type	Required	Description
--obligation-id	String	yes	Obligation ID (from corp execution obligations)

corp execution create-obligation

Create an obligation

Arguments

Argument	Type	Required	Description
--obligation-type	String	yes	Type (e.g. file_annual_report, transfer_shares)
--assignee-type	String	yes	Who is responsible: internal, third_party, or human
--assignee-id	String	no	Assignee ID (contact ID, depending on —assignee-type)
--description	String	yes	What must be done to fulfill this
--due-date	String	no	Deadline (YYYY-MM-DD)
--intent-id	String	no	Link to authorizing intent (from corp execution intents)

corp execution start-obligation

Begin work (required → in_progress)

Arguments

Argument	Type	Required	Description
--obligation-id	String	yes	Obligation ID (from corp execution obligations)

corp execution fulfill-obligation

Mark as fulfilled (in_progress → fulfilled)

Arguments

Argument	Type	Required	Description
--obligation-id	String	yes	Obligation ID (from corp execution obligations)

corp execution waive-obligation

Waive — no longer required

Arguments

Argument	Type	Required	Description
--obligation-id	String	yes	Obligation ID (from corp execution obligations)

corp execution update-obligation

Update an obligation

Arguments

Argument	Type	Required	Description
--obligation-id	String	yes	Obligation ID (from corp execution obligations)
--description	String	no	New description
--assignee-id	String	no	Assign to a contact (contact ID from corp contacts list)

corp execution show-receipt

Show a single receipt

Arguments

Argument	Type	Required	Description
--receipt-id	String	yes	Receipt ID (from corp execution receipts)

corp execution create-receipt

Create an execution receipt (records an idempotent execution result)

Arguments

Argument	Type	Required	Description
--intent-id	String	yes	Intent ID this receipt is for (from corp execution intents)
--idempotency-key	String	yes	Idempotency key (unique string to prevent duplicate execution)
--request-hash	String	yes	SHA-256 hash of the request payload

corp finance

treasury, accounts, journal entries, invoices, payments,

Subcommand	Description
corp finance accounts	List GL accounts
corp finance create-account	Create a GL account
corp finance journal-entries	List journal entries
corp finance create-journal-entry	Create a new double-entry journal entry
corp finance post-entry	Post a journal entry (validates debits equal credits, draft → posted)
corp finance void-entry	Void a journal entry (posted → voided)
corp finance invoices	List invoices
corp finance create-invoice	Create an invoice
corp finance send-invoice	Send an invoice (draft → sent)
corp finance pay-invoice	Mark an invoice as paid (sent → paid)
corp finance payments	List payments
corp finance create-payment	Record a payment
corp finance bank-accounts	List bank accounts
corp finance open-account	Open a new bank account
corp finance activate-account	Activate a bank account after review (pending_review → active)
corp finance close-account	Close a bank account (active → closed)
corp finance payroll	List payroll runs
corp finance create-payroll-run	Create a payroll run (draft)
corp finance approve-payroll	Approve a payroll run (draft → approved)
corp finance process-payroll	Process an approved payroll run (approved → processed)
corp finance reconciliations	List reconciliations
corp finance reconcile	Create a reconciliation

corp finance create-account

Create a GL account

Arguments

Argument	Type	Required	Description
--account-code	String	yes	—
--account-name	String	yes	—
--currency	String	yes	—

corp finance create-journal-entry

Create a new double-entry journal entry

Arguments

Argument	Type	Required	Description
--date	String	yes	—
--description	String	yes	—
--lines	String	yes	—

corp finance post-entry

Post a journal entry (validates debits equal credits, draft → posted)

Arguments

Argument	Type	Required	Description
--entry-id	String	yes	—

corp finance void-entry

Void a journal entry (posted → voided)

Arguments

Argument	Type	Required	Description
--entry-id	String	yes	—

corp finance create-invoice

Create an invoice

Arguments

Argument	Type	Required	Description
--customer	String	yes	—
--email	String	no	—
--amount-cents	i64	yes	—
--currency	String	yes	—
--description	String	yes	Invoice description (line item summary)
--due-date	String	yes	—

corp finance send-invoice

Send an invoice (draft → sent)

Arguments

Argument	Type	Required	Description
--invoice-id	String	yes	—

corp finance pay-invoice

Mark an invoice as paid (sent → paid)

Arguments

Argument	Type	Required	Description
--invoice-id	String	yes	—

corp finance create-payment

Record a payment

Arguments

Argument	Type	Required	Description
--recipient-name	String	yes	—
--amount-cents	i64	yes	—
--method	String	yes	—
--reference	String	no	—

corp finance open-account

Open a new bank account

Arguments

Argument	Type	Required	Description
--institution	String	yes	—
--account-type	String	yes	—
--account-number-last4	String	no	Last 4 digits of account number
--routing-number-last4	String	no	Last 4 digits of routing number

corp finance activate-account

Activate a bank account after review (pending_review → active)

Arguments

Argument	Type	Required	Description
--bank-id	String	yes	—

corp finance close-account

Close a bank account (active → closed)

Arguments

Argument	Type	Required	Description
--bank-id	String	yes	—

corp finance create-payroll-run

Create a payroll run (draft)

Arguments

Argument	Type	Required	Description
--period-start	String	yes	—
--period-end	String	yes	—
--total-gross-cents	i64	yes	—
--total-net-cents	i64	yes	—
--employee-count	u32	yes	—

corp finance approve-payroll

Approve a payroll run (draft → approved)

Arguments

Argument	Type	Required	Description
--run-id	String	yes	—

corp finance process-payroll

Process an approved payroll run (approved → processed)

Arguments

Argument	Type	Required	Description
--run-id	String	yes	—

corp finance reconcile

Create a reconciliation

Arguments

Argument	Type	Required	Description
--account-id	String	yes	—
--period-end	String	yes	—
--statement-balance-cents	i64	yes	—
--book-balance-cents	i64	yes	—

corp form

entity formation workflow.

Subcommand	Description
corp form create	Start a new entity formation. Creates the entity and begins the formation workflow.
corp form advance	Advance the formation state machine to the next stage. Preconditions vary by state.
corp form status	Show the current formation status and stage for an entity
corp form documents	List formation documents
corp form document	Show a specific document
corp form sign	Sign a formation document. All required documents must be signed before advancing.
corp form filing	Show the filing record
corp form confirm-filing	Record that the state has accepted the filing
corp form tax	Show tax profile
corp form confirm-ein	Record the Employer Identification Number assigned by the IRS

corp form create

Start a new entity formation. Creates the entity and begins the formation workflow.

Arguments

Argument	Type	Required	Description
--name	String	yes	Legal name of the entity
--entity-type	String	yes	Entity type: c_corp or llc
--jurisdiction	String	yes	US state code for jurisdiction of formation (e.g. DE, CA, WY)

corp form advance

Advance the formation state machine to the next stage. Preconditions vary by state.

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.

corp form status

Show the current formation status and stage for an entity

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.

corp form documents

List formation documents

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.

corp form document

Show a specific document

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity that owns the document
--document-id	String	yes	Document ID (from corp form documents)

corp form sign

Sign a formation document. All required documents must be signed before advancing.

Arguments

Argument	Type	Required	Description
--document-ref	String	yes	Document ID to sign (from corp form documents)
--signer-name	String	yes	Full legal name of the signer
--signer-role	String	yes	Organizational title (e.g. CEO, Director, Incorporator)
--signer-email	String	yes	Email address of the signer (used for duplicate detection)
--signature-text	String	yes	Typed signature (e.g. the signer’s name)
--consent-text	String	yes	Consent statement acknowledged by the signer

corp form filing

Show the filing record

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.

corp form confirm-filing

Record that the state has accepted the filing

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.
--confirmation-number	String	no	State-issued confirmation or filing number

corp form tax

Show tax profile

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.

corp form confirm-ein

Record the Employer Identification Number assigned by the IRS

Arguments

Argument	Type	Required	Description
--entity-id	String	yes	Entity ID (UUID). Use corp entities list to find IDs.
--ein	String	yes	IRS Employer Identification Number (format: XX-XXXXXXX)

corp governance

governance bodies, seats, meetings, and votes.

Subcommand	Description
corp governance bodies	List governance bodies
corp governance show-body	Show a governance body
corp governance create-body	Create a governance body
corp governance deactivate-body	Deactivate a governance body
corp governance seats	List all seats
corp governance show-seat	Show a seat
corp governance add-seat	Add a seat to a governance body
corp governance resign-seat	Resign a seat
corp governance meetings	List meetings
corp governance show-meeting	Show a meeting
corp governance create-meeting	Create a meeting
corp governance send-notice	Record that meeting notice was sent (draft → noticed)
corp governance convene	Convene a meeting (draft|noticed → convened)
corp governance adjourn	Adjourn a meeting (convened → adjourned)
corp governance cancel-meeting	Cancel a meeting (from draft or noticed state)
corp governance reopen	Reopen an adjourned meeting (adjourned → convened)
corp governance record-attendance	Record attendance for a meeting
corp governance items	List agenda items for a meeting
corp governance add-item	Add an agenda item to a meeting
corp governance votes	List votes for a meeting
corp governance vote	Cast a vote on an agenda item
corp governance resolve-item	Resolve an agenda item
corp governance written-consent	Create a written consent meeting with a single resolution item, ready for votes
corp governance quick-approve	One-step approval: creates meeting, adds resolution, records unanimous votes, resolves, and adjourns
corp governance profile	Show the governance profile for the active entity
corp governance update-profile	Update the governance profile (full replacement, not partial patch — all fields required)

corp governance show-body

Show a governance body

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)

corp governance create-body

Create a governance body

Arguments

Argument	Type	Required	Description
--name	String	yes	Body name
--body-type	String	yes	Body type [possible values: board_of_directors, llc_member_vote]
--quorum	String	yes	Quorum rule: majority (>50%), supermajority (≥2/3), or unanimous
--voting-method	String	yes	Voting method: per_capita = one vote per seat; per_unit = weighted by voting_power

corp governance deactivate-body

Deactivate a governance body

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)

corp governance show-seat

Show a seat

Arguments

Argument	Type	Required	Description
--seat-id	String	yes	Seat ID (from corp governance seats)

corp governance add-seat

Add a seat to a governance body

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)
--holder-id	String	yes	Contact ID of the seat holder (from corp contacts list)
--role	String	yes	Role: chair, member, officer, or observer (observers cannot vote)
--appointed-date	String	yes	Appointment date (YYYY-MM-DD)
--term-expiration	String	no	Term expiration date (YYYY-MM-DD)
--voting-power	u32	yes	Voting power (default: 1)

corp governance resign-seat

Resign a seat

Arguments

Argument	Type	Required	Description
--seat-id	String	yes	Seat ID (from corp governance seats)

corp governance show-meeting

Show a meeting

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance create-meeting

Create a meeting

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)
--title	String	yes	Meeting title
--meeting-type	String	yes	Meeting type [possible values: board_meeting, shareholder_meeting, written_consent, member_meeting]

corp governance send-notice

Record that meeting notice was sent (draft → noticed)

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance convene

Convene a meeting (draft|noticed → convened)

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance adjourn

Adjourn a meeting (convened → adjourned)

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance cancel-meeting

Cancel a meeting (from draft or noticed state)

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance reopen

Reopen an adjourned meeting (adjourned → convened)

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance record-attendance

Record attendance for a meeting

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)
--seat-ids	String	yes	Comma-separated seat IDs of members present

corp governance items

List agenda items for a meeting

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance add-item

Add an agenda item to a meeting

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)
--title	String	yes	Item title
--item-type	String	yes	Agenda item type: resolution, discussion, report, or election
--description	String	no	Description of the agenda item (optional)
--resolution-text	String	no	Resolution text (optional; required for resolution items)

corp governance votes

List votes for a meeting

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)

corp governance vote

Cast a vote on an agenda item

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)
--item-id	String	yes	Agenda item ID (from corp governance items)
--seat-id	String	yes	Seat ID casting the vote (from corp governance seats)
--value	String	yes	Vote value: for, against, abstain, or recusal

corp governance resolve-item

Resolve an agenda item

Arguments

Argument	Type	Required	Description
--meeting-id	String	yes	Meeting ID (from corp governance meetings)
--item-id	String	yes	Agenda item ID (from corp governance items)
--resolution-type	String	yes	Resolution outcome: ordinary, special, or unanimous_written_consent
--resolution-text	String	yes	Full text of the resolution

corp governance written-consent

Create a written consent meeting with a single resolution item, ready for votes

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)
--title	String	yes	Resolution title
--resolution-text	String	yes	Full text of the resolution

corp governance quick-approve

One-step approval: creates meeting, adds resolution, records unanimous votes, resolves, and adjourns

Arguments

Argument	Type	Required	Description
--body-id	String	yes	Governance body ID (from corp governance bodies)
--title	String	yes	Resolution title
--resolution-text	String	yes	Full text of the resolution

corp governance update-profile

Update the governance profile (full replacement, not partial patch — all fields required)

Arguments

Argument	Type	Required	Description
--entity-type	String	yes	Entity type (c_corp or llc)
--legal-name	String	yes	Legal name
--jurisdiction	String	yes	Jurisdiction (e.g. DE)
--effective-date	String	yes	Effective date (YYYY-MM-DD)

corp services

service request management.

Subcommand	Description
corp services list	List service requests for the active entity
corp services show	Show a service request
corp services buy	Purchase a service by slug (creates a pending service request)
corp services checkout	Begin checkout for a service request (pending → checkout)
corp services pay	Mark a service request as paid (checkout → paid)
corp services fulfill	Mark a service request as fulfilled — admin only (paid → fulfilled)

corp services show

Show a service request

Arguments

Argument	Type	Required	Description
--request-ref	String	yes	Service request ID (from corp services list)

corp services buy

Purchase a service by slug (creates a pending service request)

Arguments

Argument	Type	Required	Description
--slug	String	yes	Service product slug (e.g. registered-agent-de, annual-report-de)
--amount-cents	i64	yes	Price in cents (e.g. 49900 = $499.00)

corp services checkout

Begin checkout for a service request (pending → checkout)

Arguments

Argument	Type	Required	Description
--request-ref	String	yes	Service request ID (from corp services list)

corp services pay

Mark a service request as paid (checkout → paid)

Arguments

Argument	Type	Required	Description
--request-ref	String	yes	Service request ID (from corp services list)

corp services fulfill

Mark a service request as fulfilled — admin only (paid → fulfilled)

Arguments

Argument	Type	Required	Description
--request-ref	String	yes	Service request ID (from corp services list)
--note	String	no	Fulfillment note describing what was delivered

corp setup

interactive first-run wizard.

Subcommand	Description
corp setup set	Set a configuration value
corp setup get	Get a configuration value
corp setup list	List all configuration values

corp setup set

Set a configuration value

Arguments

Argument	Type	Required	Description
--key	String	yes	Configuration key (api_url, api_key, workspace_id, active_entity_id)
--value	String	yes	Value to set

corp setup get

Get a configuration value

Arguments

Argument	Type	Required	Description
--key	String	yes	Configuration key

corp work-items

corp work-items — work item tracking.

Subcommand	Description
corp work-items list	List work items for the active entity
corp work-items show	Show a work item
corp work-items create	Create a work item (open)
corp work-items claim	Claim a work item (open → claimed)
corp work-items release	Release a claimed work item back to open
corp work-items complete	Complete a work item (claimed → completed)
corp work-items cancel	Cancel a work item

corp work-items show

Show a work item

Arguments

Argument	Type	Required	Description
--item-ref	String	yes	Work item ID (from corp work-items list)

corp work-items create

Create a work item (open)

Arguments

Argument	Type	Required	Description
--title	String	yes	Short title describing the work to be done
--category	String	yes	Category for routing and filtering (e.g. tax, legal, compliance, finance)
--description	String	no	Optional detailed description of the work item
--deadline	String	no	Deadline date (YYYY-MM-DD)
--asap	bool	yes	Mark this item as ASAP priority

corp work-items claim

Claim a work item (open → claimed)

Arguments

Argument	Type	Required	Description
--item-ref	String	yes	Work item ID (from corp work-items list)
--claimed-by	String	yes	Claimant identifier (agent ID from corp agents list, user ID, or display name)
--claim-ttl-seconds	u64	no	Optional claim TTL in seconds (claim expires after this duration)

corp work-items release

Release a claimed work item back to open

Arguments

Argument	Type	Required	Description
--item-ref	String	yes	Work item ID (from corp work-items list)

corp work-items complete

Complete a work item (claimed → completed)

Arguments

Argument	Type	Required	Description
--item-ref	String	yes	Work item ID (from corp work-items list)
--completed-by	String	yes	Identifier of who completed the work (agent ID or user ID)
--result	String	no	Result or completion note describing what was done

corp work-items cancel

Cancel a work item

Arguments

Argument	Type	Required	Description
--item-ref	String	yes	Work item ID (from corp work-items list)