claudio-cli

0.1.69 verified Mon Apr 27 auth: no javascript

Claudio is a plug-and-play AI dev platform running on top of Claude Code. It orchestrates multi-stage pipelines (PM, Designer, Dev, Review, QA, Merge) that produce real GitHub PRs instead of chat transcripts. Version 0.1.69 is in open beta with frequent updates. Key differentiators: no API key management (uses existing Claude Code subscription), flat subscription pricing, quiet mode for local-only work, and a TUI-based workflow manager. The package claudio-cli-darwin-arm64 is an auto-installed binary dependency for macOS ARM64.

Common errors

error Error: Cannot find module 'claudio-cli-darwin-arm64' ↓

cause Incomplete install or missing platform binary

fix

Reinstall with: pnpm add -g claudio-cli@latest

error gh: not found ↓

cause GitHub CLI not installed

fix

Install gh from https://cli.github.com/ and authenticate with 'gh auth login'

error Error: You must have an active Claude Code subscription ↓

cause Claude Code package not installed or not authenticated

fix

Run: pnpm add -g @anthropic-ai/claude-code; then authenticate via npx claude-code

Warnings

breaking Open beta: API may change without notice; expect breaking changes between minor versions. ↓

fix Pin to a specific version in CI; check changelog before updating.

gotcha Requires a Claude Code subscription (npm package @anthropic-ai/claude-code); no free tier. ↓

fix Ensure you have an active Claude Code subscription via npm login.

gotcha GitHub CLI (gh) must be installed and authenticated; process fails silently otherwise. ↓

fix Install gh and run 'gh auth login' before using claudio-cli.

deprecated Automatic install of platform-specific binaries (claudio-cli-darwin-arm64) may break on new OS versions. ↓

fix If binary fails to run, try reinstalling with 'pnpm add -g claudio-cli@latest'.

Install

npm install claudio-cli-darwin-arm64

yarn add claudio-cli-darwin-arm64

pnpm add claudio-cli-darwin-arm64

Imports

cli
wrong
```
const cli = require('claudio-cli')
```
correct
```
import cli from 'claudio-cli'
```
ESM-only; claudio-cli is a CLI tool, not a library, so import is only for internal use.

runPipeline

wrong

const { runPipeline } = require('claudio-cli')

correct

import { runPipeline } from 'claudio-cli'

Named export available for programmatic use; ESM-only.

Task
```
import type { Task } from 'claudio-cli'
```
TypeScript type; import type to avoid runtime errors in strict mode.

Quickstart

Install the global CLI and run it to start interactive setup with guided authentication.

pnpm add -g claudio-cli@latest
claudio-cli
# On first run, the CLI walks you through GitHub and Claude Code auth.