corpai-cli

CLI toolkit for the CorpAI open standard — lint, visualize, and simulate AI agent organizations.

---

Install

pip install corpai

---

Commands

corpai lint — Validate role files

Checks every .md role file against the CorpAI spec: missing sections, invalid ranks, broken reporting chains, empty fields, missing escalation triggers.

corpai lint                        # validate entire org
corpai lint ./my-corpai-org        # validate a directory
corpai lint --file roles/executive/ceo.md   # single file
corpai lint --strict               # warnings become errors

✓ ceo.md
✓ cto.md
⚠ engineer.md
    WARN   No optional personality template found
✗ custom-role.md
    ERROR  Missing required section: ## Escalation Triggers
    ERROR  "Reports to" field is empty

──────────────────────────────
42 roles checked — 1 error(s), 3 warning(s)

---

corpai graph — Generate org charts

corpai graph                        # ASCII tree (default)
corpai graph --format mermaid       # Mermaid diagram
corpai graph --dept engineering     # filter to one department
corpai graph --format mermaid --output org.mmd   # save to file

└── [OWNER] OWNER  (executive)
    └── [L5] CEO  (executive)
        ├── [L5] CFO  (executive)
        │   └── [L4] Finance Director  (finance)
        │       ├── [L2] Financial Analyst  (finance)
        │       └── [L2] Auditor  (finance)
        └── [L5] CTO  (executive)
            └── [L4] Engineering Director  (engineering)
                └── [L3] Engineering Team Lead  (engineering)

---

corpai simulate — Trace message flows

Trace exactly how a TASK or ESCALATION travels through your hierarchy.

corpai simulate --from CEO --to Engineer --subject "Build auth module" --priority P2
corpai simulate --from "Support Agent" --to CEO --priority P1

╭─ CorpAI Message Simulation ───────────────────────╮
│ Subject:  Build auth module                        │
│ Type:     ↓ TASK                                   │
│ Priority: P2                                       │
│ Hops:     4                                        │
╰────────────────────────────────────────────────────╯

  Step 1  [L5] CEO  ↓ TASK  [L5] CTO
  Step 2  [L5] CTO  ↓ TASK  [L4] Engineering Director
  Step 3  [L4] Engineering Director  ↓ TASK  [L3] Engineering Team Lead
  Step 4  [L3] Engineering Team Lead  ↓ TASK  [L1] Engineer

✓ Message delivered to [L1] Engineer

---

corpai info — Org summary

corpai info

Prints role counts, departments, and rank distribution across your org.

---

corpai scaffold — Bootstrap a new role

corpai scaffold --role "Data Engineer" --dept data-ai --rank L2 --reports-to "ML Lead"

Generates a spec-compliant .md role file with all required sections pre-filled.

---

corpai init — Bootstrap a full org

corpai init --name "MyAI Corp" --output ./my-org

Generates a complete department hierarchy from the CorpAI spec template.

---

Quick Start with the CorpAI spec

git clone https://github.com/Arigitshub/CorpAI
cd CorpAI
pip install corpai

corpai lint
corpai graph
corpai simulate --from CEO --to "QA Tester" --subject "Test the release"

---

Links

• CorpAI spec repo — the open standard
• corpai-runtime — execution engine
• corpai-portal — org chart dashboard
• PyPI — package page

---

Contributing

Issues and PRs welcome at Arigitshub/corpai-cli.