۞ PAI CLI

The official PAI Universe CLI — manage, deploy, and verify agents from your terminal.

pai is the developer command-line interface for the PAI ecosystem. Create agents, deploy SAAM blueprints, run cognitive rehearsals, route models via Al-Mizan, and verify credentials — all from one CLI.

pai <command> [options]

Commands:
  create <name>     Create a new PAI agent project
  saam <action>     Manage SAAM blueprints (init | deploy)
  rehearse <name>   Run cognitive pre-simulation
  deploy            Deploy to Cloudflare Workers
  verify <did>      Verify a W3C DID credential
  almizan <model>   Route a model through Al-Mizan

---

❯ Installation

npm install -g @pai/cli

# Or run directly
npx @pai/cli create my-first-agent

---

❯ Quick Start

# Initialize a SAAM blueprint
pai saam init my-saam-agent

# Run cognitive rehearsal
pai rehearse my-saam-agent

# Deploy (zero cost)
pai deploy

# Verify an agent passport
pai verify did:axiom:pi:test-uid

---

❯ Commands Reference

Command	Action	Description
pai create	Scaffold	Generates a new agent project with pai-saam.jsonc
pai saam init	Blueprint	Creates declarative SAAM blueprint (4-layer stack)
pai saam deploy	Deploy	One-click deploy to Workers + Vercel
pai rehearse	Simulate	4-persona cognitive pre-simulation pipeline
pai deploy	Ship	Deploys agent to production
pai verify	DID check	Validates a W3C DID credential
pai almizan	Route	Routes a model through the tri-regional arbiter

---

❯ Source

File	Role
bin/pai.js	CLI entry point
src/cli.ts	All command definitions & logic

---

❯ Related

• pai-list/pai-agent-kit — Agent runtime
• pai-list/pai-mcp — MCP gateway
• pai-list/pai-rehearse — Simulation engine

---

❯ License

MIT © PAI Ecosystem

---

From terminal to agent in one command.