@openplaybooks/converge

CLI for Converge — the canonical npm package for the converge command.

This is the standalone CLI package and the recommended global install target. For the programmatic library, see @openplaybooks/converge-core.

Installation

npm install -g @openplaybooks/converge

Usage

# Initialize project
converge init

# Run workflows
converge run

# Show status
converge status

# Get help
converge --help

Commands

Workflow Execution

converge run [filter]              # Run autonomous agent loop
converge run --step                # Run one task then stop
converge run --dry                 # Dry run (plan only)
converge run --force               # Force re-run completed tasks
converge run --max-iterations 50   # Limit iterations

Project Management

converge init                      # Initialize new project
converge status [filter]           # Show project status
converge verify                    # Verify project structure
converge plan "prompt"             # Generate playbook from prompt

Inspection & Debugging

converge inspect [--task taskId]   # Inspect execution sessions
converge show journal              # Show execution history
converge show gantt                # Show Gantt chart
converge show graph                # Show dependency graph
converge metrics                   # Show cost and token metrics

Task Management

converge reset <taskId...>         # Reset task(s) for re-execution
converge reset --all               # Reset entire project
converge goals                     # Evaluate project goals

Path-Based Execution

Run commands directly on specific files:

converge path/to/project.yml run
converge path/to/playbook.yml status
converge path/to/TASK.md inspect

Configuration

Create .converge/project.yml:

version: 2
name: my-app
description: My autonomous AI project

runtime:
  maxIterations: 100
  
ai:
  provider: anthropic
  model: claude-3-5-sonnet-20241022

Documentation

• Getting Started
• CLI Reference
• Core Library

Architecture

This package owns the converge binary and depends on @openplaybooks/converge-core for runtime functionality. The core library can be used independently for programmatic access.

@openplaybooks/converge (CLI)
    ↓
@openplaybooks/converge-core (Library)
    ↓
Your Application

License

MIT