Claudio CLI

0.1.65 verified Thu Apr 23 auth: no javascript

Claudio CLI is an AI-powered development platform that leverages existing Claude Code subscriptions to orchestrate development pipelines directly from the terminal. Operating in an active open beta (version 0.1.65 for the Darwin x64 binary), it emphasizes frequent updates and rapid iteration. Its release cadence is fast, with improvements shipped daily, reflecting its beta status. Key differentiators include a no-API-key-management model, leveraging a flat subscription instead of per-token billing, which contrasts with traditional per-token AI developer tools. It specializes in orchestrating entire development workflows, from initial planning to merging GitHub Pull Requests, rather than just one-off prompts. It offers advanced features such as multi-stage feature pipelines (PM, Designer, Dev, Review, QA, Merge), a "Quiet Mode" for local development without GitHub interaction, a "Launch Pad" for managing in-flight work, a "Doctor" tool for comprehensive UI design critiques and aesthetic rewrites, and the ability to scaffold fresh projects end-to-end. This provides a comprehensive, integrated terminal experience for AI-assisted development.

Common errors

error claudio-cli: command not found ↓

cause The `claudio-cli` tool is not installed globally or is not included in the system's PATH environment variable.

fix

Run npm install -g claudio-cli@latest (or pnpm add -g claudio-cli@latest, yarn global add claudio-cli@latest) to install the CLI globally and ensure it's in your PATH.

error GitHub authentication failed ↓

cause Claudio requires authentication with GitHub for its operations (e.g., creating PRs), and this process failed during setup or a subsequent run.

fix

Run claudio-cli again and follow the on-screen prompts to re-authenticate with GitHub. Ensure your local gh CLI (GitHub CLI) is properly configured and authenticated as Claudio leverages it.

error Error: Claude Code subscription not found or inaccessible ↓

cause Claudio operates on top of an existing Claude Code subscription, which was either not detected, expired, or inaccessible through the linked GitHub account.

fix

Verify your Claude Code subscription status and ensure it is active and correctly linked to the GitHub account used for authentication. Consult Claudio documentation for troubleshooting subscription linkage.

Warnings

gotcha Claudio is in active open beta; expect frequent updates, rough edges, and fast iteration. APIs and features may change without warning, potentially requiring adjustments to usage patterns or automation scripts. ↓

fix Regularly consult the official documentation or release notes for updates and potential breaking changes. Back up important configurations or workflows.

breaking As a beta product, internal APIs and command structures are subject to change. Updates may introduce breaking changes to how tasks are defined, configured, or integrated into existing developer workflows. ↓

fix Pin to specific minor versions during development and test thoroughly before upgrading to newer releases. Monitor the project's GitHub repository for issue reports or discussions on upcoming changes.

gotcha The CLI integrates directly with GitHub to create PRs, manage code, and potentially sensitive operations. Ensure proper security practices and understand the permissions granted to Claudio. ↓

fix Review the GitHub permissions requested by Claudio during authentication. Use dedicated GitHub accounts or tokens with scoped permissions for automated workflows, if applicable.

Install

npm install claudio-cli-darwin-x64

yarn add claudio-cli-darwin-x64

pnpm add claudio-cli-darwin-x64

Quickstart

Demonstrates how to invoke the `claudio-cli` binary programmatically from a Node.js environment to start a task.

import { exec } from 'child_process';

// This quickstart demonstrates how to programmatically interact
// with the `claudio-cli` binary from a Node.js environment.
// The `claudio-cli-darwin-x64` package provides the platform-specific
// binary for `claudio-cli`, which must be installed globally first:
// npm install -g claudio-cli@latest

console.log('Starting Claudio CLI task...');

exec('claudio-cli one-shot --task "Implement a simple user authentication flow"', (error, stdout, stderr) => {
  if (error) {
    console.error(`exec error: ${error}`);
    return;
  }
  console.log(`stdout: ${stdout}`);
  if (stderr) {
    console.error(`stderr: ${stderr}`);
  }
  console.log('Claudio CLI task initiated successfully.');
  console.log('Monitor the terminal for interactive prompts or TUI output from Claudio.');
  // The actual output and interaction happen in the terminal
  // where Claudio-cli runs, this simply kicks off the process.
  // For tasks involving GitHub, ensure your 'gh' CLI is authenticated.
});