Roadmap

CLEO development roadmap and future direction

Roadmap

CLEO is actively developed with a focus on improving AI-agent workflows and multi-session orchestration. This roadmap outlines our current priorities and future direction.

Current Version: v0.55.0 | View Changelog

Vision

CLEO aims to be the definitive task management system for AI-assisted development workflows, providing:

• Bulletproof data integrity through anti-hallucination validation
• Seamless multi-agent coordination with session isolation
• Context-aware orchestration that respects LLM token limits
• Skills-based extensibility for custom workflows

Current Release Highlights (v0.55.x)

Skills System

Agent Skills format with ct-* prefixed skills for epic architecture, research, validation, and more

Context Monitoring

Real-time context window tracking with automatic alerts at threshold crossings

Research Subagent Protocol

Structured research output format with MANIFEST.jsonl for efficient subagent coordination

Multi-Session Support

Epic-bound sessions with scope isolation for parallel agent work

Planned Features

Near-Term (Next 2-3 Releases)

Multi-Session Improvements

• Enhanced scope conflict detection and resolution
• Session handoff protocols for agent transitions
• Improved session-aware command context
• Session metrics and analytics

Skills System Expansion

• Additional skills for common development workflows
• Skill chaining and composition
• Custom skill creation tooling
• Skills marketplace/registry

Documentation Platform

• Mintlify-powered documentation site
• Interactive command reference
• Video tutorials and walkthroughs
• Improved API documentation

Claude Code Plugin

• Native Claude Code integration
• Slash commands for common operations
• Session lifecycle hooks
• Auto-discovered skills

Medium-Term

1. Orchestration Platform

   Deterministic Python-based routing for LLM agent workflows with verification gates and templated prompts

2. Visual Task Management

   Terminal UI (TUI) for visual task organization, dependency graphs, and progress tracking

3. Multi-Agent Sync Adapters

   Agent-agnostic sync framework supporting Claude Code, Gemini CLI, Codex CLI, and other AI agents

Long-Term Vision

• NEXUS Agent Protocol: Standardized specification for LLM agent behavior and communication
• Distributed Orchestration: Cloud-based coordination for team workflows
• Analytics Dashboard: Insights into development velocity and patterns

How to Influence the Roadmap

Feature Requests

Have an idea for CLEO? We welcome feature requests through GitHub Issues.

Submit a Request

1. Check existing issues for duplicates
2. Create a new issue with the Feature Request template
3. Include:
   • Problem description
   • Proposed solution
   • Use case / real-world scenario
   • Alternatives considered

Vote on Features

• React with :+1: on issues you want prioritized
• Add comments with additional use cases
• Share context about your workflow needs

Bug Reports

Found a bug? Help us fix it quickly with a detailed report.

1. Reproduce

   Confirm you can reproduce the issue consistently

2. Gather Info

   Collect: OS, Bash version (bash --version), jq version (jq --version), CLEO version (cleo version)

3. Submit

   Create an issue with steps to reproduce, expected vs actual behavior, and relevant logs

Release Philosophy

CLEO follows semantic versioning with frequent minor releases:

Version Type	Frequency	Content
Patch (x.x.X)	Weekly	Bug fixes, documentation
Minor (x.X.0)	Bi-weekly	New features, enhancements
Major (X.0.0)	As needed	Breaking changes (rare)

Breaking changes are extremely rare and always accompanied by migration guides and deprecation warnings in prior releases.

Get Involved

Contribute

Submit code, docs, or tests

Report Issues

Help us improve quality

Discussions

Ask questions, share ideas