Skip to content

v1.0.0 — Orchestration, TUI, and Developer Memory

Choose a tag to compare

@tatargabor tatargabor released this 28 Feb 14:27
· 2650 commits to main since this release

wt-tools v1.0.0

109 commits since v0.2.7. Major release — the toolkit graduates from worktree management to a full autonomous agent orchestration platform.

Highlights

Orchestration Engine (wt-orchestrate) — NEW

Autonomous multi-change execution from a specification document. Give it a spec, and it decomposes into independent changes, builds a dependency DAG, dispatches each to its own worktree with a Ralph loop — all running in parallel.

  • Spec-driven input — accepts any specification document (--spec) or structured project brief
  • LLM-powered planning — Claude decomposes specs into sized changes (S/M/L) with dependency graph
  • Parallel execution — dispatches up to N changes simultaneously (--max-parallel)
  • Merge queue — automatic merge with conflict detection, test verification, and rollback
  • Phase support — large specs split into phases with auto-replan advancing between them
  • Auto-replan — when all changes complete or fail, automatically re-plans with updated context
  • Quality gates — build verification, code review, scope overlap detection
  • LLM merge conflict resolution — wt-merge can now resolve conflicts using Claude
  • Time limits — 5-hour default safety net, configurable via --time-limit
  • Crash recovery — resume from state files after interruption
  • Checkpoint/approve — human review gates at configurable intervals
  • Active time tracking — pauses timer when loops are stalled or waiting for tokens
  • Memory integration — orchestrator recalls relevant context and saves insights
  • Max replan retry — prevents infinite replan loops (cap at 3 consecutive failures)

Orchestrator TUI — NEW

Live terminal dashboard for monitoring orchestration runs.

  • Real-time change table with status, iteration, tokens, quality gates
  • Log panel with color-coded ERROR/WARN/INFO
  • Keyboard shortcuts: r refresh, a approve checkpoint, l toggle log, q quit
  • Cursor position preserved across auto-refresh (3s interval)

Multi-Account Usage Display — NEW

Manage N Claude accounts with stacked progress bars showing hourly and daily burn rate.

Project Health Scanner (wt-audit) — NEW

Evidence-based project health scanning with interactive gap remediation.

Orchestration Fixes (30+)

  • Robust JSON parser for LLM plan output (handles backticks, code fences, partial JSON)
  • set -euo pipefail compatibility throughout (grep no-match, arithmetic, trap handlers)
  • Loop detection via loop-state.json instead of PID
  • Headless dispatch (--skip-open for wt-new)
  • Agent-assisted merge rebase with context passthrough
  • Auto-sync worktree with main before build retry
  • Stalled loop auto-resume
  • Merge retry cap (5 attempts) with auto-stash of generated files
  • Proper exit on all-work-complete
  • Base build cache invalidation after merge
  • Novelty check against state (not old plan)
  • Handle null API responses in usage display

Developer Memory Improvements

  • Mid-session saves — checkpoint every 15 turns + commit-save on git commit
  • Git sync — wt-memory sync push/pull/status via orphan branch with dedup
  • Memory integration in orchestrator — recall + timing + periodic audit
  • Raw conversation filter improvements (from v0.2.7)
  • Fix: UTF-8 surrogate errors blocking extraction for non-ASCII content
  • Fix: set -e + (( count++ )) killing background transcript extraction

GUI & Control Center

  • Compact dual-stripe usage bars (halved height)
  • Time label shows remaining time only
  • Color stripe visibility fix (gray → blue)
  • Updated screenshots and animated GIF

Claude Code Integration

  • Modernized config: rules, agents, optimized hooks
  • wt-tools:managed markers for generated CLAUDE.md sections
  • Deploy hooks upgrade path for Write/Edit PostToolUse matchers
  • Activity hook PATH migration
  • Auto-commit after apply
  • Configurable model prefix for router-agnostic model resolution
  • Explicit --model flag for Ralph loops

Documentation

  • Orchestration architecture diagram (PCB-style, 5-layer flow + appendix board)
  • Orchestrator TUI and workspace screenshots
  • Updated README with orchestration section, TUI screenshot, feature comparison table

Full changelog: v0.2.7...v1.0.0