🚀 v0.8.0 Nova BETA Edition

Changelog

🚀 Release v0.8.0 - Nova BETA Edition

Nova removes the limits on workflow complexity. Controllers can now run entire workflows autonomously on your behalf. Workflows pause mid-execution and resume later - even after crashes. A new import system lets you share workflows across teams. And a rebuilt terminal interface gives you real-time visibility into exactly what your agents are doing.

🚀 Major Transformations:

• Orchestration - Autonomous mode with controller agents, pause/resume, crash recovery, MCP-based agent coordination
• Context Management - Tracks, conditions, chained prompts, dynamic placeholders, hierarchical onboarding
• Workflows - Import system, modules with loop behavior, shareable packages

---

🏗️ Architecture Overhaul

From Ink/React to OpenTUI

Migrated workflow terminal rendering from Ink (React) to OpenTUI (SolidJS).

• Removed src/ui (Ink/React components)
• New component library in src/cli/tui
• State management using SolidJS signals
• New routing system for workflow views

Event Bus Architecture

The backend no longer knows about the UI. All communication flows through a typed event bus, making it possible to attach any frontend in the future.

┌─────────────┐     Events      ┌─────────────┐
│   Backend   │ ──────────────► │  Event Bus  │
│  (Workflow) │                 │   (Typed)   │
└─────────────┘                 └──────┬──────┘
                                       │
                         ┌─────────────┼─────────────┐
                         ▼             ▼             ▼
                    ┌────────┐   ┌────────┐   ┌────────┐
                    │  TUI   │   │  Web   │   │  API   │
                    │ Adapter│   │(Future)│   │(Future)│
                    └────────┘   └────────┘   └────────┘

Workflow State Management

New centralized state management coordinates all workflow execution:

• WorkflowContext - Single source of truth for execution state
• StepIndexManager - Handles step ordering, queue management, and resume logic
• StatusService - Coordinates agent status updates between database and UI
• TimerService - Unified timer that only counts when workflow is actively running (paused/idle time excluded)

Database Layer

Added SQLite database (registry.db) for execution history:

• Agent name, engine, model per execution
• Start time, end time, duration
• Status tracking (running, completed, failed, skipped, paused)
• Token usage and telemetry
• Session IDs for resume capability
• Error messages and stack traces

---

🎉 New Features

Interactive Mode

You control every step. Each agent asks questions, gathers insights, and produces output for the next agent.

• Chained Prompts - Multi-step prompts within a single agent session, each with name, description, and confirmation modal
• Steering Input - Type a message before confirming to guide the agent's next action
• Skip/Abort - Ctrl+S skips current prompt or agent, Escape shows stop confirmation
• Step-by-Step Navigation - Arrow keys to navigate timeline, Enter to expand/collapse, Space to toggle sub-agents

Autonomous Mode

Controller agent runs agents on your behalf. Brief the controller with your objective - it manages agents and makes decisions between steps.

Controller System:

• Conversation Prefixes - Both controller and step agents see input prefixes ({USER (username):} or {agent_name:}) so you can address either at any time
• Pause Anytime - Switch to manual mode mid-workflow to intervene
• Controller View - Dedicated view showing controller conversation, telemetry, engine/model info
• Recovery Flow - Resume interrupted controller sessions with full conversation history preserved

MCP-Based Coordination:
Step agents propose completion via propose_step_completion. Controller accepts or rejects via approve_step_transition. This replaces manual user confirmation.

Terminal User Interface - Complete Rebuild

Every UI component was rewritten for OpenTUI:

Views:

• Home View - Workflow selection with random slogans, import option, template picker
• Workflow View - Main execution monitoring with collapsible timeline
• Controller View - Dedicated controller conversation interface
• History View - Past executions with keyboard navigation, scroll handling, and log search
• Onboarding View - Track/condition selection with question-based flow

Components:

• Timeline Panel - Collapsible agent list with status icons, duration, expand/collapse
• Output Window - Agent output with markdown rendering, incremental loading, pagination
• Log Viewer - Full agent logs with syntax highlighting, scroll to position
• Prompt Line - Unified input for steering, chained prompts, and confirmations
• Telemetry Bar - Runtime (active time only), workflow name, status indicators
• Toast Notifications - Replaced inline log messages for cleaner output
• Confirmation Modals - Checkpoint, stop, chained prompt confirmation
• Error Modal - Clear error display with context

Agent Characters & Personas

Agents now have visual personalities:

• ASCII Art Faces - Different expressions based on activity state
• Persona System - Replaces engine-based configuration
• Activity Indicators - Animated phrases showing current action
• Dynamic Display - Character changes based on running/waiting/error state

Theme System

• Dark/Light Modes - Toggle with Ctrl+T
• Theme Context - Centralized theme handling throughout components
• Color Palette - Consistent colors across all UI elements
• Responsive Styling - Adapts to terminal width

MCP Integration - Unified Router

Replaced separate workflow-signals and agent-coordination servers with a unified MCP router:

codemachine mcp router  # Starts unified server (stdio mode)

Benefits:

• Single server handles all agent communication
• Centralized configuration per provider
• Project-level context file for multi-project support
• Global debug log path for troubleshooting

Tool Filtering

Limit which MCP tools each agent can access:

mcp: [
  {
    server: 'agent-coordination',
    only: ['run_agents', 'get_agent_status'],  // Whitelist tools
    targets: ['code-gen', 'test-runner'],       // Whitelist sub-agents
  },
]

Cross-Provider Support

MCP adapters added for all supported engines:

• Claude Code (native MCP)
• Codex
• Mistral Vibe (new adapter)
• Auggie CLI
• Cursor
• CCR (Claude Code Router)

Workflow Import System

Import workflow packages from local directories, GitHub, or any git URL.

Import Sources:

# CLI
codemachine import ./local-folder
codemachine import username/repo
codemachine import https://github.com/user/repo

# TUI
/import ./path/to/workflow
/import username/repo

Package Requirements:

my-workflow/
├── codemachine.json          # or .codemachine.json
├── config/
│   ├── main.agents.js        # Required
│   ├── sub.agents.js         # Optional
│   ├── modules.js            # Optional
│   ├── placeholders.js       # Optional
│   └── agent-characters.json # Optional
├── templates/
│   └── workflows/
│       └── *.workflow.js     # At least one required
└── prompts/                  # Optional (warning if missing)

Import Discovery:

• Sub-agents automatically discovered from import roots
• Character configs merged with local definitions
• Placeholder resolution follows import-aware paths

Track & Condition System

Tracks - Workflow variants - users pick one path during onboarding:

tracks: {
  'quick': { label: 'Quick', description: 'Fast single-step build' },
  'expert': { label: 'Expert', description: 'Guided 5-step process' },
}

Steps can be filtered by track:

resolveStep('advanced-config', { tracks: ['expert'] })

Condition Groups - Feature flags with multi-select support:

conditionGroups: [
  {
    id: 'features',
    question: 'What features do you need?',
    multiSelect: true,
    conditions: {
      'has-api': { label: 'API', description: 'REST or GraphQL' },
      'has-auth': { label: 'Auth', description: 'User authentication' },
    },
  },
]

Filtering Options:

• conditions: ['has-api', 'has-auth'] - Run when ALL conditions selected
• conditionsAny: ['has-api', 'has-auth'] - Run when ANY condition selected

Hierarchical Condition Groups - Nested conditions for complex onboarding flows.

Built-in Placeholders: - Added builtin placeholders for username, date.

Ali Workflow Builder

Built-in workflow for creating custom CodeMachine workflows. Renamed from 'builder' to 'ali'.

Expert Mode (5 Steps):

1. Brainstorming - Optional creative exploration and idea generation
2. Workflow Definition - Name, tracks, conditions, autonomous mode
3. Agents - Main agents, sub-agents, modules, controller configuration
4. Prompts - Agent prompts, chained prompts, and placeholders
5. Workflow Generation - Final files, validation, and output

Quick Mode: One-step build with all requirements gathered upfront. Best when you prioritize speed over customization.

New Features:

• Markdown table rendering for workflow visualization
• Autonomous mode configuration during creation
• Tone guidelines in prompt templates

---

🔧 Improvements

Engine & Provider Updates

Session Resuming: All engines now support session resuming for crash recovery

New Environment Variables:

• CODEMACHINE_CLAUDE_OAUTH_TOKEN - Claude Code OAuth authentication
• CODEMACHINE_ANTHROPIC_API_KEY - Direct Anthropic API access
• Auth via settings.json env vars

Credentials Watcher: Monitors for credential changes and terminates processes when authentication is invalidated.

Fallback Mechanism: When configured engine isn't authenticated, CodeMachine tries engines in order:
...

v0.7.0 - Bun Migration & OpenTUI

🚀 Release v0.7.0 - Bun Migration & OpenTUI

🚀 Major Transformations:

Complete Bun Runtime Migration: Revolutionary shift from Node.js/pnpm to Bun runtime with massive performance improvements

• 98% faster builds (114ms vs several seconds)
• 60% faster startup time (~200ms vs ~500ms)
• 50% less memory usage (~40MB vs ~80MB)
• 78% faster test execution (3s vs 14s)
• Unified runtime for development, testing, and production

Modern OpenTUI Interface: Complete terminal UI overhaul using OpenTUI/SolidJS

• Beautiful, responsive TUI with custom CodeMachine theme
• Toast notifications and dialog system
• Dual-binary architecture to prevent JSX runtime conflicts
• Fade-in animations and terminal background detection
• Improved authentication flow with TUI restart and feedback

SQLite Database Migration: Replaced JSON-based agent registry with SQLite

• Native concurrency handling (no more file locks)
• Better performance and ACID compliance
• 487 lines removed, 377 added (net simplification)
• New export command for JSON compatibility

🎉 New Features:

• Auggie CLI Engine Support: Added Auggie as a new engine provider
  • Full integration with 726 lines of new code
  • Auth, execution, and telemetry support
• Embedded Resources System: Standalone binaries with compressed embedded resources and smart caching
• Cross-Platform Binary Distribution: Automated GitHub Actions builds for Linux, macOS, and Windows
• MkDocs Documentation: Professional documentation site with CI/CD
• Abort Signal Support: Workflows can now be gracefully interrupted during execution
• Cache Token Telemetry: Better visibility into prompt caching usage

🐛 Critical Bug Fixes:

• Windows Authentication: Fixed all 5 engine providers failing on Windows by using Bun.which() to resolve .cmd files
• OpenCode Multi-Provider Auth: Fixed authentication for non-OpenCode providers (Anthropic, OpenAI, etc.) in OpenCode engine
• Stdin Data Loss: Pre-encode stdin input to prevent data loss in Bun
• Process Resolution: Proper Bun executable path resolution in child processes
• Empty Stdout Storage: Skip memory storage when stdout is empty
• Version Flag: Fixed --version flag in compiled binaries
• Windows Path Normalization: Proper path handling on Windows in dev mode
• Windows Binary Path: Fixed binary not found error due to npm hoisting optional dependencies
• Windows Package Installation: Fixed os field (windows -> win32) so npm installs the package on Windows

🔧 Improvements:

• Removed execa, cross-spawn, tsx, tsup, vitest, and node dependencies
• Native Bun.spawn() for all process operations
• Removed legacy presentation layer (simplified architecture)
• Better Ctrl+C handling with proper state management
• Improved terminal dimension handling with safety checks
• Enhanced debug logging throughout the system
• Binary auto-installation and global linking
• Update notifier system
• Dependency fixes and improvements

Thanks to all contributors who helped make this release possible: @AlexFigures, @LegendEvent, @hadywalied, and @TheMightyDman

📦 Installation:

npm install -g codemachine@0.7.0

or using Bun:

bun install -g codemachine@0.7.0

Release v0.5.0 - OpenCode Integration & Type Safety

🎉 New Features

• OpenCode CLI Integration: Added OpenCode as a first-class engine provider alongside Claude, Codex, Cursor, and CCR
  • Full registry-based provider pattern with JSON event streaming
  • Non-interactive execution via environment guardrails
  • XDG-compliant paths under OPENCODE_HOME (~/.codemachine/opencode)
  • Support for multiple authentication providers
  • Run with: codemachine opencode run or --engine opencode in workflows

🔧 Improvements

• Type Safety: Replaced 'any' types with 'unknown' and proper type guards throughout telemetry system
• Telemetry Refactoring: Implemented provider-specific telemetry parsers for better maintainability
• CCR Auth Simplification: Streamlined authentication using simple .enable marker instead of .credentials.json
• Engine Naming: Updated display names to be more descriptive (CCR → Claude Code Router, Claude → Claude Code)
• ESLint Configuration: Updated to use tseslint.config for better type safety

🐛 Fixes

• Process Cleanup: Improved child process termination with process group killing for Unix systems
• Environment Variables: Fixed OpenCode runner to properly merge process.env with provided env
• Race Conditions: Better handling of abort signals and process events

📚 Documentation

• Comprehensive updates across README, CLI reference, and workflow guides
• Added contributor credits for OpenCode integration

v0.4.3 - Enhanced UI Feedback & Loop Progress

✨ Features

• Analyzing Status Message: Added analyzing status message on Claude session initialization for better user feedback
• Loop Progress Display: Implemented loop progress with task completion status in UI for improved workflow visibility

🔧 Improvements

• Workflow Engine Configuration: Updated engine configurations in CodeMachine workflow for better performance

📦 Installation

npm install -g codemachine@0.4.3

Full Changelog: v0.4.2...v0.4.3

v0.4.2 - Bug Fixes & Model Support

✨ Features

No new features in this release

🔧 Improvements

Workflow Configuration: Updated step engines and models for better workflow execution
Agent Configuration: Removed redundant engine field from agent configs for cleaner setup
Code Organization: Removed unused imports and improved code structure
Documentation: Updated git-commit-workflow.md with additional gitignore rules

🐛 Bug Fixes

Registry Operations: Prevented race conditions in registry file handling
Registry Lock: Ensured file exists before locking to prevent corruption
Monitoring Cleanup: Fixed incorrect type usage in process.emit during cleanup

📦 Installation

npm install -g codemachine@0.4.2

v0.4.1 - Bug Fixes & Model Support

✨ Features

• Grok Model Support: Added Grok model support with improved cursor status handling
• Enhanced Monitoring: Implemented async registry operations with file locking for better process management
• Cursor Updates Check: Added support for checking cursor CLI updates

🔧 Improvements

• Agent Configuration: Removed redundant engine field from agent configs for cleaner setup
• Code Organization: Removed unused imports and improved code structure
• Documentation: Updated contextual information in runtime preparation agent for better clarity

🐛 Bug Fixes

• CCR Engine: Fixed critical bug in CCR (Claude Code Router) engine
• Monitoring Cleanup: Fixed incorrect type usage in process.emit during cleanup
• Foundation File Search: Improved foundation file search functionality

📦 Installation

npm install -g codemachine@0.4.1

Full Changelog: v0.4.0...v0.4.1

🚀 CodeMachine v0.4.0 - Smart Connected Workflows & CLI UI Revolution

🚀 CodeMachine v0.4.0 Release Notes

🌟 Major Highlights

Revolutionary UI/UX Transformation: Complete overhaul from basic CLI to an interactive, real-time monitoring dashboard with Ink-powered interface, smooth scrolling, and dynamic terminal sizing.

Smart Connected Workflows: Next-generation workflow system with intelligent agent coordination, user-centered design, and seamless UI integration throughout the execution pipeline.

Advanced Architecture Agents: Enhanced architecture system with dedicated UI/UX Designer agent and improved agent orchestration for more cohesive and intelligent project planning.

Production-Ready Monitoring: Real-time agent orchestration system with PID tracking, telemetry capture, execution history, and multi-process safety features.

---

✨ Key Features

🎯 Interactive Dashboard & Real-time Monitoring

• Live workflow execution visualization with agent status tracking
• Ink-powered terminal interface with smooth scrolling and dynamic sizing
• Timeline navigation with keyboard controls and progress indicators

🧠 Smart Connected Workflows

• User-centered workflow design with adaptive decision points
• Intelligent agent coordination with shared context and collaboration
• Connected architecture pipeline with seamless information flow

🏗️ Advanced Architecture System

• NEW: UI/UX Designer Agent for dedicated interface design
• Enhanced architecture orchestration with improved agent protocols
• Comprehensive blueprint structure with enhanced validation

🔄 Advanced Workflow Features

• Resume workflows from interruptions
• Checkpoint system for manual review stages
• Intelligent loops with iteration tracking
• UI elements integration for interactive workflows
• Fallback agents for improved reliability

🚀 CCR Engine Integration

• Complete Claude Code Router support
• Enhanced authentication handling and user guidance
• Comprehensive test suite coverage

🔧 Major Improvements

• UI Performance Revolution: Shared spinners, optimized polling, batch updates
• Smart Agent Communication: Improved inter-agent messaging and context sharing
• Enhanced System Architecture: Standardized engine configuration across all components
• Better Documentation: Comprehensive guides and enhanced templates

🐛 Bug Fixes

• Fixed UI viewport and layout issues
• Resolved agent ID mapping race conditions
• Improved process cleanup and signal handling
• Enhanced error messages and template variables
• Fixed workflow performance issues

📦 Installation

npm install -g codemachine@0.4.0

🔐 Compatibility

No breaking changes - Fully compatible with existing workflows, configurations, and templates.

---

🚀 What's New in v0.4.0

This release represents a major leap forward in intelligent workflow automation:

• User-Revolved Design: Workflows that truly understand and adapt to user needs
• Connected Intelligence: Seamless agent collaboration for coherent project execution
• UI/UX Excellence: Dedicated design agent ensuring exceptional user experience

🙏 Acknowledgments

Special thanks to all contributors who made this release possible:

• Adinda Praditya for CCR engine implementation and comprehensive testing
• Sohayb for gitignore improvements and workflow fixes
• bahyali for development tooling and UI fixes

v0.3.0 - Enhanced Workflow Management

✨ Features

• Workflow Resume Capability: Resume workflows from the last incomplete step, allowing you to pick up where you left off after interruptions
• Fallback Agent Support: Automatically handle incomplete workflow steps with fallback agents for improved reliability (30-minute timeout)
• Update Notifier: Get notified when a new version of CodeMachine is available
• Flexible Loop Triggers: Configure loop behavior with optional triggers via config file for more control over workflow execution
• Improved Workflow Execution: Enhanced workflow execution with better step tracking and progress management

🔧 Improvements

• Simplified Agent Configuration: Streamlined agent config and workflow engine settings for easier setup
• Async Loop Handling: Made loop handling asynchronous with improved error logging for better performance
• Reorganized Agent Prompts: Updated and reorganized agent prompts and workflow configuration for clarity
• Better Documentation:
  • Added comprehensive CONTRIBUTING.md with contribution guidelines
  • Improved README readability and structure
  • Added workflow and agent templates for easier customization
  • Clearer task validation output format templates
  • Added LICENSE file

🐛 Bug Fixes

• Loop Trigger: Fixed issues with loop trigger not working correctly
• Workflow Performance: Resolved very slow workflow execution
• Placeholder Error Messages: Improved error messages for placeholders to be more helpful and informative
• Template Variables: Fixed incorrect task_fallback path and template variable names

📦 Installation

npm install -g codemachine@0.3.0

v0.2.3 - Fix Profile Parameter

🐛 Bug Fixes

Fixed: Profile parameter removed from all engines

Issue: The profile parameter (e.g., --profile git-commit) was being passed through the engine system but was never actually used by any CLI commands. This was causing confusion and potential errors.

Solution: Completely removed the unused profile parameter from:

• ✅ Codex engine (commands, runner, executor)
• ✅ Claude engine (commands, runner, executor)
• ✅ Cursor engine (commands, runner, executor)
• ✅ Core engine types
• ✅ Agent execution runner
• ✅ Workflow step execution
• ✅ CLI commands
• ✅ Tests

Impact:

• Cleaner, more maintainable codebase
• Removed dead code across all engine providers
• Fixed potential configuration errors related to profile usage
• All engines now work consistently without profile parameter

---

Full Changelog: v0.2.2...v0.2.3

v0.2.2 - Better Engine CLI Detection

v0.2.2 - Better Engine CLI Detection
65ebc65

🐛 Bug Fixes

• Handle missing engine CLIs with clear guidance on Windows and Unix
  • Auth flows: cursor-agent login, codex login, claude setup-token
  • Execution runners: Cursor, Codex, Claude
• Detect platform-specific errors ("not recognized...", "command not found", ENOENT)
• Avoid confusing generic "exit code 1" errors when CLIs are absent

🔧 Improvements

• Consistent install hints pulled from engine metadata
• No behavior change when CLIs are installed and available

📦 Installation
npm install -g codemachine@0.2.2