MassGen Roadmap

Contents

MassGen Roadmap#

Full Roadmap#

MassGen Roadmap#

Current Version: v0.1.53

Release Schedule: Mondays, Wednesdays, Fridays @ 9am PT

Last Updated: February 18, 2026

This roadmap outlines MassGen’s development priorities for upcoming releases. Each release focuses on specific capabilities with real-world use cases.

👥 Contributors & Contact#

Want to contribute or collaborate on a specific track? Reach out to the track owners below:

Track

GitHub

Discord

Tool System Refactoring

@qidanrui

danrui2020

Multimodal Support

@qidanrui

danrui2020

General Interoperability

@qidanrui

danrui2020

RL Integration

@qidanrui @praneeth999

danrui2020, ram2561

Agent Adapter System

@Eric-Shang

ericshang.

Framework Streaming

@Eric-Shang

ericshang.

Irreversible Actions Safety

@franklinnwren

zhichengren

Computer Use

@franklinnwren

zhichengren

Memory Module

@qidanrui @ncrispino

danrui2020, nickcrispino

Rate Limiting System

@AbhimanyuAryan

abhimanyuaryan

DSPy Integration

@praneeth999

ram2561

MassGen Handbook

@a5507203 @Henry-811

crinvo, henry_weiqi

Session Management

@ncrispino

nickcrispino

Automatic MCP Tool Selection

@ncrispino

nickcrispino

Parallel File Operations

@ncrispino

nickcrispino

MassGen Terminal Evaluation

@ncrispino

nickcrispino

Textual Terminal Display

@praneeth999

ram2561

Web UI

@voidcenter

justin_zhang

For general questions, join the #massgen channel on Discord

Release

Target

Feature

Owner

Use Case

v0.1.54

02/20/26

Spec Support for Planning Mode

@ncrispino

Add spec/proposal support to planning workflows (#881)

Refactor ask_others for Targeted Agent Queries

@ncrispino

Support targeted agent queries via subagent for more efficient coordination (#809)

v0.1.55

02/22/26

Curated Recommended Models List for Quickstart Wizard

@ncrispino

Curated model recommendations in quickstart wizard (#840)

Support Dragging Screenshots into TUI Bar on Mac

@ncrispino

Enable drag-and-drop screenshot functionality in TUI input bar (#831)

v0.1.56

02/24/26

Per-agent Isolated Write Contexts During Coordination

@ncrispino

Per-agent isolated write contexts during coordination (#854)

Fix Rounds Appearing and Log Dir Content in Multi-Turn

@ncrispino

Fix round display and log directory issues in multi-turn sessions (#848)

All releases ship on MWF @ 9am PT when ready

📋 v0.1.49 - Coordination Quality: Log Analysis TUI, Fairness Gate & Checklist Voting#

Features#

1. Log Analysis Mode in TUI (@ncrispino)

  • PR: #869

  • New “Analyzing” state in TUI mode bar (Normal → Planning → Executing → Analyzing)

  • Browse and select log directories and turns directly in the TUI

  • Configurable analysis profiles for different analysis depths

  • Use Case: Analyze runs without leaving the terminal

2. Fairness Gate for Coordination (@ncrispino)

  • PR: #869

  • Prevents fast agents from dominating coordination rounds

  • Configurable fairness_lead_cap_answers and max_midstream_injections_per_round

  • Use Case: Balanced multi-agent participation regardless of agent speed

3. Checklist Voting Tool (@ncrispino)

  • PR: #869

  • New checklist_tools_server.py MCP server for structured quality evaluation

  • Binary pass/fail scoring for objective quality assessment

  • Use Case: Consistent, repeatable evaluation across coordination rounds

4. Automated Testing Infrastructure (@ncrispino)

  • PR: #869

  • CI/CD workflow (tests.yml), SVG snapshot baselines, 16+ new test files

  • Use Case: Continuous quality assurance and visual regression testing

5. Shadow Agent Bug Fix (@MuL1ian)

  • PR: #861

  • Fixed “[No response generated]” errors caused by incorrect chunk type comparison

  • Use Case: Reliable shadow agent responses

Success Criteria#

  • ✅ Fairness gate prevents fast agents from dominating

  • ✅ Checklist voting provides structured quality evaluation

  • ✅ ROI framework guides iteration decisions

  • ✅ CI/CD pipeline running with SVG snapshot baselines

  • ✅ Shadow agent responses working correctly

  • ✅ Persona easing accessible from TUI mode bar

📋 v0.1.50 - Chunked Plan Execution & Skill Lifecycle Management#

Features#

1. Chunked Plan Execution (@ncrispino)

  • PR: #877

  • Plans divided into chunks (e.g., C01_foundation) and executed one chunk at a time with progress checkpoints

  • Chunk browsing in TUI, frozen plan snapshots, target_steps/target_chunks parameters

  • Use Case: Safer long-form task completion with progress tracking

2. Iterative Planning Review Modal (@ncrispino)

  • PR: #877

  • New modal with Continue Planning / Quick Edit / Finalize Plan options

  • Use Case: Plan iteration before execution begins

3. Skill Lifecycle Management (@ncrispino)

  • PR: #878

  • New lifecycle modes (create_or_update, create_new, consolidate), skill organizer for merging overlapping skills

  • SKILL_REGISTRY.md routing guide, load_previous_session_skills config

  • Use Case: Reusable skill workflows with consolidation and previous-session loading

4. Local Skills MCP (@ncrispino)

  • PR: #878

  • New MCP tool for skill list/read access in Docker/local execution contexts

  • Use Case: Skill access without filesystem tools

5. Worktree Improvements (@ncrispino)

  • PR: #877

  • Branch accumulation across rounds, cross-agent diff visibility via generate_branch_summaries(), orphan cleanup

  • Use Case: Better worktree isolation with cross-agent visibility

6. Responsive TUI Mode Bar (@ncrispino)

  • PR: #877

  • Vertical/horizontal adaptive layout with compact labels on narrow terminals

  • Use Case: TUI usability on varying terminal sizes

Success Criteria#

  • ✅ Chunked plan execution with progress checkpoints

  • ✅ Iterative planning review modal with Continue/Edit/Finalize options

  • ✅ Skill lifecycle management with consolidation and previous-session loading

  • ✅ Responsive TUI mode bar adapting to terminal width

  • ✅ Worktree branch accumulation and cross-agent diff visibility

📋 v0.1.51 - Reviewing Coordination & Change Documents#

Features#

1. Change Documents (Changedoc) (@ncrispino)

  • PR: #896

  • Decision journals agents write in tasks/changedoc.md during coordination, capturing decision provenance, rationale, and code traceability

  • Changedocs passed to other agents in <changedoc> tags for shared decision awareness

  • Config: enable_changedoc: true (default on)

  • Use Case: Multi-agent coordination traceability with decision provenance

2. Changedoc-Anchored Evaluation Checklist (@ncrispino)

  • PR: #896

  • 5 changedoc-specific checklist items: Decision Completeness, Rationale Quality, Traceability, Output Quality, Novel Elements

  • Mandatory gap report before verdict (checklist_require_gap_report: true)

  • Use Case: Structured quality evaluation anchored to decision documents

3. Review Modal Improvements (@ncrispino)

  • PR: #896

  • Multi-context, multi-file diff visualization with critique capabilities

  • Use Case: Enhanced code review with multi-file diff support

4. Drift Conflict Policy (@ncrispino)

  • Configurable handling of target-file drift when applying isolated changes

  • drift_conflict_policy: skip|prefer_presenter|fail

  • Use Case: Safer change application when target files have been modified

5. CLI --cwd-context Flag (@ncrispino)

  • Inject CWD into context paths: ro/read for read-only, rw/write for write access

  • Equivalent to Ctrl+P in TUI

  • Use Case: Quick project context injection from CLI

Success Criteria#

  • ✅ Changedoc system captures decision provenance during coordination

  • ✅ Changedoc-anchored evaluation checklist with gap reports

  • ✅ Review modal supports multi-file diffs

  • ✅ Drift conflict policy prevents unsafe change application

  • ✅ --cwd-context CLI flag injects project context

📋 v0.1.52 - Final Answer Modal & Coordination Quality Gates#

Features#

1. Dedicated Final Answer Modal (@ncrispino)

  • PR: #901

  • Tabbed modal with Answer tab (markdown content, post-evaluation, file list) and Workspace/Review Changes tab (diff review)

  • Trophy header with agent identity and model name

  • Approve/Reject/Cancel action bar with rework controls for iteration

  • Use Case: Structured final answer review with clear approve/reject workflow

2. Substantive Gate (@ncrispino)

  • PR: #901

  • Quality gate preventing coordination from continuing with only incremental changes

  • Tracks transformative/structural/incremental classification

  • Detects decision_space_exhausted for convergence

  • Config: require_substantiveness: true (mandatory in checklist)

  • Use Case: Prevent low-value iteration rounds that waste compute

3. Novelty Injection (@ncrispino)

  • PR: #901

  • Creative pressure injection when agents converge or stall

  • Levels: none (default), gentle, moderate, aggressive

  • Intensifies after restarts

  • Config: novelty_injection in coordination section

  • Use Case: Combat premature convergence by introducing creative diversity

4. Agent Identity & Versioning (@ncrispino)

  • PR: #901

  • Unique agent identity with versioned answer labels (e.g., agent1.2)

  • answer_label_mapping for provenance tracking

  • Use Case: Track which agent produced which answer version

5. Subagent Evaluation Infrastructure (@ncrispino)

  • PR: #901

  • Foundation for delegating evaluation to spawned subagent instances

  • Use Case: Scalable evaluation through delegation

6. First Answer Non-Restart (@ncrispino)

  • PR: #901

  • First answer from each agent no longer triggers automatic restarts even if quality checks fail

  • Use Case: More natural coordination flow without unnecessary early restarts

Success Criteria#

  • ✅ Final answer modal with tabbed Answer/Review Changes interface

  • ✅ Substantive gate prevents low-value iteration rounds

  • ✅ Novelty injection combats premature convergence

  • ✅ Agent identity versioning tracks answer provenance

  • ✅ First answer non-restart enables natural coordination flow

📋 v0.1.53 - Background Tool Execution#

Features#

1. Background Tool Execution (@ncrispino)

  • PR: #917

  • Non-blocking lifecycle tools: start_background_tool, get_background_tool_status, get_background_tool_result, wait_for_background_tool, cancel_background_tool, list_background_tools

  • Compatible with custom tools and MCP server tools

  • Use Case: Agents continue foreground work while long-running tools execute in the background

2. Planning Task Verification (@ncrispino)

  • PR: #917

  • Tasks now require verification and verification_method fields by default

  • --no-require-verification flag to opt out; framework-injected tasks exempt

  • Use Case: Ensure every planned task has clear verification criteria

3. TUI Background Job Indicators (@ncrispino)

  • PR: #917

  • Agent status ribbon with background job indicators

  • Background tasks modal with lifecycle controls

  • Use Case: Visual feedback for background tool execution in the terminal UI

4. Subagent Infrastructure (@ncrispino)

  • PR: #917

  • Groundwork for specialized subagent types: Evaluator and Explorer definitions via SUBAGENT.md frontmatter

  • Tool argument normalization for consistent handling across backends

  • Use Case: Foundation for specialized subagent types (maturing in future releases)

Success Criteria#

  • ✅ Background tool lifecycle (start, monitor, wait, cancel, list) working

  • ✅ Planning tasks require verification fields by default

  • ✅ TUI background job indicators and modal controls

  • ✅ Subagent type infrastructure (Evaluator, Explorer)

📋 v0.1.54 - Spec Support for Planning & Targeted Agent Queries#

Features#

1. Spec Support for Planning Mode (@ncrispino)

  • Issue: #881

  • Add spec/proposal support to planning workflows

  • Use Case: Structured specification creation and review during planning mode

2. Refactor ask_others for Targeted Agent Queries (@ncrispino)

  • Issue: #809

  • Support targeted queries to specific agents via subagent spawning

  • Three modes: broadcast to all, selective broadcast with per-agent prompts, targeted ask about past answer

  • Pass full _streaming_buffer to shadow agents for improved context

  • Use Case: More efficient coordination by querying specific agents rather than broadcasting to all

Success Criteria#

  • ✅ Spec support integrated into planning workflows

  • ✅ Targeted ask_others(target_agent_id="Agent-1", question="...") working

  • ✅ Selective broadcast with agent_prompts dict functional

  • ✅ Improved context passing via streaming buffer

📋 v0.1.55 - Quickstart Model Curation & TUI Screenshots#

Features#

1. Curated Recommended Models List for Quickstart Wizard (@ncrispino)

  • Issue: #840

  • Curated model recommendations in quickstart wizard

  • Use Case: Better first-run experience with recommended model selections

2. Support Dragging Screenshots into TUI Bar on Mac (@ncrispino)

  • Issue: #831

  • Enable drag-and-drop screenshot functionality in TUI input bar

  • Use Case: Quick image sharing for multimodal agent coordination

Success Criteria#

  • ✅ Curated model list displayed in quickstart wizard

  • ✅ Drag-and-drop screenshots into TUI input bar working on Mac

📋 v0.1.56 - Per-agent Isolated Write Contexts & Multi-Turn Fixes#

Features#

1. Per-agent Isolated Write Contexts During Coordination (@ncrispino)

  • Issue: #854

  • Per-agent isolated write contexts during coordination

  • Use Case: Each agent gets its own isolated write context during coordination rounds

2. Fix Rounds Appearing and Log Dir Content in Multi-Turn (@ncrispino)

  • Issue: #848

  • Fix round display and log directory content issues in multi-turn sessions

  • Use Case: Correct round tracking and log organization across turns

Success Criteria#

  • ✅ Per-agent write contexts properly isolated during coordination

  • ✅ Rounds display correctly in multi-turn sessions

  • ✅ Log directory content correct across turns

🔨 Ongoing Work & Continuous Releases#

These features are being actively developed on separate parallel tracks and will ship incrementally on the MWF release schedule:

Track: Agent Adapter System (@Eric-Shang, ericshang.)#

  • PR: #283

  • Unified agent interface for easier backend integration

  • Shipping: Continuous improvements

Track: Irreversible Actions Safety (@franklinnwren, zhichengren)#

  • Human-in-the-loop approval system for dangerous operations

  • LLM-based tool risk detection

  • Target: v0.1.3 and beyond

Track: Multimodal Support (@qidanrui, danrui2020)#

  • PR: #252

  • Image, audio, video processing across backends

  • Shipping: Incremental improvements each release

Track: Memory Module (@qidanrui, @ncrispino, danrui2020, nickcrispino)#

  • Issues: #347, #348

  • Short and long-term memory implementation with persistence

  • Status: ✅ Completed in v0.1.5

Track: Agent Task Planning (@ncrispino, nickcrispino)#

  • Agent task planning with dependency tracking

  • Status: ✅ Completed in v0.1.7

Track: Automation & Meta-Coordination (@ncrispino, nickcrispino)#

  • LLM agent automation with status tracking and silent execution

  • MassGen running MassGen for self-improvement workflows

  • Status: ✅ Completed in v0.1.8

  • Case Study: Meta-level self-analysis demonstrating automation mode (meta-self-analysis-automation-mode.md)

Track: DSPy Integration (@praneeth999, ram2561)#

  • Question paraphrasing for multi-agent diversity

  • Semantic validation and caching system

  • Status: ✅ Completed in v0.1.8

Track: Framework Streaming (@Eric-Shang, ericshang.)#

  • PR: #462

  • Real-time streaming for LangGraph and SmoLAgent intermediate steps

  • Enhanced debugging and monitoring for external framework tools

  • Status: ✅ Completed in v0.1.10

Track: Rate Limiting System (@AbhimanyuAryan, abhimanyuaryan)#

  • PR: #383

  • Multi-dimensional rate limiting for Gemini models

  • Model-specific limits with sliding window tracking

  • Status: ✅ Completed in v0.1.11

Track: MassGen Handbook (@a5507203, @Henry-811, crinvo, henry_weiqi)#

  • Issue: #387

  • Comprehensive user documentation and handbook at https://massgen.github.io/Handbook/

  • Centralized policies and resources for development and research teams

  • Status: ✅ Completed in v0.1.10

Track: Computer Use (@franklinnwren, zhichengren)#

  • PR: #402

  • Browser and desktop automation with OpenAI, Claude, and Gemini integration

  • Visual perception through screenshot processing and action execution

  • Status: ✅ Completed in v0.1.9

Track: Session Management (@ncrispino, nickcrispino)#

  • PR: #466

  • Complete session state tracking and restoration

  • Resume previous MassGen conversations with full context

  • Status: ✅ Completed in v0.1.9

Track: Semtools & Serena Skills (@ncrispino, nickcrispino)#

  • PR: #515

  • Semantic search capabilities via semtools (embedding-based similarity)

  • Symbol-level code understanding via serena (LSP integration)

  • Package as reusable skills within MassGen framework

  • Status: ✅ Completed in v0.1.12

Track: System Prompt Architecture (@ncrispino, nickcrispino)#

  • PR: #515

  • Complete refactoring of system prompt assembly

  • Hierarchical structure with improved LLM attention management

  • Skills system local execution support

  • Status: ✅ Completed in v0.1.12

Track: Multi-Agent Computer Use (@franklinnwren, zhichengren)#

  • PR: #513

  • Enhanced Gemini computer use with Docker integration

  • Multi-agent coordination for computer automation

  • VNC visualization and debugging support

  • Status: ✅ Completed in v0.1.12

Track: Code-Based Tools System / Automatic MCP Tool Selection (@ncrispino, nickcrispino)#

  • Issue: #414

  • Tool integration via importable Python code instead of schema-based tools

  • MCP server registry with auto-discovery

  • Reduces token usage through on-demand tool loading

  • Status: ✅ Completed in v0.1.13

Track: NLIP Integration (@praneeth999, @qidanrui, ram2561, danrui2020)#

  • PR: #475

  • Natural Language Integration Platform for advanced tool routing

  • Multi-backend support across Claude, Gemini, and OpenAI

  • Per-agent and orchestrator-level configuration

  • Status: ✅ Completed in v0.1.13

Track: Parallel Tool Execution (@praneeth999, ram2561)#

  • PR: #520

  • Configurable concurrent tool execution across all backends

  • Model-level and local execution controls

  • Asyncio-based scheduling with semaphore limits

  • Status: ✅ Completed in v0.1.14

Track: Gemini 3 Pro Support (@ncrispino, nickcrispino)#

  • PR: #530

  • Full integration for Google’s Gemini 3 Pro model

  • Function calling support with parallel tool capabilities

  • Status: ✅ Completed in v0.1.14

Track: Parallel File Operations (@ncrispino, nickcrispino)#

  • Issue: #441

  • Increase parallelism of file read operations

  • Standard efficiency evaluation and benchmarking methodology

  • Status: ✅ Completed in v0.1.14

Track: Persona Generation System (@ncrispino, nickcrispino)#

  • PR: #547

  • Automatic generation of diverse system messages for multi-agent configurations

  • Multiple generation strategies: complementary, diverse, specialized, adversarial

  • Status: ✅ Completed in v0.1.15

Track: Docker Distribution Enhancement (@ncrispino, nickcrispino)#

  • PR: #545, #538

  • GitHub Container Registry integration with ARM support

  • MassGen pre-installed in Docker images for immediate use

  • Status: ✅ Completed in v0.1.15

Track: Launch Custom Tools in Docker (@ncrispino, nickcrispino)#

  • Issue: #510

  • Enable custom tools to run in isolated Docker containers

  • Security isolation and portability for custom tool execution

  • Status: ✅ Completed in v0.1.15

Track: MassGen Terminal Evaluation (@ncrispino, nickcrispino)#

  • Issue: #476

  • PR: #553

  • Self-evaluation and improvement of frontend/UI through terminal recording

  • Automated video generation and case study creation using VHS

  • Status: ✅ Completed in v0.1.16

Track: LiteLLM Cost Tracking Integration (@ncrispino, nickcrispino)#

  • Issue: #543

  • PR: #553

  • Accurate cost calculation using LiteLLM’s pricing database

  • Integration with LiteLLM pricing for 500+ models with auto-updates

  • Status: ✅ Completed in v0.1.16

Track: Memory Archiving System (@ncrispino, nickcrispino)#

  • PR: #555

  • Persistent memory with multi-turn session support

  • Memory archiving for session persistence and continuity

  • Status: ✅ Completed in v0.1.16

Track: MassGen Self-Evolution Skills (@ncrispino, nickcrispino)#

  • Issue: #476

  • Four new skills for MassGen to develop and maintain itself

  • Self-documenting release workflows and configuration generation

  • Status: ✅ Completed in v0.1.16

Track: Improve Consistency of Memory & Tool Reminders (@ncrispino, nickcrispino)#

  • Issue: #537

  • Enhance consistency of memory retrieval across agents

  • Improve tool reminder system for better agent awareness

  • Standardize memory access patterns

  • Status: ✅ Completed in v0.1.16

Track: Textual Terminal Display (@praneeth999, ram2561)#

  • Issue: #539

  • PR: #482

  • Rich terminal UI using Textual framework with dark/light themes

  • Enhanced visualization for multi-agent coordination

  • Status: ✅ Completed in v0.1.17

Track: Broadcasting to Humans/Agents (@ncrispino, nickcrispino)#

  • Issue: #437

  • PR: #569

  • Enable agents to broadcast questions when facing implementation uncertainties

  • Human-in-the-loop and agent-to-agent communication for clarification

  • Status: ✅ Completed in v0.1.18

Track: Claude Advanced Tooling (@praneeth999, ram2561)#

  • PR: #568

  • Programmatic tool calling from code execution sandbox

  • Server-side tool search with deferred loading

  • Status: ✅ Completed in v0.1.18

Track: LiteLLM Integration & Programmatic API (@ncrispino, nickcrispino)#

  • PR: #580

  • MassGen as a LiteLLM custom provider with MassGenLLM class

  • New run() and build_config() functions for programmatic execution

  • NoneDisplay for silent output in programmatic/LiteLLM use

  • Status: ✅ Completed in v0.1.19

Track: Claude Strict Tool Use & Structured Outputs (@praneeth999, ram2561)#

  • PR: #572

  • enable_strict_tool_use config flag with recursive schema patching

  • output_schema parameter for structured JSON outputs

  • Status: ✅ Completed in v0.1.19

Track: Gemini Exponential Backoff (@praneeth999, ram2561)#

  • PR: #576

  • Automatic retry mechanism for rate limit errors (429, 503)

  • Jittered exponential backoff with Retry-After header support

  • Status: ✅ Completed in v0.1.19

Track: CUA Dockerfile / Auto Docker Setup (@franklinnwren, zhichengren)#

  • Issue: #552

  • Automatic Docker container setup for Computer Use Agent

  • Auto-detection of CUA configs with automatic container creation

  • Status: ✅ Completed in v0.1.20

Track: Web UI (@voidcenter, justin_zhang)#

  • PR: #588

  • Browser-based real-time visualization for multi-agent coordination

  • FastAPI server with WebSocket streaming and React frontend

  • Status: ✅ Completed in v0.1.20

Track: Response API Formatter Enhancement (@praneeth999, ram2561)#

  • Improved function call handling for multi-turn contexts

  • Preserves function_call entries and generates stub outputs

  • Status: ✅ Completed in v0.1.20

Track: Computer Use Documentation (@franklinnwren, zhichengren)#

  • Issue: #562

  • Comprehensive documentation for computer use workflows

  • Environment naming conventions and automatic setup instructions

  • Status: ✅ Completed in v0.1.20

Track: Graceful Cancellation (@ncrispino, nickcrispino)#

  • PR: #596

  • Ctrl+C saves partial progress during multi-agent coordination

  • Session restoration for incomplete turns with --continue

  • Multi-turn mode returns to prompt instead of exiting

  • Status: ✅ Completed in v0.1.21

Track: Shadow Agent Architecture (@ncrispino, nickcrispino)#

  • PR: #600

  • Shadow agents for non-blocking broadcast responses

  • Full context inheritance (conversation history + current turn)

  • Parallel spawning with asyncio.gather()

  • Status: ✅ Completed in v0.1.22

Track: Web UI Automation Mode (@voidcenter, @ncrispino, justin_zhang, nickcrispino)#

  • PR: #607

  • Automation-friendly Web UI view with status header and session polling

  • LOG_DIR and STATUS path output for programmatic monitoring

  • Session persistence API for completed sessions

  • Status: ✅ Completed in v0.1.23

Track: Multi-Turn Cancellation Improvements (@ncrispino, nickcrispino)#

  • PR: #608

  • Flag-based cancellation handling in multi-turn mode

  • Terminal state restoration after Rich display cancellation

  • Cancelled turns build proper history entries with partial results

  • Status: ✅ Completed in v0.1.23

Track: Docker Container Persistence (@ncrispino, nickcrispino)#

  • Commit: 34279c88

  • SessionMountManager for pre-mounting session directories to Docker containers

  • Eliminates container recreation between turns (sub-second vs 2-5 second transitions)

  • Status: ✅ Completed in v0.1.23

Track: Turn History Inspection (@ncrispino, nickcrispino)#

  • Commits: 028f591d, 477423a6

  • New /inspect command for reviewing agent outputs from any turn

  • /inspect all to list all turns with summaries

  • Interactive menu for viewing agent outputs, final answers, and coordination logs

  • Status: ✅ Completed in v0.1.23

Track: Async Execution Consistency (@ncrispino, nickcrispino)#

  • PR: #608

  • New run_async_safely() helper for nested event loop handling

  • Fixed mem0 adapter async lifecycle issues

  • Status: ✅ Completed in v0.1.23

Track: Enhanced Cost Tracking (@ncrispino, nickcrispino)#

  • Expanded token counting and cost calculation across multiple providers

  • Real-time token usage for OpenRouter, xAI/Grok, Gemini, Claude Code backends

  • Per-agent token breakdown with cost inspection command

  • Status: ✅ Completed in v0.1.24

Track: UI-TARS Backend Support (@franklinnwren, zhichengren)#

  • PR: #584

  • New backend for ByteDance’s UI-TARS-1.5-7B model for GUI automation

  • OpenAI-compatible API via HuggingFace Inference Endpoints

  • Tool implementation with Docker and browser automation examples

  • Status: ✅ Completed in v0.1.25

Track: Evolving Skill Creator System (@ncrispino, nickcrispino)#

  • PR: #629

  • Framework for creating and iterating on reusable workflow plans

  • Skills capture steps, Python scripts, and learnings through iteration

  • Support for loading skills from previous sessions

  • Status: ✅ Completed in v0.1.25

Track: Textual Terminal Display Enhancement (@praneeth999, ram2561)#

  • PR: #589

  • Adaptive layout management for different terminal sizes

  • Enhanced dark/light themes with modals and panels

  • Improved agent coordination visualization

  • Status: ✅ Completed in v0.1.25

Track: Shadow Agent Response Depth (@ncrispino, nickcrispino)#

  • PR: #634

  • Test-time compute scaling via response_depth parameter (low/medium/high)

  • Controls solution complexity in shadow agent broadcast responses

  • Status: ✅ Completed in v0.1.26

Track: Docker Diagnostics Module (@ncrispino, nickcrispino)#

  • PR: #634

  • Comprehensive Docker error detection with platform-specific resolution

  • Distinguishes binary not installed, daemon not running, permission denied, images missing

  • Status: ✅ Completed in v0.1.26

Track: Web UI Setup System (@ncrispino, nickcrispino)#

  • PR: #634

  • Guided first-run setup with SetupPage, ConfigEditorModal, CoordinationStep

  • API key management endpoints and environment checks

  • Status: ✅ Completed in v0.1.26

Track: Multimodal Backend Integration (@ncrispino, @qidanrui, nickcrispino, danrui2020)#

  • Commits: 598a32f8, dc920078

  • Native multimodal understanding for Gemini and OpenAI backends

  • Image, audio, video understanding via read_media with backend-native APIs

  • Status: ✅ Completed in v0.1.28

Track: Multimodal Generation Consolidation (@ncrispino, nickcrispino)#

  • Commit: dc920078

  • Unified generate_media tool with provider selection

  • New generation/ module for OpenAI (DALL-E, Sora, TTS), Google (Imagen, Veo), OpenRouter

  • Status: ✅ Completed in v0.1.28

Track: Web UI Artifact Previewer (@ncrispino, @voidcenter, nickcrispino, justin_zhang)#

  • Commit: 598a32f8

  • Preview workspace artifacts directly in web interface

  • Support for PDF, DOCX, PPTX, XLSX, images, HTML, SVG, Markdown, Mermaid

  • Status: ✅ Completed in v0.1.28

Track: Minimum Answers Before Voting (@ncrispino, nickcrispino)#

  • Commit: bc7881d2

  • New min_answers_before_voting orchestrator configuration option

  • Integrated into CLI quickstart wizard and Web UI CoordinationStep

  • Status: ✅ Completed in v0.1.28

Track: Azure OpenAI Workflow Fixes (@AbhimanyuAryan, abhimanyuaryan)#

  • Commit: c71094ac

  • Parameter filtering for unsupported Azure parameters

  • Fixed tool_choice handling, message validation, and response format extraction

  • Status: ✅ Completed in v0.1.28

Track: OpenRouter Tool-Capable Model Filtering (@shubham2345)#

  • Commit: 40acf82c

  • Model list filters to only show models supporting tool calling

  • Checks supported_parameters for “tools” capability

  • Status: ✅ Completed in v0.1.28

Track: Subagent System (@ncrispino, nickcrispino)#

  • PR: #690

  • Spawn parallel child MassGen processes for independent task execution

  • Process isolation with independent workspaces per subagent

  • New spawn_subagents tool with result aggregation and token tracking

  • Status: ✅ Completed in v0.1.29

Track: Async Subagent Execution (@ncrispino, @HenryQi, nickcrispino, henry_weiqi)#

  • PR: #801

  • Linear: MAS-214

  • Background subagent execution with async_=True parameter

  • Poll for subagent completion and retrieve results

  • Status: ✅ Completed in v0.1.41

Track: TUI Visual Redesign (@ncrispino, @praneeth999, nickcrispino, ram2561)#

  • PR: #806

  • Comprehensive visual overhaul with modern “Conversational AI” aesthetic

  • Rounded corners, desaturated colors, edge-to-edge layouts, polished modals

  • Human Input Queue for injecting messages to agents mid-stream

  • Status: ✅ Completed in v0.1.42

Track: AG2 Single-Agent Coordination Fix (@db-ol)#

  • PR: #804

  • Fixed coordination issues for single-agent AG2 setups

  • Single agent can now vote for itself after producing its first answer

  • Status: ✅ Completed in v0.1.42

Track: Tool Call Batching (@ncrispino, nickcrispino)#

  • PR: #815

  • Consecutive MCP tool calls grouped into collapsible tree views

  • Shows 3 items by default with “+N more” indicator, click to expand

  • Respects Timeline Chronology Rule: tools only batch when consecutive

  • New ToolBatchCard widget and ToolBatchTracker state machine

  • Status: ✅ Completed in v0.1.43

Track: Interactive Case Studies & Documentation (@franklinnwren, zhichengren)#

  • PR: #812

  • New documentation page with visual SVG comparisons (MassGen vs single-agent)

  • Video tutorials section with Getting Started and Development videos

  • Iterative refinement examples showing multi-round improvements

  • Status: ✅ Completed in v0.1.43

Track: TUI UX Polish (@ncrispino, nickcrispino)#

  • PR: #815

  • Final presentation display fix (reasoning vs answer separation)

  • Plan mode enhancements with PlanOptionsPopover

  • Quoted path support for paths with spaces

  • Various bug fixes (status bar, scrolling, mode buttons)

  • Status: ✅ Completed in v0.1.43

Track: Tool Metrics Distribution Statistics (@ncrispino, nickcrispino)#

  • Commit: 30aca047

  • Enhanced get_tool_metrics_summary() with per-call averages

  • Output distribution stats (min/max/median) for bottleneck analysis

  • Status: ✅ Completed in v0.1.29

Track: CLI Per-Agent System Messages (@ncrispino, nickcrispino)#

  • Commit: 78177372

  • New mode for assigning different system messages per agent in quickstart

  • Options: “Skip”, “Same for all”, “Different per agent”

  • Status: ✅ Completed in v0.1.29

Track: OpenAI Responses API Fixes (@ncrispino, nickcrispino)#

  • PR: #685

  • Fixed duplicate item errors when using previous_response_id

  • Preserved function call ID for proper reasoning item pairing

  • Status: ✅ Completed in v0.1.29

Track: OpenRouter Web Search Plugin (@shubham2345)#

  • PR: #693

  • Native web search integration via OpenRouter’s plugins array

  • Maps enable_web_search to {"id": "web"} plugin format

  • Status: ✅ Completed in v0.1.30

Track: Persona Generator Diversity Modes (@ncrispino, nickcrispino)#

  • PR: #699

  • Two diversity modes: perspective (values/priorities) and implementation (solution types)

  • Phase-based adaptation with softened personas for convergence

  • Status: ✅ Completed in v0.1.30

Track: Azure OpenAI Multi-Endpoint Support (@AbhimanyuAryan, abhimanyuaryan)#

  • PR: #698

  • Support both Azure-specific and OpenAI-compatible endpoints

  • Environment variable expansion (${VAR}) in config files

  • Status: ✅ Completed in v0.1.30

Track: Test Suite Fixes (@maxim-saplin)#

  • PR: #688

  • Comprehensive test fixes with xfail registry

  • Fixed persistent memory retrieval and backend tool registration

  • Status: ✅ Completed in v0.1.30

Track: Logfire Observability Integration (@ncrispino, nickcrispino)#

  • PR: #708

  • Comprehensive structured logging and tracing via Logfire (Pydantic team)

  • Automatic LLM instrumentation for OpenAI, Anthropic Claude, and Google Gemini backends

  • Tool execution tracing with timing metrics and agent coordination observability

  • Enable via --logfire CLI flag or MASSGEN_LOGFIRE_ENABLED=true environment variable

  • Status: ✅ Completed in v0.1.31

Track: Azure OpenAI Native Tool Call Streaming (@AbhimanyuAryan, abhimanyuaryan)#

  • PR: #705

  • Tool calls accumulated and yielded as structured tool_calls chunks

  • Fixed streaming behavior for Azure OpenAI tool calling

  • Status: ✅ Completed in v0.1.31

Track: OpenRouter Web Search Logging (@shubham2345)#

  • PR: #704

  • Fixed logging output for web search operations

  • Status: ✅ Completed in v0.1.31

Track: Session Export Multi-Turn Support (@ncrispino, nickcrispino)#

  • PR: #715

  • Enhanced massgen export with turn range selection and workspace options

  • Multi-turn file collection preserving turn/attempt structure

  • Status: ✅ Completed in v0.1.32

Track: Logfire Optional Dependency (@AbhimanyuAryan, abhimanyuaryan)#

  • PR: #711

  • Moved Logfire from required to optional [observability] extra

  • Helpful error message when --logfire used without Logfire installed

  • Status: ✅ Completed in v0.1.32

Track: Per-Attempt Logging (@ncrispino, nickcrispino)#

  • Commit: a808d730

  • Separate log files per orchestration restart attempt

  • Handler reconfiguration via set_log_attempt() function

  • Status: ✅ Completed in v0.1.32

Track: Office Document PDF Conversion (@ncrispino, nickcrispino)#

  • Commit: 7c7a32e3

  • Automatic DOCX/PPTX/XLSX to PDF conversion for session sharing

  • Docker + LibreOffice headless conversion with image fallback

  • Status: ✅ Completed in v0.1.32

Track: Reactive Context Compression (@ncrispino, nickcrispino)#

  • Issue: #617

  • PR: #697

  • Automatic context compression when context length errors are detected

  • Streaming buffer system for compression recovery

  • Status: ✅ Completed in v0.1.33

Track: Backend Model List Auto-Update (@ncrispino, nickcrispino)#

  • Issue: #645

  • PR: #669

  • Native model listing APIs for providers (Groq, Together, and others)

  • Research third-party wrappers; document manual update processes

  • Status: ✅ Completed in v0.1.34

Track: OpenAI-Compatible Chat Server (@maxim-saplin)#

  • Issue: #628

  • PR: #689

  • Run MassGen as an OpenAI-compatible API server

  • Status: ✅ Completed in v0.1.34

Track: Code-Based Tools in Web UI (@ncrispino, nickcrispino)#

  • Issue: #612

  • Ensure code-based tools work properly in Web UI

  • Integration with new Web UI features

  • Status: ✅ Completed in v0.1.34

Track: Test MassGen for PPTX Slides (@ncrispino, nickcrispino)#

  • Issue: #686

  • Verify and improve PPTX generation capabilities

  • Test slide generation workflows and output quality

  • Status: ✅ Completed in v0.1.34

Track: OpenRouter Tool-Use Model Filtering (@shubham2345)#

  • Issue: #647

  • Restrict OpenRouter model list to only show models that support tool use

  • Filter based on supported_parameters capability checks

  • Status: ✅ Completed in v0.1.34

Track: OpenAI Responses /compact Endpoint (@ncrispino, nickcrispino)#

  • Issue: #739

  • Use OpenAI’s native /compact endpoint instead of custom summarization

  • Leverage API-level context compression for better efficiency

  • Status: ✅ Completed in v0.1.48

Track: Improve Logging (@ncrispino, nickcrispino)#

  • Issue: #683

  • PR: #761

  • Enhanced logging for better debugging and observability via Logfire workflow attributes

  • New massgen logs analyze CLI command with self-analysis mode

  • Status: ✅ Completed in v0.1.35

Track: Add Model Selector for Log Analysis (@ncrispino, nickcrispino)#

  • Issue: #766

  • Allow users to choose which model to use for massgen logs analyze self-analysis mode

  • Configurable model selection for different analysis requirements

  • Status: ✅ Completed in v0.1.50

Track: General Hook Framework (@ncrispino, nickcrispino)#

  • Issue: #745

  • PR: #769

  • Extensible hook system for agent lifecycle events

  • Enable custom actions at key orchestration points

  • Status: ✅ Completed in v0.1.36

Track: Plan and Execute Workflow (@ncrispino, nickcrispino)#

  • PR: #794

  • Complete plan-then-execute workflow separating “what to build” from “how to build it”

  • --plan-and-execute and --execute-plan CLI options

  • Task verification workflow with verified status and verification groups

  • Plan storage system in .massgen/plans/ with frozen snapshots

  • Status: ✅ Completed in v0.1.39

Track: Improve Log Sharing and Analysis (@ncrispino, nickcrispino)#

  • Issue: #722

  • Enhanced log sharing workflows

  • Improved analysis tools and visualizations

  • Target: v0.1.50+

Track: Claude Code Plugin for MassGen Agents (@ncrispino, nickcrispino)#

  • Issue: #773

  • Plugin/extension for spawning MassGen agents directly from Claude Code interface

  • Seamless integration with Claude Code workflows

  • Target: v0.1.50+

Track: Refactor ask_others for Targeted Agent Queries (@ncrispino, nickcrispino)#

  • Issue: #809

  • Support targeted queries to specific agents via subagent spawning

  • Three modes: broadcast to all, selective broadcast, targeted ask

  • Pass full _streaming_buffer to shadow agents for improved context

  • Target: v0.1.52

Track: Decomposition Coordination Mode (@ncrispino, nickcrispino)#

  • PR: #858

  • New coordination mode that decomposes tasks into subtasks assigned to individual agents

  • Task decomposer with presenter agent role for final synthesis

  • TUI mode bar toggle, subtask assignment display, and generation modals

  • Status: ✅ Completed in v0.1.48

Track: Worktree Isolation (@ncrispino, nickcrispino)#

  • PR: #857

  • Linear: MAS-272

  • Git worktree-based isolation for agent file writes with review workflow

  • Review modal for approving/rejecting changes before applying to original paths

  • Shadow repo support for non-git directories

  • Status: ✅ Completed in v0.1.48

Track: Quickstart Wizard Docker Setup (@ncrispino, nickcrispino)#

  • PR: #857

  • Linear: MAS-267

  • Docker setup step in quickstart wizard with animated pull progress

  • Real-time stdout streaming for image downloads

  • Status: ✅ Completed in v0.1.48

Track: Fairness Gate for Coordination (@ncrispino, nickcrispino)#

  • PR: #869

  • Prevents fast agents from dominating coordination rounds

  • Configurable fairness_lead_cap_answers and max_midstream_injections_per_round

  • Status: ✅ Completed in v0.1.49

Track: Persona Easing TUI Integration (@ncrispino, nickcrispino)#

  • PR: #869

  • Persona easing toggle now accessible from TUI mode bar

  • Status: ✅ Completed in v0.1.49

Track: Checklist Voting Tool (@ncrispino, nickcrispino)#

  • PR: #869

  • New checklist_tools_server.py MCP server for structured quality evaluation

  • Binary pass/fail scoring for objective quality assessment

  • Status: ✅ Completed in v0.1.49

Track: Log Analysis Mode in TUI (@ncrispino, nickcrispino)#

  • PR: #869

  • New “Analyzing” state in TUI mode bar for in-app run analysis

  • Configurable analysis profiles with log directory and turn selection

  • Status: ✅ Completed in v0.1.49

Track: Automated Testing Infrastructure (@ncrispino, nickcrispino)#

  • PR: #869

  • CI/CD workflow (tests.yml), SVG snapshot baselines, 16+ new test files

  • Testing strategy specification and visual regression testing

  • Status: ✅ Completed in v0.1.49

Track: Shadow Agent Chunk Type Fix (@MuL1ian)#

  • PR: #861

  • Fixed “[No response generated]” errors from incorrect chunk type comparison

  • Status: ✅ Completed in v0.1.49

Track: Chunked Plan Execution (@ncrispino, nickcrispino)#

  • PR: #877

  • Plans divided into chunks executed one at a time with progress checkpoints

  • Chunk browsing in TUI, frozen plan snapshots, target_steps/target_chunks parameters

  • Iterative planning review modal with Continue/Edit/Finalize options

  • Status: ✅ Completed in v0.1.50

Track: Skill Lifecycle Management (@ncrispino, nickcrispino)#

  • PR: #878

  • New lifecycle modes (create_or_update, create_new, consolidate)

  • Skill organizer for merging overlapping skills, SKILL_REGISTRY.md routing guide

  • Previous-session skill loading with load_previous_session_skills config

  • Local Skills MCP for Docker/local execution contexts

  • Status: ✅ Completed in v0.1.50

Track: Worktree Improvements (@ncrispino, nickcrispino)#

  • PR: #877

  • Branch accumulation across rounds, cross-agent diff visibility via generate_branch_summaries()

  • Orphan worktree cleanup

  • Status: ✅ Completed in v0.1.50

Track: Responsive TUI Mode Bar (@ncrispino, nickcrispino)#

  • PR: #877

  • Vertical/horizontal adaptive layout with compact labels on narrow terminals

  • TUI homescreen and theming improvements

  • Status: ✅ Completed in v0.1.50

Track: Coding Agent Enhancements (@ncrispino, nickcrispino)#

  • PR: #251

  • Enhanced file operations and workspace management

  • Shipping: Continuous improvement

🎯 Long-Term Vision (v0.2.0+)#

Advanced Orchestration Patterns

  • Advanced task decomposition strategies and parallel coordination

  • Assignment of agents to specific tasks and increasing of diversity

  • Improvement in voting as tasks continue

Self-Learning & Adaptation

  • Agents learn from past executions to improve future performance

  • Automatic skill acquisition from successful task completions

  • Feedback loops for continuous improvement

  • Memory systems for retaining learned patterns across sessions

Visual Workflow Designer

  • No-code multi-agent workflow creation

  • Drag-and-drop agent configuration

  • Real-time testing and debugging

Enterprise Features

  • Role-based access control (RBAC)

  • Audit logs and compliance reporting

  • Multi-user collaboration

  • Advanced analytics and cost tracking

Additional Framework Integrations

  • LangChain agent support

  • CrewAI compatibility

  • Custom framework adapters

Complete Multimodal Pipeline

  • End-to-end audio processing (speech-to-text, text-to-speech)

  • Video understanding and generation

  • Advanced document processing (PDF, Word, Excel)

🔗 GitHub Integration#

Track development progress:

🤝 Contributing#

Interested in contributing? You have two options:

Option 1: Join an Existing Track

  1. See Contributors & Contact table above for active tracks

  2. Contact the track owner via Discord to discuss your ideas

  3. Follow CONTRIBUTING.md for development process

Option 2: Create Your Own Track

  1. Have a significant feature idea? Propose a new track!

  2. Reach out via the #massgen channel on Discord

  3. Work with the MassGen dev team to integrate your track into the roadmap

  4. Become a track owner and guide other contributors

See CONTRIBUTING.md for development setup, code standards, testing, and documentation requirements.

See Also#

—

Contents