Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Development Roadmap

v0.1.0 — Foundation (current)

  • Core iteration engine (init, verify, guard, decide, log)
  • State machine with typed transitions
  • TSV results + JSON state persistence
  • Git rollback (revert + hard-reset)
  • Noise-aware scalar verification repeats with aggregation
  • 12 subcommands with full reference docs
  • Exec mode for CI/CD
  • 11 hook handlers
  • Claude Code plugin + Codex skill
  • Codex plugin package + local marketplace entry
  • Thin Codex skill router with detailed binary operations in references
  • Escalation protocol (refine → pivot → search → stop)
  • Lessons log with search

v0.2.0 — Background Mode + Parallel Experiments

  • Background runtime artifacts + detached Codex launch control (autoresearch runtime start/status/supervise/stop)
  • Background supervisor recommendation (autoresearch runtime supervise) with iteration cap, criteria, stop-condition, soft-blocker, and stagnation decisions
  • Background supervisor relaunch loop that automatically executes recommended relaunches (autoresearch runtime run)
  • Parallel batch templates (autoresearch parallel template) for editable worker result JSON
  • Parallel worker preparation (autoresearch parallel prepare) with branch-backed git worktrees, prompts, manifest, and batch file
  • Parallel worker launch (autoresearch parallel run) for prepared codex exec workers, including timeout/crash recording
  • Parallel batch closeout (autoresearch parallel closeout) with cherry-pick, post-merge verify/guard, fallback, worker audit rows, and one authoritative retained-state update
  • Parallel cleanup (autoresearch parallel cleanup) for worker worktrees and branches
  • Experiment branching — each trial on its own git branch
  • Branch merge strategy selection (fast-forward, squash, rebase)
  • autoresearch watch — tail results in real-time
  • Progress websocket for real-time monitoring
  • Improved evals: statistical significance testing on parallel results

v0.3.0 — Web Search + MCP Integration

  • Built-in web search escalation (configurable provider command)
  • MCP tool server mode — expose autoresearch as an MCP tool
  • MCP client mode — call external MCP tools during iteration
  • Structured search queries from escalation context
  • Search result caching to avoid redundant queries
  • autoresearch search — standalone web search for the current problem

v0.4.0 — Multi-Repo + Workspace Support

  • Workspace-owned artifacts (autoresearch-results/) and repo-local pointers for managed repos
  • Companion repo registration through --companion-repo-scope PATH=SCOPE
  • Companion repo preflight, health, and runtime dirty-worktree safeguards
  • Cross-repo change execution and rollback across companion repos
  • Workspace-aware scope expansion (monorepo package boundaries)
  • Cross-repo guard command presets
  • Native environment probe command for CPU, disk, container, toolchain context, and init metadata
  • Shared lessons across repos in a workspace

v1.0.0 — Stable API + Ecosystem

  • Stable CLI API — semver guarantees on commands, flags, and output formats
  • Native plan command for repo-aware launch config suggestions
  • Native debug generator for hypothesis-driven investigation bundles
  • Native fix generator for one-error-at-a-time repair-plan bundles
  • Native improve artifact bundle for research findings, ranked plan, TSV, summary, and handoff
  • Native PRD generator for selected improve-mode ideas
  • Native security generator for STRIDE + OWASP audit bundles
  • Native ship generator for 8-phase checklist bundles
  • Native scenario generator for 12-dimension edge-case artifacts
  • Native predict generator for five-persona review artifacts
  • Native reason generator for adversarial candidate debate artifacts
  • Native probe generator for eight-persona constraint artifacts
  • Native learn generator for documentation summary artifacts
  • Adaptive eval checkpoint command for long-running loops
  • Native protocol re-anchor command for long-running Codex sessions
  • Plugin system — loadable mode definitions (TOML or YAML)
  • Plugin marketplace — community-contributed modes
  • Configuration file (.autoresearch.toml) for project-level defaults
  • Shell completions (bash, zsh, fish, elvish, PowerShell)
  • Man pages generation
  • Pre-built binaries for Linux (x86_64, aarch64), macOS (x86_64, aarch64), Windows
  • Homebrew formula and cargo-binstall support
  • Comprehensive documentation site
  • GitHub Action for autoresearch in CI
  • Metric history graphing (sparklines in terminal)
  • Cost tracking — estimate token/API spend per iteration
  • A/B experiment mode — compare two approaches head-to-head
  • Interactive TUI dashboard for monitoring runs
  • VS Code extension for run visualization with source installer support

Future Ideas (unscheduled)

  • Re-check upstream autoresearch projects before the next feature milestone