wwa-cli

One command to make your agent framework WWA-compatible.

wwa-cli generates WWA-compatible adapter code for popular agent frameworks: LangGraph, OpenAI Agents SDK, AutoGen, and CrewAI. It auto-detects your project's language (Python or TypeScript) and framework, then generates the integration layer so your agents can participate in the WWA interoperability network.

Install

npm install -g @workswithagents/wwa-cli

# or run directly without installing:
npx @workswithagents/wwa-cli init

Requires Node.js ≥ 18.

Quick Start

# In any supported agent project directory:
cd my-langgraph-agent
wwa init

That's it. wwa init will:

1. Detect your framework (LangGraph, OpenAI, AutoGen, CrewAI) and language (Python/TypeScript)
2. Generate a WWA adapter file with IACP message handler
3. Generate a manifest.yaml with capability declarations
4. Run a compliance check and show your WWA compatibility score

Commands

Command	Description
wwa init	Detect framework + language, generate WWA adapter files
wwa gen <component>	Generate a specific adapter component (handoff, manifest, identity)
wwa check [path]	Validate an existing project for WWA compliance
wwa setup <provider>	Infra setup (Phase 2 — placeholder)

wwa init options

wwa init [options]

Options:
  --project-dir <path>   Path to project directory (default: ".")
  --framework <name>     Framework override: langgraph, openai, autogen, crewai
  --agent-id <id>        Agent identifier for WWA registration
  --endpoint <host:port> IACP endpoint address (default: "0.0.0.0:8787")
  --no-register          Disable auto-registration with WWA registry
  --register-url <url>   Override registry URL
  --no-check             Skip compliance check after generation

wwa check options

wwa check [project-path] [options]

Options:
  --json                 Output as JSON

Supported Frameworks

Framework	Python	TypeScript	Adapter File
LangGraph	✅	✅ (via @langchain/langgraph)	wwa_handoff.py / wwa_handoff.ts
OpenAI Agents SDK	✅	✅	wwa_handoff.py / wwa_handoff.ts
AutoGen	✅	❌ (Python-only)	wwa_agent.py
CrewAI	✅	❌ (Python-only)	wwa_crew_adapter.py

How It Works

Architecture

wwa-cli/                     # Node.js CLI
├── src/
│   ├── cli.ts               # Commander CLI entry point
│   ├── commands/            # init, gen, check command handlers
│   ├── generators/          # Framework-specific adapters
│   │   ├── langgraph.ts     # LangGraph → WWA (Python + TS)
│   │   ├── openai_agents.ts # OpenAI Agents SDK → WWA
│   │   ├── autogen.ts       # AutoGen → WWA (Python only)
│   │   └── crewai.ts        # CrewAI → WWA (Python only)
│   ├── detectors/           # Language + framework detection
│   └── validators/          # WWA compliance checker
└── templates/               # Jinja2-style templates

Registration

By default, generated adapters auto-register with the WWA registry (https://registry.workswithagents.dev) on startup and deregister on shutdown. Control this behavior:

# Disable registration entirely
wwa init --no-register

# Override registry URL
wwa init --register-url https://my-registry.example.com

# At runtime, set env var to disable (even if compiled-in)
WWA_REGISTRY_URL="" python wwa_handoff.py

Generated Files

File	Purpose
wwa_handoff.py / .ts	HTTP server with POST /iacp/message endpoint. Handles IACP messages and routes to your framework.
wwa_agent.py	AutoGen ConversableAgent subclass that speaks IACP.
wwa_crew_adapter.py	CrewAI adapter wrapping Crew.kickoff() in an IACP listener.
manifest.yaml	Capability manifest declaring your agent's capabilities, endpoint, and registered intents.

Compliance Scoring

wwa check validates 5 spec requirements and scores your project 0–10:

• 0–3: Minimal — consider wwa init
• 4–6: Partial — missing handoff/discovery
• 7–9: Good — near WWA-compatible
• 10: Full — WWA-compatible

Checks performed:

1. ✅ Capability Manifest (manifest.yaml)
2. ✅ Identity Protocol
3. ✅ IACP Endpoint (POST /iacp/message)
4. ✅ Handoff Protocol handler
5. ⬜ Deployment Manifest (Dockerfile, docker-compose, etc.)

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Development mode (watch)
npm run dev

Roadmap

Phase 1 (current)

• CLI scaffold with Commander
• Framework + language detection
• LangGraph adapter (Python + TypeScript)
• OpenAI Agents SDK adapter (Python + TypeScript)
• AutoGen adapter (Python)
• CrewAI adapter (Python)
• wwa check compliance validator
• Auto-registration with WWA registry

Phase 2 (planned)

• Infra setup scripts (wwa setup hetzner|aws|local)
• wwa gen handoff|manifest|identity individual component generation
• Support for additional frameworks (Microsoft Agent Framework, etc.)
• Template customization (wwa init --template custom)
• CI/CD integration (GitHub Actions for compliance checks)

License

MIT — See LICENSE file.

---

Works With Agents — Building the interoperable agent economy.