TheCorporation.ai Form and Operate

---

name: thecorporation-form-and-operate description: How to use the npx corp CLI to manage corporate entities, governance, cap tables, finance, agents, and compliance for TheCorporation platform. Use this skill whenever the user mentions npx corp, TheCorporation, corporate formation, entity governance, cap table management, equity issuance, 409A valuations, board meetings, written consent, SAFE instruments, corporate agents, work items, or any task involving programmatic corporate governance. Also use when the user wants to form an LLC or C-Corp, manage board seats, issue stock options, run payroll, generate legal documents, or automate corporate compliance workflows. homepage: https://github.com/thecorporationai/thecorporation-mono install: - kind: node package: "@thecorporation/cli" bins: - corp

---

npx corp CLI Skill

The npx corp CLI is the command-line interface for TheCorporation platform — a corporate governance system built by agents, for agents. It manages the full lifecycle of business entities: formation, governance, cap tables, finance, documents, tax, compliance, agents, and work items.

Quick Start

Setup

npx corp setup

Choose a hosting mode:

Local (your machine) — no server needed. Data stored in ~/.corp/data. Each command invokes the Rust binary directly (~6ms).

TheCorporation cloud — hosted service, authenticates via magic link.

Self-hosted server — point to your own API server URL.

Local mode (recommended for development)

npx corp setup              # choose "Local (your machine)"
npx corp status             # verify — all local, no network

Cloud mode

npx corp setup              # choose "TheCorporation cloud"
Follow the magic link auth flow

Advanced: Local server mode

For development with a persistent HTTP server:

npx corp serve --port 8020
npx corp config set api_url http://localhost:8020 --force

Verify Context

npx corp context

Shows active workspace, user, entity, and hosting mode.

Reference Resolution

The CLI supports flexible reference formats across all commands:

| Format | Example | Description | |--------|---------|-------------| | Full UUID | 763dde4d-ca62-4e20-90ba-662c462d4b09 | Canonical ID | | Short ID | 763dde4d | First segment of UUID | | @last | @last | Most recently created resource of that type | | Name/Handle | "Acme Corp" | Unique name match |

Use npx corp resolve to test resolution. Use npx corp find to list matches.

Entity Formation

One-Shot Formation (Recommended for Agents)

Form an entity in a single command using key=value member syntax:

npx corp form \
  --type c_corp \
  --name "Acme Inc" \
  --jurisdiction US-DE \
  --member "name=Jane Doe,email=jane@acme.com,role=director,officer_title=ceo,is_incorporator=true,address=123 Main St|Dover|DE|19901" \
  --member "name=John Doe,email=john@acme.com,role=director,officer_title=cto,address=456 Oak Ave|Dover|DE|19901" \
  --json

One-shot flags:

--type — Entity type (see below)

--name — Legal name of the entity

--jurisdiction — e.g. US-DE, US-WY

--member — Founder (repeatable); key=value format with keys: name, email, role (director|officer|manager|member|chair), officer_title (ceo|cfo|cto|coo|secretary|treasurer|president|vp|other), is_incorporator (true|false), address (street|city|state|zip), pct (ownership %), shares (shares purchased)

--address

— Company address as street,city,state,zip

--fiscal-year-end — Fiscal year end (MM-DD, default "12-31")

--s-corp — Elect S-Corp status

--transfer-restrictions — Enable transfer restrictions

--rofr — Enable right of first refusal

Important: Member addresses use pipe | as separator (street|city|state|zip), NOT commas.

Staged Formation

For more control, use the staged flow:

1. Create — npx corp form create --type c_corp --name "Acme Inc" --jurisdiction US-DE --json 2. Add Founders — npx corp form add-founder @last --name "Jane Doe" --email jane@acme.com --role director --pct 100 --officer-title ceo --incorporator --address "123 Main St,Dover,DE,19901" --json 3. Finalize — npx corp form finalize @last --board-size 1 --company-address "123 Main St,Dover,DE,19901" --json 4. Activate — npx corp form activate @last --json

The activate step transitions from documents_generated to active status by auto-signing formation documents.

Staged add-founder flags:

--name (required), --email (required), --role (required: director|officer|manager|member|chair), --pct (required: ownership %)

--officer-title