workflow.ts, steps.ts, types.ts, prompts, scenarios, traces, cost data — no scattering across folders. Describe what you want in plain English, and Claude Code writes correct, idiomatic Output code. The plugin gives it deep knowledge of the framework’s conventions, patterns, and common mistakes.
Installing the Plugin
When you create a new project withnpx @outputai/cli init, the plugin is installed automatically. You’re ready to go.
To update it alongside your CLI:
What the Plugin Gives Claude Code
The Output plugin isn’t a wrapper around a few CLI commands. It’s a comprehensive system with 3 slash commands, 5 specialized agents, and 32 skills that give Claude Code expert-level knowledge of the Output framework. When you start a Claude Code session in an Output project, the plugin loads automatically. It injects the full framework context — every convention, every pattern, every rule — so Claude Code understands Output from the first message.Slash Commands
In practice, you rarely need to type these directly — Claude Code picks the right skill or command based on what you ask in plain English. But it’s useful to know what’s available so you understand what’s happening under the hood.Specialized Agents
The plugin includes 5 expert agents that Claude Code delegates to automatically based on what you’re asking.Skills
Skills are the building blocks that power the commands and agents — 32 in total across five categories:- Development — Creates every file type in an Output project with correct patterns, imports, and conventions
- Workflow operations — Run, start, check status, retrieve results, list workflows
- Monitoring and debugging — Analyze traces, check service health, identify failure patterns
- Error diagnosis — Six skills for the most common mistakes: wrong
zodimports, non-determinism in workflows, try-catch swallowing retries, missing schemas, direct I/O in workflow functions, usingaxios/fetchinstead of@outputai/http - Credentials — Initialize encrypted stores, edit secrets, wire to environment variables
What Gets Enforced
The plugin enforces Output’s conventions so you don’t accidentally create patterns that break in production:- Import
zfrom@outputai/core, never fromzoddirectly - All I/O goes in steps, never in workflow functions
- Use
@outputai/httpfor HTTP calls, notaxiosorfetch - Use
@outputai/llmfor LLM calls, not provider libraries directly - ES module imports always use
.jsextensions - Every step and workflow has input and output schemas
- Prompt templates use Liquid.js syntax, not Handlebars
- Don’t wrap step calls in try-catch (it swallows the retry logic)
Want to dive deeper?
You can see all skills, agents, commands, and hooks here in our repo.What’s Next
Learning Path
Learning Path. A structured guide through the rest of the documentation.
Workflows
Workflows. Deep dive into workflow structure, patterns, and orchestration.