TheCorporation.ai Form and Operate — TheCorporation.AI Form and Operate

npx corp 命令行工具 技能

The npx corp 命令行工具 is the command-line interface for TheCorporation 平台 — a corporate 治理 系统 built by 代理s, for 代理s. It manages the full lifecycle of business entities: 格式化ion, 治理, cap tables, finance, documents, tax, 合规, 代理s, and work items.

Quick 启动 设置up npx corp 设置up

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 服务, 认证s via magic link. Self-hosted server — point to your own API server URL. Local mode (recommended for development) npx corp 设置up # choose "Local (your machine)" npx corp 状态 # 验证 — all local, no network

Cloud mode npx corp 设置up # 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 设置 API_url http://localhost:8020 --force

验证 上下文 npx corp 上下文

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

Reference Resolution

The 命令行工具 supports flexible reference 格式化s across all commands:

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

Use npx corp resolve to test resolution. Use npx corp find <查询> to 列出 matches.

Entity 格式化ion One-Shot 格式化ion (Recommended for 代理s)

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,角色=director,officer_title=ceo,is_incorporator=true,添加ress=123 MAIn St|Dover|DE|19901" \ --member "name=John Doe,emAIl=john@acme.com,角色=director,officer_title=cto,添加ress=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 格式化 with keys: name, emAIl, 角色 (director|officer|管理器|member|chAIr), officer_title (ceo|cfo|cto|coo|secretary|treasurer|president|vp|other), is_incorporator (true|false), 添加ress (street|city|状态|zip), pct (ownership %), 分享s (分享s purchased) --添加ress <添加ress> — Company 添加ress as street,city,状态,zip --fiscal-year-end — Fiscal year end (MM-DD, default "12-31") --s-corp — Elect S-Corp 状态 --transfer-restrictions — Enable transfer restrictions --rofr — Enable right of first refusal

导入ant: Member 添加resses use pipe | as separator (street|city|状态|zip), NOT commas.

Staged 格式化ion

For more control, use the staged flow:

创建 — npx corp form 创建 --type c_corp --name "Acme Inc" --jurisdiction US-DE --json 添加 Founders — npx corp form 添加-founder @last --name "Jane Doe" --emAIl jane@acme.com --角色 director --pct 100 --officer-title ceo --incorporator --添加ress "123 MAIn St,Dover,DE,19901" --json Finalize — npx corp form finalize @last --board-size 1 --company-添加ress "123 MAIn St,Dover,DE,19901" --json Activate — npx corp form activate @last --json

The activate step transitions from documents_生成d to active 状态 by auto-签名ing 格式化ion documents.

Staged 添加-founder flags:

--name (required), --emAIl (required), --角色 (required: director|officer|管理器|member|chAIr), --pct (required: ownership %) --officer-title