Milestones

M0: Core Platform

Target: December 2025 Status: Completed (100%)

The foundational CmdForge platform with AI-powered CLI tool builder, YAML tool definitions, web UI, offline caching, and provider abstraction.

Deliverable	Status
YAML tool definition system	Done
CLI entry point and subcommands	Done
Provider abstraction layer	Done
Offline caching for tools	Done
Web UI for tool browsing	Done
Tool execution engine	Done

---

M1: Production Ready

Target: February 2026 Status: Completed (100%)

Production deployment with proper server configuration, complete documentation, and improved reliability.

Deliverable	Status
Public documentation	Done
Systemd service setup	Done
Gunicorn production server	Done
Systemd linger for persistence	Done
CI/CD pipeline	Done
Error message improvements	Done
Source field display in web UI	Done

---

M2: Tool Discovery

Target: Q2 2026 Status: Completed (100%)

Enable users to discover, rate, and share tools through a marketplace interface with curation to maintain quality.

Deliverable	Status
Tool search and filtering	Done
PySide6 GUI conversion	Done
GUI Registry browser	Done
GUI Publishing with connect flow	Done
Docker containers (test + ready)	Done
Interactive installer script	Done
Database migration system	Done
Registry curation system	Done
App pairing/connection flow	Done
Tool ratings/reviews	Done
Tool marketplace UI enhancements	Done
AI persona profiles	Done
AI-assisted code generation	Done

Tool search and filtering includes:

• /api/v1/tags endpoint for listing tags with counts
• Advanced search with tag filtering (AND logic), multi-category (OR logic), owner, download range, date range
• Faceted search responses with category/tag/owner counts
• CLI: --tag, --owner, --min-downloads, --popular, --since, --json, --show-facets options
• CLI: registry tags subcommand
• Web UI: Filter sidebar with checkboxes, dropdowns, active filter chips, URL-based state

PySide6 GUI conversion includes:

• Modern desktop GUI replacing urwid TUI
• Sidebar navigation (My Tools, Registry, Providers, Profiles)
• Tool Builder with visual form for creating/editing tools
• Keyboard shortcuts (Ctrl+N, Ctrl+S, Ctrl+R, Ctrl+1/2/3/4, Escape, Ctrl+Q)
• Window geometry persistence

GUI Registry browser includes:

• Browse/search tools with category and sort filters
• Star ratings display in table and details
• Clickable tags for filtering
• Installed indicator (✓) and update available (↑)
• Pagination for large result sets
• Publisher reputation info

GUI Publishing includes:

• Connect dialog with polling-based account pairing
• Publish workflow with version selection
• Full publish workflow with confirmation

Infrastructure improvements:

• Dockerfile.test-install: Fresh environment for testing installer
• Dockerfile.ready: Pre-installed container for quick usage
• install.sh: Interactive installer with venv, PATH setup, optional example tools
• Database migration: Auto-adds missing columns on server start

Registry curation system includes:

• Role-based access control (user, moderator, admin)
• Tool moderation workflow (pending → approved/rejected/removed)
• Publisher management (ban/unban, role changes)
• Private/unlisted tool visibility (auto-approved, owner-only access)
• Audit logging for all moderation actions
• Admin web UI pages (pending queue, publishers, reports, audit log)
• Report resolution workflow

App pairing/connection flow includes:

• cmdforge config connect <username> CLI command
• GUI Connect dialog with polling-based approval
• Web UI "Connections" page (replaces API Tokens)
• Device hostname tracking for connected apps

Tool ratings/reviews includes:

• 5-star rating system with review text
• Average rating display on tool cards
• Publisher reputation scores
• Rating count and distribution

Tool marketplace UI enhancements includes:

• Browse all tools on page load
• Category filter dropdown
• Sort by popularity, rating, newest, name
• Clickable tags for filtering
• Installed/update indicators
• Pagination controls

AI persona profiles includes:

• Profile dataclass with name, description, system_prompt
• 8 built-in profiles (Comedian, Technical Writer, Teacher, Concise, Creative, Code Reviewer, Analyst)
• Custom profile creation and storage
• Profile selector in Prompt Step dialog
• Profile injection during tool execution
• Profiles page in GUI (Ctrl+4)

AI-assisted code generation includes:

• Split-view Code Step dialog (editor + AI assist panel)
• Provider selector for AI calls
• Smart prompt template with available variables
• Background thread for non-blocking AI calls
• Automatic markdown fence stripping
• Python syntax checking before save

---

M3: Content & Automation

Target: Q3 2026 Status: Completed (100%)

Automated content ingestion and quality assurance for the tool ecosystem.

Deliverable	Status
Import Fabric patterns (233 total)	Done
Scheduled Fabric repo sync	Done
Auto-vetting pipeline integration	Done
Community tool submissions workflow	Done
Duplicate detection automation	Done

Import Fabric patterns includes:

• Run existing scripts/import_fabric.py to populate registry
• Automatic attribution with source fields (imported, MIT license, Daniel Miessler)
• Category mapping based on pattern name prefixes
• README generation with original pattern attribution

Auto-vetting pipeline includes:

• Integration with existing scrutiny.py (honesty, transparency, scope, efficiency checks)
• Integration with existing similarity.py (duplicate detection)
• Auto-approve/review/reject decision logic
• Helpful suggestions for tool improvements

Scheduled sync includes:

• Periodic checks for Fabric repo updates
• Automatic import of new patterns
• Version tracking for updated patterns
• Admin notifications for review queue

---

M4: User Experience

Target: Q4 2026 Status: Planning (0%)

Visual improvements and interactive guidance for tool creation and management.

Deliverable	Status
Visual node-based step editor	Not Started
Interactive onboarding walkthroughs	Not Started
Tool visualization improvements	Not Started
Tool composition and chaining UI	Not Started
Drag-and-drop step reordering	Not Started

Visual node-based editor includes:

• Graphical nodes for steps (like n8n, Google Sketch)
• Visual connections showing data flow between steps
• Drag-and-drop step creation
• Real-time preview of tool execution flow

Interactive walkthroughs includes:

• First-time user onboarding
• Guided tool creation tutorial
• Feature discovery tooltips
• Context-sensitive help

Tool composition UI includes:

• Visual interface for chaining tools together
• Input/output mapping between tools
• Dependency visualization
• Meta-tool builder

---

M5: Plugin System

Target: Q1 2027 Status: Planning (0%)

Extensible plugin architecture for custom backends and automated testing.

Deliverable	Status
Plugin architecture design	Not Started
Custom AI backend support	Not Started
Tool testing framework	Not Started
Tool versioning support	Not Started
Plugin marketplace	Not Started

---