Skip to content

Changelog

Use this page to track what changed in Harness CLI and jump to release-related docs.

Official Release History

Latest Stable

  • 1.17.0 (2026-05-16):
  • Memo Storage: aios memo now uses a storage abstraction with two public implementations: file (default append-only JSONL at .aios/memo/file/events.jsonl) and split (one JSON file per memo event). Manage it with aios memo storage status, aios memo storage use split, aios memo storage use file, aios memo storage rebuild, and aios memo storage doctor.
  • Git-friendly memo source of truth: .aios/memo/ is the canonical project memo root. ContextDB/SQLite remain compatibility mirrors and rebuildable caches, not the memo source of truth.
  • Runtime state alignment: new ContextDB runtime state is written under .aios/context-db/; legacy memory/context-db paths are read only for compatibility when present.

  • See ContextDB for the memo storage boundary.

  • 1.13.0 (2026-05-15):

  • Context Registry (Pull-Based Context): Replaces push-based context injection (~30KB every session) with a lightweight ~350 byte registry pointer. Agents now read .aios/context-db/index.json and load only what they need. Startup drops from ~5 minutes to near-instant.
  • aios init: One-command setup for all four coding agents (Claude Code, Codex CLI, Gemini CLI, OpenCode). Detects installed agents, writes registry marker to config files, configures save guard hooks. Idempotent — safe to run multiple times.
  • Multi-client native sync fix: Gemini now writes to GEMINI.md (the file Gemini CLI actually reads). OpenCode reads AGENTS.md directly (no separate file needed). Old .gemini/AIOS.md and .opencode/AIOS.md deprecated.
  • --context-mode slim: Team/harness routes and wrapped agents automatically use slim injection when the registry marker is detected. Falls back to full injection for unwrapped agents.

  • See ContextDB for the full architecture.

  • 1.11.0 (2026-05-09):

  • debug-hub v0.3: Instrumentation tracking and automatic cleanup. New MCP tools: instrument, list_instruments, cleanup_instruments. Marker convention DH:<sessionId> for zero-dependency debug log injection with dual-mode cleanup (explicit via instrument records, discovery via workspace grep). Dry-run support for safe cleanup preview. Cross-model debug protocol via workspace memory. Replaces upstream debug skill with debug-hub skill. See debug-hub.

  • 1.10.0 (2026-05-09):

  • debug-hub v0.2: Adds automatic trace materialization (debounced), agent debugging sessions, structured evidence events, /api/health, and MCP tools for timeline, health, and compact_context. Includes input validation on HTTP endpoints, MCP argument validation, path-traversal hardening, case-insensitive search, and debounced trace indexing. See debug-hub.

  • 1.8.0 (2026-05-08):

  • Adds self-trigger harness routing for wrapped codex, claude, gemini, and opencode sessions.
  • Model Router: Intelligent multi-model dispatch for Agent Teams. Includes model capability registry (8 models), task-type to model routing, three CLI protocol adapters (claude/codex/gemini), cost-ascending fallback chains, agent-callable model-router skill, AIOS_MODEL_{ROLE} env var overrides, and perception feedback loop integration. See Model Router for full documentation.
  • GroupChat Runtime: aios team live mode now uses round-based agent execution with shared conversation history. Agents in each round run in parallel; all agents see the full accumulated thread. Blocked agents trigger automatic re-plan rounds. Contrasts with the old one-shot isolated dispatch model.
  • OpenCode CLI subagent support: opencode-cli is now a fully supported AIOS_SUBAGENT_CLIENT for all orchestration paths (subagent, team, and GroupChat runtimes).

Earlier Stable

  • 1.7.1 (2026-04-26):
  • Adds a Solo Harness release post.

  • Clarifies the existing persona/user profile memory layer (aios memo persona ..., aios memo user ...) that was previously under-documented.

  • 1.7.0 (2026-04-26):

  • Adds aios harness for single-agent overnight runs with run journals, stop/resume controls, HUD surfacing, and optional worktree isolation.
  • Adds official Solo Harness documentation across English, Chinese, Japanese, and Korean docs.

Previous Stable

  • 1.6.3 (2026-04-25):
  • Syncs the Chinese visual onboarding structure to English, Japanese, and Korean pages.

  • Rewrites localized Overview, Quick Start, scenario commands, and Agent Team pages around the same beginner-first path.

  • 1.6.2 (2026-04-25):

  • Adds visual onboarding for the official docs: beginner path, TUI Setup/Doctor, ContextDB memory loop, and Agent Team/HUD diagrams.

  • Reorients onboarding around task-first commands before advanced ContextDB, Agent Team, and orchestration concepts.

  • 1.6.1 (2026-04-25):

  • Restores the GitHub Release pipeline for clean Linux checkouts.
  • Simplifies Chinese onboarding docs so new users can find commands by task first.

Recent Versions

  • main (Unreleased):
  • debug-hub MCP-native debug log service (2026-05-06): MCP-native debug log collection for coding agents with Node.js/Browser/Go SDKs, embedded Web UI, file-based storage under ~/.debug-hub/, and 5 MCP tools for agent self-diagnosis (list_traces, get_trace, search_logs, get_stats, clear_logs); agents can now introspect their own runtime logs without human intervention
    • Agent self-trigger harness routing (2026-05-05): wrapped codex / claude / gemini / opencode sessions now advertise single/subagent/team/harness; long-running, overnight, resumable objectives can self-trigger aios harness run ... --workspace <project-root> with --max-iterations, plus env controls CTXDB_HARNESS_PROVIDER and CTXDB_HARNESS_MAX_ITERATIONS
  • Privacy Shield for wrapped coding agents (2026-04-24): interactive ContextDB shell launches now print a colored privacy panel with Privacy Guard status, custom relay/model endpoint detection, and the safe aios privacy read --file <path> path; auto prompts now clarify that LLM privacy instructions are advisory while deterministic AIOS gates provide verifiable enforcement
  • Workspace-aware routed startup + project Node selection (2026-04-23): routed ctx-agent startup now preserves the active git workspace even when launched from a non-AIOS repo; mcp-server package scripts run through scripts/with-project-node.mjs so .nvmrc / Node 24 is honored consistently, avoiding external SQLite addon ABI drift via built-in node:sqlite and surfacing a clear error when Node 24 is unavailable
  • ContextDB Shell startup optimization (2026-04-22): ctx() now prefers compiled mcp-server/dist/contextdb/cli.js over npm run -s contextdb, cutting per-call overhead from ~0.3s to ~0.06s; one-shot agent launch improved from ~2.2s to ~0.5s (~78% faster); shell-bridge detectRunner no longer requires tsx; install flow auto-builds dist/ when missing and gracefully falls back to npm-run mode on build failure
  • Default core skills update (2026-04-19): awesome-design-md, frontend-design, and cap-commit-push promoted to default core skills
  • ContextDB lazy load (2026-04-18 to 2026-04-19): interactive sessions now default to lazy context loading (CTXDB_LAZY_LOAD=on); agents self-discover memory via facade prompt instead of receiving a full context pack upfront; added lazy-load documentation and multilingual blog posts
  • AIOS workflow router skill (2026-04-18): added .claude/skills/aios-workflow-router for reliable task-to-skill routing and discovery
  • Route/concurrency docs refresh + default concurrency = 3 (2026-04-20): documented a compact profile for interactive routing and parallel settings (CTXDB_INTERACTIVE_AUTO_ROUTE, CTXDB_CODEX_DISABLE_MCP, CTXDB_TEAM_WORKERS, AIOS_SUBAGENT_CONCURRENCY); added core-overview links to the selection guide; changed live subagent runtime default concurrency from 2 to 3
  • Documentation: Agent Team & HUD (2026-04-11): Added comprehensive documentation for Team Operations - new pages Agent Team & HUD, HUD Guide, and Skill Candidates; updated Superpowers and Architecture with Team Ops references
  • Browser MCP migration to browser-use CDP (2026-04-10): default browser runtime switched from Playwright to browser-use MCP over CDP; new launcher scripts/run-browser-use-mcp.sh; migration command aios internal browser mcp-migrate; screenshot timeout guard with configurable BROWSER_USE_SCREENSHOT_TIMEOUT_MS
  • HUD/Team skill-candidate enhancements (2026-04-09 to 2026-04-10): --show-skill-candidates flag for detailed view; --skill-candidate-limit <N> configurable limit; fast-watch mode defaults to 3 candidates (down from 6); artifact reads cached for performance; HUD suggests skill-candidate apply commands; team status surfaces skill-candidate artifacts and drafts
  • Quality-gate visibility (2026-04-08 to 2026-04-09): quality-gate category surfaced in HUD minimal status and team history summaries; quality-failed-only filter; quality prefix filters with multi-value support
  • Learn-eval draft recommendations (2026-04-07 to 2026-04-09): hindsight lesson drafts; skill patch draft candidates; draft recommendation apply flow; persist skill-candidate draft artifacts
  • Turn-envelope v0 (2026-04-07): event linkage for turn-based telemetry; clarity entropy memo coverage in harness
  • Browser doctor auto-heal (2026-04-06 to 2026-04-08): doctor --fix auto-heals CDP service; setup/update lifecycle auto-heals browser doctor; CDP quick commands in docs
  • Multi-environment RL training system: shared rl-core control plane with shell, browser, and orchestrator adapters; three-pointer checkpoint lineage; four-lane replay pool; PPO + teacher distillation training
  • Mixed-environment campaigns (rl-mixed-v1): one live batch can span shell + browser + orchestrator episodes with unified rollback decision
  • ContextDB search now defaults to SQLite FTS5 + bm25(...) ranking, with automatic lexical fallback when FTS is unavailable
  • ContextDB semantic rerank now operates on query-scoped lexical candidates, reducing drops of older exact matches
  • subagent-runtime live execution for aios orchestrate (opt-in via AIOS_EXECUTE_LIVE=1)
  • bounded work-item queue scheduling with ownership hints
  • no-op fast path: auto-complete reviewer / security-reviewer when upstream handoffs touched no files
  • Windows PowerShell shell-smoke workflow on each push to main (.github/workflows/windows-shell-smoke.yml)
  • scope-aware skills install flow with global / project target selection
  • canonical skill authoring now lives in skill-sources/, with repo-local client roots generated via node scripts/sync-skills.mjs
  • default skills install mode is now portable copy; explicit --install-mode link remains available for local development
  • release packaging/preflight now validates generated skill roots with check-skills-sync
  • catalog-driven skill picker with core defaults, optional business skills, and uninstall showing installed items only
  • TUI skill picker groups entries into Core and Optional with truncated descriptions for terminal readability
  • doctor now warns when a project skill overrides a global install of the same name
  • Node runtime guidance is now explicitly aligned on Node 24 LTS
  • Ink TUI refactor (v1.1.0): full TypeScript + Ink-based TUI with React components; startup banner with REXCLI ASCII art; adaptive watch intervals; left-right option cycling; native enhancement visibility panel
  • 0.17.0 (2026-03-17):
  • TUI uninstall picker now scrolls in smaller terminals and keeps Select all / Clear all / Done anchored at the bottom
  • uninstall cursor selection now stays aligned with the rendered grouped list
  • setup/update skill pickers now label already-installed skills with (installed)
  • 0.16.0 (2026-03-10): add orchestrator agent catalog and generators
  • 0.15.0 (2026-03-10): gate live orchestrate execution behind AIOS_EXECUTE_LIVE
  • 0.14.0 (2026-03-10): add subagent-runtime runtime adapter (stub)
  • 0.13.0 (2026-03-10): externalize runtime manifest spec
  • 0.11.0 (2026-03-10): expand local orchestrate preflight coverage
  • 0.10.4 (2026-03-08): wrapper fallback for non-git workspaces and docs sync
  • 0.10.3 (2026-03-08): fix Windows cmd-backed CLI launch
  • 0.10.0 (2026-03-08): consolidate lifecycle flow into Node
  • 0.8.0 (2026-03-05): add strict Privacy Guard with Ollama support and setup integration
  • 0.5.0 (2026-03-03): ContextDB SQLite sidecar index (index:rebuild), optional --semantic search, unified ctx-agent core

2026-03-16 Operational Status

  • Continuous live samples are succeeding (dispatchRun.ok=true) with latest artifact:
  • .aios/context-db/sessions/codex-cli-20260303T080437-065e16c0/artifacts/dispatch-run-20260316T111419Z.json
  • learn-eval still recommends:
  • [fix] runbook.failure-triage (clarity-needs-input=5)
  • [observe] sample.latency-watch (avgElapsedMs=160678)
  • Timeout budgets remain unchanged while latency-watch observation continues.

Update Rule

When a release changes setup, runtime behavior, or compatibility, docs are updated in the same PR and reflected here.