Repository navigation
v1.0.0 — Orchestration, TUI, and Developer Memory
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-mergecan 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:
rrefresh,aapprove checkpoint,ltoggle log,qquit - 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 pipefailcompatibility throughout (grep no-match, arithmetic, trap handlers)- Loop detection via
loop-state.jsoninstead of PID - Headless dispatch (
--skip-openforwt-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/statusvia 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:managedmarkers 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
--modelflag 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