v0.14.0

Release Notes (v0.13 → v0.14)

🎉 New Features

Aggressive Parallelization for Complex Issues (#1018)

• Complex issues now execute implementation steps in parallel waves by default, dramatically reducing completion time
• The planner agent uses contract-based parallelism — when two steps share a type or interface, it defines the contract in both and runs them concurrently instead of sequentially
• Compile errors between parallel steps are expected and handled gracefully; a post-wave validation checkpoint verifies the integrated result before moving on

Background Workflow Agents (#1020)

• All phase agents (enhancer, analyzer, planner, implementer, artifact reviewer) now run in the background by default, freeing the orchestrator context window for ongoing conversation
• Code reviewer remains in foreground as it requires direct tool access

Smart Rebase/Merge Strategy (#1017)

• il rebase and il finish now automatically detect when rebasing would be problematic and fall back to merging from the parent branch instead
• Triggers when the loom branch already has merge commits from the parent, or when more than 20 commits would be rebased (configurable via rebase.maxCommitsForRebase)

Swarm Epic Completion Reports (#934)

• When a swarm finishes, iloom now generates a structured epic report summarizing what each child agent did, posted as a comment on the epic issue
• Gives reviewers a single place to understand the full scope of parallel work

Authenticated Image Support in Linear Issues (#1005)

• Images embedded in Linear issues (uploads.linear.app) and GitHub user-attachments are now automatically downloaded, cached, and made viewable by agents
• Previously, agents couldn't see authenticated images — now they can analyze screenshots, mockups, and diagrams attached to issues

Draft PR Body with Issue Context (#954)

• Draft PRs created by il start now include the issue title and body in structured format, giving reviewers immediate context without switching to the issue tracker

Configurable Default Labels (#990)

• New issueManagement.github.defaultLabels and issueManagement.jira.defaultLabels settings automatically apply labels to issues created by iloom agents

Configurable Effort Levels (#959)

• --effort flag (low/medium/high/max) on il start, il spin, and il plan controls how deeply agents reason through each phase
• Per-agent effort overrides and separate swarmEffort settings for swarm mode

Cross-Repo Epic Planning (#1008)

• il plan now guides you through decomposing work that spans multiple repositories, coordinating via shared contracts rather than cross-repo blocking dependencies

Docker Dev Server Detection (#964)

• il init detects Dockerfiles and offers to configure Docker-based dev servers automatically

Code Review Fix Tracking (#961)

• New fix recap entry type creates a clear audit trail from review finding to resolution in the loom recap

Dev Server Restart Key (#955)

• The [r] key in the TUI dev server now actually restarts the server (previously displayed but non-functional)

Docker Runtime Environment Variables (#935)

• New dockerRunEnv setting and --env CLI flag for passing environment variables to Docker containers

🐛 Bug Fixes

Draft PR Finish Flow (#1019)

• il finish now handles closed issues gracefully when the loom has a draft PR, and skips straight to cleanup when the draft PR is already merged

Settings Validation (#1014, #1015)

• Global settings with partial configs (e.g., shared API token without team ID) are no longer incorrectly rejected
• Full Claude model IDs like claude-opus-4-6[1m] are now accepted in settings

PR Finish on Linear/Jira Projects (#983)

• il finish <pr-number> now works correctly on projects using Linear or Jira for issue tracking

Rebase Conflict Resolution Tools (#925)

• Read-only tools are now pre-granted during rebase conflict resolution so Claude doesn't prompt for every file read

Dev Server Improvements (#926)

• Config wizard settings are now respected by the TUI dev server
• Docker container name conflicts resolved for concurrent looms

List Command (#958)

• il list --json now correctly detects capabilities for the main worktree

Swarm Recap Routing (#949)

• Wave verification tasks and swarm workers now correctly route recap entries to child recap files instead of the epic's

Linear URL Resolution (#1002)

• VS Code extension now shows the correct Linear icon for Linear-tracked issues instead of a GitHub octocat

Cross-Platform Temp Directory (#982)

• Windows compatibility fix for temporary directory paths

Volta Support (#1006)

• il update now detects Volta-managed installs and uses volta install instead of npm install -g

Plan Command Spawn Limit (#1003)

• Fixed "Unknown system error" crash when the architect prompt exceeded macOS argument size limits

---

Full Changelog: v0.13.0...v0.14.0

v0.13.4

Release Notes (v0.13.3 → v0.13.4)

🎉 New Features

Configurable Effort Levels (#959)

• New --effort flag (low / medium / high / max) on il start, il spin, and il plan controls how deeply agents reason through each phase
• Resolution chain lets you set effort at multiple levels: CLI flag > loom metadata > settings > environment variable > default
• Swarm mode uses sensible per-agent defaults (analyzer=high, implementer=medium) and supports separate swarmEffort overrides in settings

Dockerfile Detection in Config Wizard (#964)

• il init now detects Dockerfiles in your project and offers to configure Docker-based dev servers automatically
• Saves a manual configuration step for containerized projects

Code Review Fix Tracking (#961)

• New fix recap entry type lets agents log when a code review finding has been addressed
• Creates a clear audit trail from review finding → resolution in the loom recap

🐛 Bug Fixes

OAuth Authentication Broken for Branch/Commit Generation (#965)

• An internal environment variable was disabling OAuth credential lookup in Claude CLI, causing "Not logged in" errors when generating branch names or commit messages without an explicit API key

---

Full Changelog: v0.13.3...v0.13.4

v0.13.3

Release Notes (v0.12.0 → v0.13.3)

🎉 New Features

Composable Automation Flags for il plan (#908, #909)

• --yolo has been decomposed into independent, composable flags so you can fine-tune how much autonomy the planner gets
• --one-shot=noReview skips confirmation gates but keeps permission prompts; --one-shot=bypassPermissions skips both
• --dangerously-skip-permissions is now available standalone on both il plan and il start
• --auto-swarm is independent — it no longer implies full autonomy
• --yolo remains as a convenient superset shorthand

Epic Swarm Implementation Report (#928, #934)

• When finishing an epic loom, iloom now generates a comprehensive implementation report covering what each child issue delivered, integration points to review carefully, and lessons learned
• Reports are posted as PR comments with collapsible sections so reviewers can skim the summary and drill into per-issue details
• Includes testing guidance and a verification checklist derived from actual implementation data — not boilerplate

Dev Server TUI with Sticky Status Bar (#922, #923, #955)

• il dev-server now shows a persistent status bar at the bottom of the terminal with the external URL, container status, and port mapping
• Keyboard shortcuts: o (open browser), c (copy URL), r (restart), q (quit)
• Zero new dependencies — activates automatically in TTY environments, falls through to existing behavior otherwise

1M Context Window Model Support (#907)

• opus[1m] and sonnet[1m] model selections are now available across all commands
• Swarm orchestrator defaults to opus[1m] in both Balanced and Maximum Quality modes for deeper reasoning over large codebases

Docker BuildKit Secrets and Runtime Environment Variables (#919, #935)

• New dockerBuildSecrets config maps secret IDs to local files, passed as --secret flags during docker build
• New dockerRunEnv setting and repeatable -e, --env KEY=VALUE CLI flag on dev-server, open, and run commands for passing environment variables to Docker containers at runtime
• Clear precedence: settings < .env files < CLI flags (last wins)
• Graceful container shutdown on Ctrl+C no longer produces noisy error output

Configurable Dev Server Protocol (#921)

• New protocol option (http/https) in web capabilities settings so dev server URLs display the correct scheme across il open, il run, and il dev-server

Smarter Planning with Dedicated Research Agent (#879, #880)

• Plan mode now delegates research to the Analyze agent instead of doing inline discovery, producing deeper and more thorough implementation plans
• Plans benefit from the same structured research methodology used during issue implementation

Integration-Point Must-Haves in Plans (#912)

• The planner now detects producer/consumer relationships between parallel child issues in the same wave and generates substantive must-haves on verification issues
• Ensures the verifier checks that consumers actually use real instances instead of null placeholders after parallel work merges

Pre-Trusted Tools in Plan Mode (#869, #900)

• Safe, read-only tools and issue management tools are pre-trusted during planning, reducing approval prompts so you can focus on reviewing the plan

Wave Verifier Enhancements (#899, #902, #911)

• Verification results are now posted as comments directly on the verifier's issue, creating a visible audit trail
• Code review step added to the wave verification workflow — gathers the wave diff, invokes the reviewer, and auto-fixes critical findings
• Fix step now parses findings by file and invokes one implementer per file in parallel

Swarm Visibility Improvements (#901, #903, #950)

• Full agent routing table displayed after swarm completes so you can see how every issue was handled
• Swarm comment strategy switched from incremental updates to a single final summary, reducing overhead
• Epic dev server port forwarded to the orchestrator for web output verification after merging child work

Structured Draft PR Bodies (#953, #954)

• Draft PRs created by il start now include the issue title as a heading and the issue body in a collapsible details section, giving reviewers immediate context

Streamlined VS Code Init Wizard (#952)

• When running from VS Code, the config wizard detects the IDE automatically and skips the IDE selection question

Auto-Ignore .env.local Files (#927)

• Local environment override files (.env.local, .env.development.local, etc.) are now automatically added to the global gitignore on upgrade, preventing accidental commits of secrets across all your projects

🐛 Bug Fixes

il list Now Shows Capabilities for Main Worktree (#958)

• il list --json returned empty capabilities for the main worktree because it only reads from loom metadata — now detects capabilities at runtime using the same logic as il dev

Wave Verification Recap Entries Now Saved Correctly (#948, #949)

• Code reviewer agents in swarm mode weren't receiving worktree paths, causing recap entries to route to the wrong file or not be created — now fixed with proper path context

Dev Server Respects Custom Commands in TUI Mode (#926)

• il dev now uses the dev command from package.iloom.local.json in all modes — previously the TUI code path ignored it and fell back to pnpm dev

Docker Container Name Conflicts When Running Multiple Looms (#926)

• Running il dev for multiple Docker-based looms concurrently no longer fails with "container name already in use" — stale containers are now verified as removed before starting new ones

Agent Loading Resilient to Non-Agent Files (#956)

• Documentation files in the agents directory no longer prevent all agents from loading — they're skipped gracefully

Rebase Conflict Resolution Runs Smoothly (#925)

• Read-only tools are now pre-granted during rebase conflict resolution, so the assistant doesn't pause for approval on routine file reads

Main Worktree Uses Base Port (#924)

• Running il dev-server, il open, or il run on the main worktree now correctly returns the base port (default 3000) instead of a hash-derived offset

Plan Agent Respects Configured Issue Tracker (#904)

• The planner now knows which issue tracker and VCS provider are configured, preventing it from using gh CLI commands when the tracker is Linear or Jira

Clarifying Questions Batched (#914)

• The planner now batches up to 4 independent clarifying questions per round instead of asking one at a time

il list Settings Resolution (#910)

• Running il list from a child worktree with a settings.local.json overriding mainBranch no longer filters out all looms

Branch Mode Reuses Existing Branches (#913)

• il start in branch mode no longer fails when the named branch already exists locally — it reuses the existing branch

Cleanup Supports Alphanumeric Identifiers (#898)

• The --issue flag on il cleanup now handles Linear/Jira-style IDs like RANDOM-13 instead of silently failing

Swarm Child Worktree Matching (#897)

• Cleanup now finds swarm child worktrees using both issue-{id} and issue/{id} branch patterns

VS Code "Create Loom" with Short Titles (#884)

• Creating a loom from VS Code with a short title and a description body no longer fails with "Invalid branch name"

---

Full Changelog: v0.12.0...v0.13.3

v0.13.2

Release Notes (v0.12.0 → v0.13.2)

🎉 New Features

Composable Automation Flags for il plan (#908, #909)

• --yolo has been decomposed into independent, composable flags so you can fine-tune how much autonomy the planner gets
• --one-shot=noReview skips confirmation gates but keeps permission prompts; --one-shot=bypassPermissions skips both
• --dangerously-skip-permissions is now available standalone on both il plan and il start
• --auto-swarm is independent — it no longer implies full autonomy
• --yolo remains as a convenient superset shorthand

Epic Swarm Implementation Report (#928, #934)

• When finishing an epic loom, iloom now generates a comprehensive implementation report covering what each child issue delivered, integration points to review carefully, and lessons learned
• Reports are posted as PR comments with collapsible sections so reviewers can skim the summary and drill into per-issue details
• Includes testing guidance and a verification checklist derived from actual implementation data — not boilerplate

Dev Server TUI with Sticky Status Bar (#922, #923, #955)

• il dev-server now shows a persistent status bar at the bottom of the terminal with the external URL, container status, and port mapping
• Keyboard shortcuts: o (open browser), c (copy URL), r (restart), q (quit)
• Zero new dependencies — activates automatically in TTY environments, falls through to existing behavior otherwise

1M Context Window Model Support (#907)

• opus[1m] and sonnet[1m] model selections are now available across all commands
• Swarm orchestrator defaults to opus[1m] in both Balanced and Maximum Quality modes for deeper reasoning over large codebases

Docker BuildKit Secrets and Runtime Environment Variables (#919, #935)

• New dockerBuildSecrets config maps secret IDs to local files, passed as --secret flags during docker build
• New dockerRunEnv setting and repeatable -e, --env KEY=VALUE CLI flag on dev-server, open, and run commands for passing environment variables to Docker containers at runtime
• Clear precedence: settings < .env files < CLI flags (last wins)
• Graceful container shutdown on Ctrl+C no longer produces noisy error output

Configurable Dev Server Protocol (#921)

• New protocol option (http/https) in web capabilities settings so dev server URLs display the correct scheme across il open, il run, and il dev-server

Smarter Planning with Dedicated Research Agent (#879, #880)

• Plan mode now delegates research to the Analyze agent instead of doing inline discovery, producing deeper and more thorough implementation plans
• Plans benefit from the same structured research methodology used during issue implementation

Integration-Point Must-Haves in Plans (#912)

• The planner now detects producer/consumer relationships between parallel child issues in the same wave and generates substantive must-haves on verification issues
• Ensures the verifier checks that consumers actually use real instances instead of null placeholders after parallel work merges

Pre-Trusted Tools in Plan Mode (#869, #900)

• Safe, read-only tools and issue management tools are pre-trusted during planning, reducing approval prompts so you can focus on reviewing the plan

Wave Verifier Enhancements (#899, #902, #911)

• Verification results are now posted as comments directly on the verifier's issue, creating a visible audit trail
• Code review step added to the wave verification workflow — gathers the wave diff, invokes the reviewer, and auto-fixes critical findings
• Fix step now parses findings by file and invokes one implementer per file in parallel

Swarm Visibility Improvements (#901, #903, #950)

• Full agent routing table displayed after swarm completes so you can see how every issue was handled
• Swarm comment strategy switched from incremental updates to a single final summary, reducing overhead
• Epic dev server port forwarded to the orchestrator for web output verification after merging child work

Structured Draft PR Bodies (#953, #954)

• Draft PRs created by il start now include the issue title as a heading and the issue body in a collapsible details section, giving reviewers immediate context

Streamlined VS Code Init Wizard (#952)

• When running from VS Code, the config wizard detects the IDE automatically and skips the IDE selection question

Auto-Ignore .env.local Files (#927)

• Local environment override files (.env.local, .env.development.local, etc.) are now automatically added to the global gitignore on upgrade, preventing accidental commits of secrets across all your projects

🐛 Bug Fixes

Wave Verification Recap Entries Now Saved Correctly (#948, #949)

• Code reviewer agents in swarm mode weren't receiving worktree paths, causing recap entries to route to the wrong file or not be created — now fixed with proper path context

Dev Server Respects Custom Commands in TUI Mode (#926)

• il dev now uses the dev command from package.iloom.local.json in all modes — previously the TUI code path ignored it and fell back to pnpm dev

Docker Container Name Conflicts When Running Multiple Looms (#926)

• Running il dev for multiple Docker-based looms concurrently no longer fails with "container name already in use" — stale containers are now verified as removed before starting new ones

Agent Loading Resilient to Non-Agent Files (#956)

• Documentation files in the agents directory no longer prevent all agents from loading — they're skipped gracefully

Rebase Conflict Resolution Runs Smoothly (#925)

• Read-only tools are now pre-granted during rebase conflict resolution, so the assistant doesn't pause for approval on routine file reads

Main Worktree Uses Base Port (#924)

• Running il dev-server, il open, or il run on the main worktree now correctly returns the base port (default 3000) instead of a hash-derived offset

Plan Agent Respects Configured Issue Tracker (#904)

• The planner now knows which issue tracker and VCS provider are configured, preventing it from using gh CLI commands when the tracker is Linear or Jira

Clarifying Questions Batched (#914)

• The planner now batches up to 4 independent clarifying questions per round instead of asking one at a time

il list Settings Resolution (#910)

• Running il list from a child worktree with a settings.local.json overriding mainBranch no longer filters out all looms

Branch Mode Reuses Existing Branches (#913)

• il start in branch mode no longer fails when the named branch already exists locally — it reuses the existing branch

Cleanup Supports Alphanumeric Identifiers (#898)

• The --issue flag on il cleanup now handles Linear/Jira-style IDs like RANDOM-13 instead of silently failing

Swarm Child Worktree Matching (#897)

• Cleanup now finds swarm child worktrees using both issue-{id} and issue/{id} branch patterns

VS Code "Create Loom" with Short Titles (#884)

• Creating a loom from VS Code with a short title and a description body no longer fails with "Invalid branch name"

---

Full Changelog: v0.12.0...v0.13.2

v0.13.1

Release Notes (v0.12.0 → v0.13.1)

🎉 New Features

Composable Automation Flags for il plan (#908, #909)

• --yolo has been decomposed into independent, composable flags so you can fine-tune how much autonomy the planner gets
• --one-shot=noReview skips confirmation gates but keeps permission prompts; --one-shot=bypassPermissions skips both
• --dangerously-skip-permissions is now available standalone on both il plan and il start
• --auto-swarm is independent — it no longer implies full autonomy
• --yolo remains as a convenient superset shorthand

Dev Server TUI with Sticky Status Bar (#922, #923)

• il dev-server now shows a persistent status bar at the bottom of the terminal with the external URL, container status, and port mapping
• Keyboard shortcuts: o (open browser), c (copy URL), r (restart), q (quit)
• Zero new dependencies — activates automatically in TTY environments, falls through to existing behavior otherwise

1M Context Window Model Support (#907)

• opus[1m] and sonnet[1m] model selections are now available across all commands
• Swarm orchestrator defaults to opus[1m] in both Balanced and Maximum Quality modes for deeper reasoning over large codebases

Docker BuildKit Secrets (#919)

• New dockerBuildSecrets config maps secret IDs to local files, passed as --secret flags during docker build
• Secrets are validated (file existence, no directory traversal) and DOCKER_BUILDKIT=1 is set automatically
• Graceful container shutdown on Ctrl+C no longer produces noisy error output

Configurable Dev Server Protocol (#921)

• New protocol option (http/https) in web capabilities settings so dev server URLs display the correct scheme across il open, il run, and il dev-server

Smarter Planning with Dedicated Research Agent (#879, #880)

• Plan mode now delegates research to the Analyze agent instead of doing inline discovery, producing deeper and more thorough implementation plans
• Plans benefit from the same structured research methodology used during issue implementation

Integration-Point Must-Haves in Plans (#912)

• The planner now detects producer/consumer relationships between parallel child issues in the same wave and generates substantive must-haves on verification issues
• Ensures the verifier checks that consumers actually use real instances instead of null placeholders after parallel work merges

Pre-Trusted Tools in Plan Mode (#869, #900)

• Safe, read-only tools and issue management tools are pre-trusted during planning, reducing approval prompts so you can focus on reviewing the plan

Wave Verifier Enhancements (#899, #902, #911)

• Verification results are now posted as comments directly on the verifier's issue, creating a visible audit trail
• Code review step added to the wave verification workflow — gathers the wave diff, invokes the reviewer, and auto-fixes critical findings
• Fix step now parses findings by file and invokes one implementer per file in parallel

Swarm Visibility Improvements (#901, #903)

• Full agent routing table displayed after swarm completes so you can see how every issue was handled
• Swarm comment strategy switched from incremental updates to a single final summary, reducing overhead

Auto-Ignore .env.local Files (#927)

• Local environment override files (.env.local, .env.development.local, etc.) are now automatically added to the global gitignore on upgrade, preventing accidental commits of secrets across all your projects

🐛 Bug Fixes

Dev Server Respects Custom Commands in TUI Mode (#926)

• il dev now uses the dev command from package.iloom.local.json in all modes — previously the TUI code path ignored it and fell back to pnpm dev

Docker Container Name Conflicts When Running Multiple Looms (#926)

• Running il dev for multiple Docker-based looms concurrently no longer fails with "container name already in use" — stale containers are now verified as removed before starting new ones

Dev Server TUI Clears Previous Output (#926)

• The TUI no longer overwrites existing terminal content (build logs, startup messages) — it clears the screen first for a clean display

Rebase Conflict Resolution Runs Smoothly (#925)

• Read-only tools are now pre-granted during rebase conflict resolution, so the assistant doesn't pause for approval on routine file reads

Main Worktree Uses Base Port (#924)

• Running il dev-server, il open, or il run on the main worktree now correctly returns the base port (default 3000) instead of a hash-derived offset

Plan Agent Respects Configured Issue Tracker (#904)

• The planner now knows which issue tracker and VCS provider are configured, preventing it from using gh CLI commands when the tracker is Linear or Jira

Clarifying Questions Batched (#914)

• The planner now batches up to 4 independent clarifying questions per round instead of asking one at a time

il list Settings Resolution (#910)

• Running il list from a child worktree with a settings.local.json overriding mainBranch no longer filters out all looms

Branch Mode Reuses Existing Branches (#913)

• il start in branch mode no longer fails when the named branch already exists locally — it reuses the existing branch

Cleanup Supports Alphanumeric Identifiers (#898)

• The --issue flag on il cleanup now handles Linear/Jira-style IDs like RANDOM-13 instead of silently failing

Swarm Child Worktree Matching (#897)

• Cleanup now finds swarm child worktrees using both issue-{id} and issue/{id} branch patterns

VS Code "Create Loom" with Short Titles (#884)

• Creating a loom from VS Code with a short title and a description body no longer fails with "Invalid branch name"

---

Full Changelog: v0.12.0...v0.13.1

v0.13.0

Release Notes (v0.12.0 → v0.13.0)

🎉 New Features

Composable Automation Flags for il plan (#908, #909)

• --yolo has been decomposed into independent, composable flags so you can fine-tune how much autonomy the planner gets
• --one-shot=noReview skips confirmation gates but keeps permission prompts; --one-shot=bypassPermissions skips both
• --dangerously-skip-permissions is now available standalone on both il plan and il start
• --auto-swarm is independent — it no longer implies full autonomy
• --yolo remains as a convenient superset shorthand

Dev Server TUI with Sticky Status Bar (#922, #923)

• il dev-server now shows a persistent status bar at the bottom of the terminal with the external URL, container status, and port mapping
• Keyboard shortcuts: o (open browser), c (copy URL), r (restart), q (quit)
• Zero new dependencies — activates automatically in TTY environments, falls through to existing behavior otherwise

1M Context Window Model Support (#907)

• opus[1m] and sonnet[1m] model selections are now available across all commands
• Swarm orchestrator defaults to opus[1m] in both Balanced and Maximum Quality modes for deeper reasoning over large codebases

Docker BuildKit Secrets (#919)

• New dockerBuildSecrets config maps secret IDs to local files, passed as --secret flags during docker build
• Secrets are validated (file existence, no directory traversal) and DOCKER_BUILDKIT=1 is set automatically
• Graceful container shutdown on Ctrl+C no longer produces noisy error output

Configurable Dev Server Protocol (#921)

• New protocol option (http/https) in web capabilities settings so dev server URLs display the correct scheme across il open, il run, and il dev-server

Smarter Planning with Dedicated Research Agent (#879, #880)

• Plan mode now delegates research to the Analyze agent instead of doing inline discovery, producing deeper and more thorough implementation plans
• Plans benefit from the same structured research methodology used during issue implementation

Integration-Point Must-Haves in Plans (#912)

• The planner now detects producer/consumer relationships between parallel child issues in the same wave and generates substantive must-haves on verification issues
• Ensures the verifier checks that consumers actually use real instances instead of null placeholders after parallel work merges

Pre-Trusted Tools in Plan Mode (#869, #900)

• Safe, read-only tools and issue management tools are pre-trusted during planning, reducing approval prompts so you can focus on reviewing the plan

Wave Verifier Enhancements (#899, #902, #911)

• Verification results are now posted as comments directly on the verifier's issue, creating a visible audit trail
• Code review step added to the wave verification workflow — gathers the wave diff, invokes the reviewer, and auto-fixes critical findings
• Fix step now parses findings by file and invokes one implementer per file in parallel

Swarm Visibility Improvements (#901, #903)

• Full agent routing table displayed after swarm completes so you can see how every issue was handled
• Swarm comment strategy switched from incremental updates to a single final summary, reducing overhead

🐛 Bug Fixes

Main Worktree Uses Base Port (#924)

• Running il dev-server, il open, or il run on the main worktree now correctly returns the base port (default 3000) instead of a hash-derived offset

Plan Agent Respects Configured Issue Tracker (#904)

• The planner now knows which issue tracker and VCS provider are configured, preventing it from using gh CLI commands when the tracker is Linear or Jira

Clarifying Questions Batched (#914)

• The planner now batches up to 4 independent clarifying questions per round instead of asking one at a time

il list Settings Resolution (#910)

• Running il list from a child worktree with a settings.local.json overriding mainBranch no longer filters out all looms

Branch Mode Reuses Existing Branches (#913)

• il start in branch mode no longer fails when the named branch already exists locally — it reuses the existing branch

Cleanup Supports Alphanumeric Identifiers (#898)

• The --issue flag on il cleanup now handles Linear/Jira-style IDs like RANDOM-13 instead of silently failing

Swarm Child Worktree Matching (#897)

• Cleanup now finds swarm child worktrees using both issue-{id} and issue/{id} branch patterns

VS Code "Create Loom" with Short Titles (#884)

• Creating a loom from VS Code with a short title and a description body no longer fails with "Invalid branch name"

---

Full Changelog: v0.12.0...v0.13.0

v0.12.1

Release Notes (v0.12.0 → v0.12.1)

🎉 New Features

Smarter Planning with Dedicated Research Agent (#879, #880)

• Plan mode now delegates research to the Analyze agent instead of doing inline discovery, producing deeper and more thorough implementation plans
• Plans benefit from the same structured research methodology used during issue implementation — covering problem space, third-party libraries, and codebase analysis

Pre-Trusted Tools in Plan Mode (#869)

• A curated set of safe, read-only tools are now pre-trusted during planning, reducing approval prompts so you can focus on reviewing the plan itself

🐛 Bug Fixes

VS Code "Create Loom" Fails for Short Titles (#884)

• Creating a new loom from the VS Code extension with a short issue title (e.g., "A Test Loom") and a description body no longer fails with "Invalid branch name"
• The CLI now correctly recognizes short titles as new issue descriptions when a --body is provided

---

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Release Notes (v0.11.0 → v0.12.0)

🎉 New Features

Wave Verification for Swarm Mode (#836)

• Swarm orchestration now validates work at dependency wave boundaries before spawning the next wave
• The planner generates must-have criteria (exists, substantive, wired) for each child issue, and a verifier agent checks them after each wave completes
• Failed checks trigger automatic fix agents with single-pass re-verification — catching integration issues early instead of at the end
• Verification tasks appear as child issues in the DAG, giving you full visibility into what was checked and what was fixed
• Controlled via waveVerification plan setting (enabled by default)

BitBucket Cloud Integration (#609)

• iloom now supports BitBucket Cloud as a version control provider alongside GitHub
• Create and manage pull requests, post inline review comments, and auto-assign reviewers — all through the same il finish workflow
• Auto-detects workspace and repository from your git remote
• Existing merge mode settings (github-pr, github-draft-pr) are automatically migrated to generic values (pr, draft-pr) so your config works with any provider
• Thanks to @NoahCardoza for the contribution

Docker-Based Dev Server Support (#754)

• Run your dev server inside a Docker container with automatic port mapping via devServer: "docker"
• 3-tier container port resolution: iloom config → Docker image inspect → Dockerfile EXPOSE
• Automatic image building, container lifecycle management, and signal forwarding
• Early crash detection so you know immediately when the container fails to start

Swarm Agents Run as Skills Instead of Subprocesses (#863)

• Swarm phase agents (analyzer, planner, implementer, etc.) now run as native Claude Code skills instead of claude -p subprocesses
• More reliable execution with proper context passing and error visibility

🐛 Bug Fixes

Terminal Corruption on Ctrl+C (#882)

• Fixed terminal corruption when pressing Ctrl+C during foreground child processes — cleanup now runs properly before the process exits

set_goal Firing in Wrong Workflows (#885)

• Goal-setting is now correctly restricted to PR workflows only, preventing unintended behavior in issue and epic looms

Swarm Reliability Improvements

• Increased agent turn limits to prevent premature cutoffs on complex tasks (#860)
• Default swarm worker model corrected to Sonnet (was incorrectly falling back to Opus)

---

Full Changelog: v0.11.0...v0.12.0

v0.11.1

Release Notes (v0.10.0 → v0.11.1)

🎉 New Features

Linux, WSL, and tmux Terminal Support

• iloom now works on Linux with GUI terminals (gnome-terminal, konsole, xterm), WSL via Windows Terminal, and headless environments via tmux fallback (#796)
• Auto-detection: tries GUI terminals first, falls back to tmux when no display is available
• Unblocks il start on headless Linux environments (SSH, Docker, Code Server) where iloom was previously unusable
• Thanks to @TickTockBent for the implementation and @rexsilex for the original architecture

Auto-Swarm: One Command from Plan to Execution

• il plan --auto-swarm chains the entire epic lifecycle — plan decomposition, epic workspace creation, and swarm launch — into a single unattended pipeline (#769)
• If the plan produces no child issues, it falls back to a normal autonomous loom
• VS Code extension can own the harness socket to manage the pipeline externally

PR Code Reviews with Inline Comments

• Agents can now post inline code review comments directly on GitHub pull requests, addressing specific lines of code rather than leaving generic top-level feedback (#819)
• Severity-based verdicts: Critical and Warning findings trigger REQUEST_CHANGES, suggestions are informational
• In one-shot mode, agents automatically triage and address existing review comments — fixing quick and moderate items, deferring complex or risky ones
• When opening a PR, agents check for unresolved review comments and work through them

Swarm Quality Presets in Configuration Wizard

• il init now offers swarm quality modes upfront: Maximum Quality (Opus everywhere), Balanced (Opus for analysis and workers, Sonnet for planning), and Fast & Cheap (Sonnet/Haiku) (#731, #777)
• Pick a preset and start swarming without manually configuring per-agent models

--complexity Flag to Skip Complexity Evaluation

• Tell iloom exactly how complex a task is instead of waiting for the evaluator: il start --complexity=simple or il spin --complexity=complex (#816)
• On il start, the override persists in loom metadata for future spins
• On il spin, it applies to the current session only

Configurable Per-Agent Swarm Models

• Set different AI models for each phase agent in swarm mode via per-agent swarmModel overrides, independent of non-swarm model settings (#736)

Post-Swarm Code Review Phase

• After all swarm child agents complete and merge, the orchestrator automatically runs a code review on the merged epic branch and auto-fixes high-confidence findings (#827)
• Configurable via spin.postSwarmReview setting (enabled by default)
• Non-blocking: review or fix failures don't prevent finalization
• Single-pass constraint prevents infinite review-fix loops

--create-only Flag for Workspace-Only Creation

• New convenience flag on il start that bundles --no-claude --no-code --no-terminal --no-dev-server — creates the isolated workspace without launching anything (#825)
• Useful for automation, scripting, and cases where you want to set up the environment before starting work

--json-stream for Headless Automation

• il rebase, il finish, and il commit now support --json-stream for JSONL streaming to stdout with progress on stderr — useful for CI pipelines and tooling integrations (#635)

il install-deps Command

• New utility command that detects and installs dependencies using iloom config files or lockfile detection, with support for pnpm, npm, and yarn (#780)

🐛 Bug Fixes

Swarm Reliability and Performance — Workers now produce descriptive commit messages instead of generic "fixes #NNN"; dependencies are installed after merging worker branches so subsequent workers have up-to-date packages; re-spinning skips done child issues so partial failures don't redo completed work; reduced per-agent overhead keeps worker context windows lean; il spin in child worktrees now shows a clear error instead of conflicting with the orchestrator; increased agent turn limits to prevent premature cutoffs on complex tasks; skipped redundant file validation in swarm mode to save 5-10 turns per implementation run (#781, #831, #830, #789, #792, #774, #860)

Agent Analysis Quality — Anti-confabulation rules prevent agents from fabricating cross-component values; anti-parroting rules ensure assumptions add genuine insight rather than restating the issue description; recap entries filter out agent infrastructure noise (#823, #828, #817)

Jira Wiki Markup Sanitization — Prevents Jira Wiki format from leaking into issue comments when Jira is configured as the issue tracker (#728)

Code Reviewer Works on All Branch Types — Previously only worked with uncommitted changes. Now diffs against the appropriate merge base for feature branches (#785)

Error Visibility When Claude Launch Fails — Error output from Claude is now properly surfaced instead of being silently swallowed (#786)

---

Full Changelog: v0.10.0...v0.11.1

v0.11.0

Release Notes (v0.10.0 → v0.11.0)

🎉 New Features

Linux, WSL, and tmux Terminal Support

• iloom now works on Linux with GUI terminals (gnome-terminal, konsole, xterm), WSL via Windows Terminal, and headless environments via tmux fallback (#796)
• Auto-detection: tries GUI terminals first, falls back to tmux when no display is available
• Unblocks il start on headless Linux environments (SSH, Docker, Code Server) where iloom was previously unusable
• Thanks to @TickTockBent for the implementation and @rexsilex for the original architecture

Auto-Swarm: One Command from Plan to Execution

• il plan --auto-swarm chains the entire epic lifecycle — plan decomposition, epic workspace creation, and swarm launch — into a single unattended pipeline (#769)
• If the plan produces no child issues, it falls back to a normal autonomous loom
• VS Code extension can own the harness socket to manage the pipeline externally

PR Code Reviews with Inline Comments

• Agents can now post inline code review comments directly on GitHub pull requests, addressing specific lines of code rather than leaving generic top-level feedback (#819)
• Severity-based verdicts: Critical and Warning findings trigger REQUEST_CHANGES, suggestions are informational
• In one-shot mode, agents automatically triage and address existing review comments — fixing quick and moderate items, deferring complex or risky ones
• When opening a PR, agents check for unresolved review comments and work through them

Swarm Quality Presets in Configuration Wizard

• il init now offers swarm quality modes upfront: Maximum Quality (Opus everywhere), Balanced (Opus for analysis and workers, Sonnet for planning), and Fast & Cheap (Sonnet/Haiku) (#731, #777)
• Pick a preset and start swarming without manually configuring per-agent models

--complexity Flag to Skip Complexity Evaluation

• Tell iloom exactly how complex a task is instead of waiting for the evaluator: il start --complexity=simple or il spin --complexity=complex (#816)
• On il start, the override persists in loom metadata for future spins
• On il spin, it applies to the current session only

Configurable Per-Agent Swarm Models

• Set different AI models for each phase agent in swarm mode via per-agent swarmModel overrides, independent of non-swarm model settings (#736)

Post-Swarm Code Review Phase

• After all swarm child agents complete and merge, the orchestrator automatically runs a code review on the merged epic branch and auto-fixes high-confidence findings (#827)
• Configurable via spin.postSwarmReview setting (enabled by default)
• Non-blocking: review or fix failures don't prevent finalization
• Single-pass constraint prevents infinite review-fix loops

--create-only Flag for Workspace-Only Creation

• New convenience flag on il start that bundles --no-claude --no-code --no-terminal --no-dev-server — creates the isolated workspace without launching anything (#825)
• Useful for automation, scripting, and cases where you want to set up the environment before starting work

--json-stream for Headless Automation

• il rebase, il finish, and il commit now support --json-stream for JSONL streaming to stdout with progress on stderr — useful for CI pipelines and tooling integrations (#635)

il install-deps Command

• New utility command that detects and installs dependencies using iloom config files or lockfile detection, with support for pnpm, npm, and yarn (#780)

🐛 Bug Fixes

Swarm Reliability and Performance — Workers now produce descriptive commit messages instead of generic "fixes #NNN"; dependencies are installed after merging worker branches so subsequent workers have up-to-date packages; re-spinning skips done child issues so partial failures don't redo completed work; reduced per-agent overhead keeps worker context windows lean; il spin in child worktrees now shows a clear error instead of conflicting with the orchestrator (#781, #831, #830, #789, #792, #774)

Agent Analysis Quality — Anti-confabulation rules prevent agents from fabricating cross-component values; anti-parroting rules ensure assumptions add genuine insight rather than restating the issue description; recap entries filter out agent infrastructure noise (#823, #828, #817)

Jira Wiki Markup Sanitization — Prevents Jira Wiki format from leaking into issue comments when Jira is configured as the issue tracker (#728)

Code Reviewer Works on All Branch Types — Previously only worked with uncommitted changes. Now diffs against the appropriate merge base for feature branches (#785)

Error Visibility When Claude Launch Fails — Error output from Claude is now properly surfaced instead of being silently swallowed (#786)

---

Full Changelog: v0.10.0...v0.11.0