v0.9.2

Release Notes (v0.9.0 → v0.9.2)

🎉 New Features

List Project Issues and PRs from the CLI (#581, #584)

• New il issues command lists open issues and non-draft pull requests from your configured issue tracker (GitHub or Linear)
• PRs are prefixed with [PR] for easy scanning; a type field distinguishes issues from PRs programmatically
• Results are cached locally for 2 minutes for fast repeated lookups
• Supports Linear API token configuration in project settings

Configurable Git Commit Timeout (#586)

• New git.commitTimeout setting (default 60s, up to 10 minutes) for repos with long-running pre-commit hooks
• No more timeouts when hooks run linting, formatting, or test suites before committing
• Thanks to @NoahCardoza for this contribution!

Draft PRs Now Include Issue Context (#554)

• Draft PRs created during il start now include the issue title, body, and a Fixes #XXX keyword
• Reviewers see full context without leaving the PR, and merging auto-closes the linked issue

Child Loom Draft PRs Target the Parent Branch (#580)

• Draft PRs for child looms now correctly target the parent loom's branch instead of main
• Enables proper PR stacking for hierarchical loom workflows

🐛 Bug Fixes

il start Now Works for PRs from Forks (#594)

• il start previously failed for PRs submitted from forks because the contributor's branch doesn't exist on origin
• Now fetches the code via GitHub's PR ref and handles branch naming collisions gracefully

Branch Cleanup No Longer Fails for Draft PR Branches (#576)

• il cleanup could fail when deleting draft PR branches because Git considered them "not fully merged" into main
• Now correctly uses force delete when the safety check has already confirmed no data loss risk

Linear API Token Passed Through for Child Issue Fetching (#592)

• il list --children no longer fails with UNAUTHORIZED errors for Linear-configured projects
• The API token from settings is now correctly passed through the call stack

---

Full Changelog: v0.9.0...v0.9.2

v0.9.1

Release Notes (v0.9.0 → v0.9.1)

🎉 New Features

List Project Issues from the CLI (#581)

• New il issues command lists open issues from your configured issue tracker (GitHub or Linear)
• Results are cached locally for 2 minutes for fast repeated lookups
• Supports Linear API token configuration in project settings

Draft PRs Now Include Issue Context (#554)

• Draft PRs created during il start now include the issue title, body, and a Fixes #XXX keyword
• Reviewers see full context without leaving the PR, and merging auto-closes the linked issue

Child Loom Draft PRs Target the Parent Branch (#580)

• Draft PRs for child looms now correctly target the parent loom's branch instead of main
• Enables proper PR stacking for hierarchical loom workflows

🐛 Bug Fixes

Branch Cleanup No Longer Fails for Draft PR Branches (#576)

• il cleanup could fail when deleting draft PR branches because Git considered them "not fully merged" into main
• Now correctly uses force delete when the safety check has already confirmed no data loss risk

---

Full Changelog: v0.9.0...v0.9.1

v0.9.0

Release Notes (v0.8.0 → v0.9.1)

🎉 New Features

Zero-Setup First-Run Experience (#539)

• Running il start or il plan on an unconfigured project now shows sensible defaults you can accept with a single keypress
• No need to go through the full configuration wizard for standard setups — just press Enter and go

Artifact Review Before Posting (#502, #552, #567, #568)

• New iloom-artifact-reviewer agent reviews analysis plans, enhancements, and implementation completeness before they're posted to issues or PRs
• Catches gaps between plans and implementations, ensuring what gets posted is accurate and complete
• Supports Claude, Gemini, and Codex as review providers
• Per-agent review flags let you enable artifact review only where it matters

Draft PR Mode for Branch Workflows (#526, #528, #529)

• Draft PR mode (github-draft-pr) now works with branch/regular mode workflows, not just issue mode
• Agents know exactly where to post comments — issues vs PRs — eliminating confusion in draft PR workflows
• Draft PR is registered as an artifact in the recap panel for easy access throughout the session

Draft PRs Now Include Issue Context (#554)

• Draft PRs created during il start now include the issue title, body, and a Fixes #XXX keyword
• Reviewers see full context without leaving the PR, and merging auto-closes the linked issue

Child Loom Draft PRs Target the Parent Branch (#580)

• Draft PRs for child looms now correctly target the parent loom's branch instead of main
• Enables proper PR stacking for hierarchical loom workflows

List Project Issues from the CLI (#581)

• New il issues command lists open issues from your configured issue tracker (GitHub or Linear)
• Results are cached locally for 2 minutes for fast repeated lookups
• Supports Linear API token configuration in project settings

Headless/Print Mode for CI/CD Integration (#503, #509)

• New --print flag on il spin and il plan enables headless execution for pipelines
• --json returns structured output; --json-stream streams JSONL in real-time
• Automatically enables autonomous execution (no interactive prompts) in print mode

--yolo Flag for Fully Autonomous Execution (#536)

• New --yolo flag on il start and il spin as a memorable shorthand for --one-shot=bypassPermissions
• One flag for hands-free, fully autonomous loom execution

Configurable Dev Server Timeout (#541)

• ILOOM_DEV_SERVER_TIMEOUT environment variable lets you set how long iloom waits for your dev server to start
• Default increased from 30s to 180s — better for large projects with slow builds

Hierarchical Loom Visibility (#500)

• New il list --children flag shows child issues and their associated looms
• Track progress across multi-loom feature implementations at a glance

Opus as Default Model for Workflow Agents (#507)

• Workflow agents now default to Opus for improved reasoning quality
• Complexity evaluator uses Haiku for fast assessments
• Budget-friendly configuration examples added to documentation

VS Code Extension Integration (#491)

• New il vscode command installs the iloom extension and opens your workspace in VS Code
• Auto-detects your current workspace from directory or branch name

🐛 Bug Fixes

Safer Force Push After Rebase in Draft PR Mode (#523)

• il finish now always uses --force-with-lease after rebasing in draft PR mode, preventing accidental overwrites of others' work

Draft PR Mode Handles Existing Remote Branches (#531)

• il start in draft PR mode no longer fails when the remote branch already exists — it detects and reuses the existing branch and PR

Fresh Branches from Origin in PR Modes (#521)

• il start now fetches from origin and branches from origin/main in PR modes, ensuring you always start from the latest upstream state
• Rebase during il finish also uses origin/main for consistency

Code Reviewer Now Sees New Files (#566)

• The code reviewer previously only ran git diff, missing untracked files entirely — now it also checks git status and reads new files

Branch Cleanup No Longer Fails for Draft PR Branches (#576)

• il cleanup could fail when deleting draft PR branches because Git considered them "not fully merged" into main
• Now correctly uses force delete when the safety check has already confirmed no data loss risk

Metadata Cleanup on Worktree Removal (#569)

• il cleanup now properly deletes orphaned metadata files, preventing stale loom data from accumulating

Dev Server Script Detection (#540)

• Auto-start guard now checks package.iloom.json and package.iloom.local.json for dev scripts, not just package.json

Recap Files Archived on Cleanup (#508)

• Recap files are now moved to an archived subdirectory during cleanup instead of being left behind

Worktree Timeout for Large Repos (#540)

• Increased worktree creation timeout to 5 minutes to accommodate LFS and large repositories

Plan Completion Directs to Epic (#517)

• il plan now directs you to the epic issue at completion, where you can see the full dependency graph, instead of pointing to the first unblocked child

Draft PR Metadata Consistency (#555)

• Draft PR numbers are now properly stored in metadata alongside PR URLs

📚 Documentation

Comprehensive Configuration Guide Updates (#507, #487)

• Multi-AI provider configuration for planner and reviewer phases
• Available models by provider reference table
• Budget-friendly configuration examples with cost optimization guidance

---

Full Changelog: v0.8.0...v0.9.1

v0.8.2

Release Notes (v0.7.0 → v0.8.2)

🎉 New Features

VS Code Extension Integration (#491)

• New il vscode command installs the iloom extension and opens your workspace in VS Code
• Auto-detects your current workspace from directory or branch name
• One-time announcement after commands reminds you about the extension

Easier Issue Creation from Short Descriptions

• Create issues from shorter text like "Add logout button" (now requires >15 chars instead of >25)
• Faster workflow when you know exactly what you want to build

Plan Command for AI-Assisted Feature Decomposition (#471, #472, #473, #477, #487)

• New il plan command launches an interactive planning session with Claude as an "Architect" persona
• Breaks down complex features into child issues following the "1 issue = 1 loom = 1 PR" pattern
• Supports decomposition mode: run il plan #123 to refine an existing issue into child tasks
• Multi-AI provider support: use --planner and --reviewer flags to choose Claude, Gemini, or Codex
• Autonomous mode with --yolo flag for hands-off planning execution
• Creates and manages issue dependencies automatically on GitHub and Linear

Issue Dependency Management (#472)

• Create, view, and remove dependencies between issues
• Works with both GitHub (using native dependencies API) and Linear (using relations)
• Available in plan command workflows and via MCP tools

Hierarchical Loom Visibility (#500)

• New il list --children flag shows child issues and their associated looms
• See the full breakdown of parent issues with their decomposed child tasks
• Helps track progress across multi-loom feature implementations

Opus as Default Model for Workflow Agents (#507)

• Workflow agents now use Opus by default for improved reasoning quality
• Complexity evaluator uses Haiku for faster assessments
• Budget-friendly configuration examples added to documentation

Integrated Code Review Step (#490, #497)

• All workflows now include a code review phase using the iloom-code-reviewer agent
• Review happens automatically after implementation, before completion
• Configurable across Claude, Gemini, and Codex providers

Session Summaries Posted to Your PRs (#468)

• When using github-pr or github-draft-pr merge mode, session summaries are now posted directly to your PR instead of the issue
• Keeps implementation context right where reviewers need it

Images from Issues Download Automatically (#469)

• Images referenced in GitHub and Linear issues are now downloaded and cached locally
• Claude can see screenshots, mockups, and diagrams directly from your issues
• Supports both markdown and HTML image formats with automatic credential handling

Use GitHub PRs with Linear as Your Issue Tracker (#464, #465)

• iloom now fully supports using Linear for issue tracking while managing GitHub Pull Requests
• Create PRs via github-pr or github-draft-pr merge modes with Linear issues
• Start work on existing GitHub PRs with il start #42 even when Linear is your issue tracker
• Perfect for teams using Linear for project management but GitHub for code review

Fork Contributors Get Isolated Configuration (#456)

• New package.iloom.local.json file for fork-specific settings that don't affect upstream
• Automatically gitignored so your local config stays local
• The configuration wizard now detects forks and suggests local configuration by default

Development Port Now Available in Agent Context (#463)

• Claude now sees the development server port (e.g., PORT=3025) for web-capable looms
• Port is calculated from the issue number for consistent workspace isolation

One-Shot Mode Persistence (#496)

• One-shot mode preference is now stored in loom metadata
• Explicit CLI flags override stored values for flexibility

Accept Edits by Default (#493)

• All workflow types now use accept-edits permission mode by default
• Reduces friction during implementation

Improved Init Command Flow (#478)

• Pre-approved tools for git and file operations reduce permission prompts
• Smoother configuration wizard experience

Session ID Synchronization (#479)

• Session IDs now properly sync when using /clear in Claude
• Ensures metadata stays accurate across session resets

Spin Command Validation (#489)

• Clear error messaging when attempting to spin from the main worktree
• Helpful suggestions guide you to the correct workflow

🐛 Bug Fixes

Code Reviewer No Longer Flags Temporal Information

• Prevents false positives when code references external services, models, or APIs that may have changed since the model's training cutoff

--no-code Flag Now Correctly Skips IDE Validation (#459)

• Fixed issue where il start --no-code still required a valid IDE command
• Analysis-only workflows now work without VS Code or other IDE installed

JSON Output No Longer Corrupted by Update Notifications (#457)

• Fixed issue where --json output could be corrupted by version update notifications

Active Looms Count Now Includes Child Looms (#467)

• Fixed il projects to correctly count child looms in active loom totals
• Added cross-platform path handling for Windows compatibility

Claude Interactive Sessions Work Correctly (#458)

• Fixed error when Claude tried to help with merge conflicts or validation errors

📚 Documentation

Comprehensive Configuration Guide Updates (#487, #507)

• Multi-AI provider configuration for planner and reviewer phases
• Available models by provider reference table
• Budget-friendly configuration examples with cost optimization guidance

New Getting Started Guide (#462)

• Comprehensive setup guide with provider-specific instructions
• Step-by-step workflow examples for new users

Terms of Service (#461)

• Added Terms of Service link to README and CLI help

---

Full Changelog: v0.7.0...v0.8.2

v0.8.1

Release Notes (v0.7.0 → v0.8.1)

🎉 New Features

Plan Command for AI-Assisted Feature Decomposition (#471, #472, #473, #477, #487)

• New il plan command launches an interactive planning session with Claude as an "Architect" persona
• Breaks down complex features into child issues following the "1 issue = 1 loom = 1 PR" pattern
• Supports decomposition mode: run il plan #123 to refine an existing issue into child tasks
• Multi-AI provider support: use --planner and --reviewer flags to choose Claude, Gemini, or Codex
• Autonomous mode with --yolo flag for hands-off planning execution
• Creates and manages issue dependencies automatically on GitHub and Linear

Issue Dependency Management (#472)

• Create, view, and remove dependencies between issues
• Works with both GitHub (using native dependencies API) and Linear (using relations)
• Available in plan command workflows and via MCP tools

Hierarchical Loom Visibility (#500)

• New il list --children flag shows child issues and their associated looms
• See the full breakdown of parent issues with their decomposed child tasks
• Helps track progress across multi-loom feature implementations

Opus as Default Model for Workflow Agents (#507)

• Workflow agents now use Opus by default for improved reasoning quality
• Complexity evaluator uses Haiku for faster assessments
• Budget-friendly configuration examples added to documentation

Integrated Code Review Step (#490, #497)

• All workflows now include a code review phase using the iloom-code-reviewer agent
• Review happens automatically after implementation, before completion
• Configurable across Claude, Gemini, and Codex providers

Session Summaries Posted to Your PRs (#468)

• When using github-pr or github-draft-pr merge mode, session summaries are now posted directly to your PR instead of the issue
• Keeps implementation context right where reviewers need it

Images from Issues Download Automatically (#469)

• Images referenced in GitHub and Linear issues are now downloaded and cached locally
• Claude can see screenshots, mockups, and diagrams directly from your issues
• Supports both markdown and HTML image formats with automatic credential handling

Use GitHub PRs with Linear as Your Issue Tracker (#464, #465)

• iloom now fully supports using Linear for issue tracking while managing GitHub Pull Requests
• Create PRs via github-pr or github-draft-pr merge modes with Linear issues
• Start work on existing GitHub PRs with il start #42 even when Linear is your issue tracker
• Perfect for teams using Linear for project management but GitHub for code review

Fork Contributors Get Isolated Configuration (#456)

• New package.iloom.local.json file for fork-specific settings that don't affect upstream
• Automatically gitignored so your local config stays local
• The configuration wizard now detects forks and suggests local configuration by default

Development Port Now Available in Agent Context (#463)

• Claude now sees the development server port (e.g., PORT=3025) for web-capable looms
• Port is calculated from the issue number for consistent workspace isolation

One-Shot Mode Persistence (#496)

• One-shot mode preference is now stored in loom metadata
• Explicit CLI flags override stored values for flexibility

Accept Edits by Default (#493)

• All workflow types now use accept-edits permission mode by default
• Reduces friction during implementation

Improved Init Command Flow (#478)

• Pre-approved tools for git and file operations reduce permission prompts
• Smoother configuration wizard experience

Session ID Synchronization (#479)

• Session IDs now properly sync when using /clear in Claude
• Ensures metadata stays accurate across session resets

Spin Command Validation (#489)

• Clear error messaging when attempting to spin from the main worktree
• Helpful suggestions guide you to the correct workflow

🐛 Bug Fixes

Code Reviewer No Longer Flags Temporal Information

• Prevents false positives when code references external services, models, or APIs that may have changed since the model's training cutoff

--no-code Flag Now Correctly Skips IDE Validation (#459)

• Fixed issue where il start --no-code still required a valid IDE command
• Analysis-only workflows now work without VS Code or other IDE installed

JSON Output No Longer Corrupted by Update Notifications (#457)

• Fixed issue where --json output could be corrupted by version update notifications

Active Looms Count Now Includes Child Looms (#467)

• Fixed il projects to correctly count child looms in active loom totals
• Added cross-platform path handling for Windows compatibility

Claude Interactive Sessions Work Correctly (#458)

• Fixed error when Claude tried to help with merge conflicts or validation errors

📚 Documentation

Comprehensive Configuration Guide Updates (#487, #507)

• Multi-AI provider configuration for planner and reviewer phases
• Available models by provider reference table
• Budget-friendly configuration examples with cost optimization guidance

New Getting Started Guide (#462)

• Comprehensive setup guide with provider-specific instructions
• Step-by-step workflow examples for new users

Terms of Service (#461)

• Added Terms of Service link to README and CLI help

---

Full Changelog: v0.7.0...v0.8.1

v0.7.6

Release Notes (v0.7.0 → v0.7.6)

🎉 New Features

Session Summaries Posted to Your PRs (#468)

• When using github-pr or github-draft-pr merge mode, session summaries are now posted directly to your PR instead of the issue
• Keeps implementation context right where reviewers need it

Images from Issues Download Automatically (#469)

• Images referenced in GitHub and Linear issues are now downloaded and cached locally
• Claude can see screenshots, mockups, and diagrams directly from your issues
• Supports both markdown and HTML image formats with automatic credential handling

Use GitHub PRs with Linear as Your Issue Tracker (#464, #465)

• iloom now fully supports using Linear for issue tracking while managing GitHub Pull Requests
• Create PRs via github-pr or github-draft-pr merge modes with Linear issues
• Start work on existing GitHub PRs with il start #42 even when Linear is your issue tracker
• Perfect for teams using Linear for project management but GitHub for code review

Fork Contributors Get Isolated Configuration (#456)

• New package.iloom.local.json file for fork-specific settings that don't affect upstream
• Automatically gitignored so your local config stays local
• The configuration wizard now detects forks and suggests local configuration by default

Development Port Now Available in Agent Context (#463)

• Claude now sees the development server port (e.g., PORT=3025) for web-capable looms
• Port is calculated from the issue number for consistent workspace isolation

🐛 Bug Fixes

--no-code Flag Now Correctly Skips IDE Validation (#459)

• Fixed issue where il start --no-code still required a valid IDE command
• Analysis-only workflows now work without VS Code or other IDE installed

JSON Output No Longer Corrupted by Update Notifications (#457)

• Fixed issue where --json output could be corrupted by version update notifications

Active Looms Count Now Includes Child Looms (#467)

• Fixed il projects to correctly count child looms in active loom totals
• Added cross-platform path handling for Windows compatibility

Claude Interactive Sessions Work Correctly (#458)

• Fixed error when Claude tried to help with merge conflicts or validation errors
• The --no-session-persistence flag is now only used in headless mode where it's valid

📚 Documentation

New Getting Started Guide (#462)

• Comprehensive setup guide with provider-specific instructions
• Step-by-step workflow examples for new users

Terms of Service (#461)

• Added Terms of Service link to README and CLI help

---

Full Changelog: v0.7.0...v0.7.6

v0.7.5

Release Notes (v0.7.0 → v0.7.5)

🎉 New Features

Use GitHub PRs with Linear as Your Issue Tracker (#464, #465)

• iloom now fully supports using Linear for issue tracking while managing GitHub Pull Requests
• Create PRs via github-pr or github-draft-pr merge modes with Linear issues
• Start work on existing GitHub PRs with il start #42 even when Linear is your issue tracker
• Perfect for teams using Linear for project management but GitHub for code review

Fork Contributors Get Isolated Configuration (#456)

• New package.iloom.local.json file for fork-specific settings that don't affect upstream
• Automatically gitignored so your local config stays local
• The configuration wizard now detects forks and suggests local configuration by default

🐛 Bug Fixes

--no-code Flag Now Correctly Skips IDE Validation (#459)

• Fixed issue where il start --no-code still required a valid IDE command
• Analysis-only workflows now work without VS Code or other IDE installed

JSON Output No Longer Corrupted by Update Notifications (#457)

• Fixed issue where --json output could be corrupted by version update notifications

Active Looms Count Now Includes Child Looms (#467)

• Fixed il projects to correctly count child looms in active loom totals
• Added cross-platform path handling for Windows compatibility

Claude Interactive Sessions Work Correctly

• Fixed error when Claude tried to help with merge conflicts or validation errors
• The --no-session-persistence flag is now only used in headless mode where it's valid

PORT Now Injected for Web-Capable Looms

• Claude now sees the development server port in prompts for looms with web capability
• Port is calculated from the issue number, not environment variables

📚 Documentation

New Getting Started Guide (#462)

• Comprehensive setup guide with provider-specific instructions
• Step-by-step workflow examples for new users

Terms of Service (#461)

• Added Terms of Service link to README and CLI help

---

Full Changelog: v0.7.0...v0.7.5

v0.7.1

Release Notes (v0.7.0 → v0.7.1)

🎉 New Features

Fork-Friendly Configuration

• Contributors working on forked repos can now use .iloom/package.iloom.local.json to customize how iloom interacts with non-JS/TS projects without affecting the upstream project (#456)
• The configuration wizard now detects when you're working in a fork and defaults to local configuration files

---

Full Changelog: v0.7.0...v0.7.1

v0.7.0

Release Notes (v0.6.1 → v0.7.0)

🎉 New Features

Smarter Complexity Detection

• iloom now detects architectural uncertainty that would otherwise be missed by simple code analysis (#449)
• Issues involving external constraints, uncertain approaches, new patterns, or integration points are automatically routed to the COMPLEX workflow
• This ensures thorough planning before implementation for tasks that require broader architectural thinking

Track Your Finished Work

• New il list --finished flag shows completed looms with finish timestamps (#435)
• Use il list --all to see both active and finished looms together
• Finished looms are preserved for historical reference and team visibility

Commit Without Finishing

• New il commit command lets you make commits during a loom session without completing the workflow (#425)
• Automatically adds issue reference trailers (Refs #123 or Fixes #123) for consistent commit history
• Supports --wip-commit for quick work-in-progress saves that skip validations
• Works with both GitHub (#123) and Linear (ENG-123) issue formats

Create Issues from Claude

• Claude can now create new issues directly in your issue tracker (#418)
• Create child issues linked to parent issues for better work breakdown (#446)
• Works with both GitHub and Linear

Introducing Parallel Multi-Step Workflows

• Enhanced planning templates for complex tasks with multiple implementation steps (#438)
• Better support for parallel step execution and step consolidation

Alphanumeric Issue ID Support

• Port assignment now works with Linear-style IDs like MARK-324 (#420)
• Ports wrap around gracefully when exceeding system limits

🐛 Bug Fixes

Rebase Workflow

• Dependencies now install automatically after successful rebase (#422)
• Post-rebase builds run for CLI projects (#427)

Finish Workflow

• Metadata is now archived after finish or cleanup (#443)
• Placeholder commits no longer include issue references that could confuse PR descriptions (#444)
• Cleanup flags work consistently across all merge modes (#442)

Template Processing

• Fixed Handlebars parsing of JSON content in configuration templates (#429, #432)

Recap Server

• Duplicate entries are now automatically prevented (#447)

📚 Documentation

• Enhanced contributing documentation with clearer fork/contributor workflows (#433)
• Updated README to better explain specialized agent roles
• Clarified configuration storage requirements for fork contributors

---

Full Changelog: v0.6.1...v0.7.0

v0.6.1

Release Notes (v0.6.0 → v0.6.1)

🎉 New Features

Contribute to Any GitHub Repository

• iloom contribute now accepts a repository parameter, making it easy to set up any open source project for contribution
• Supports multiple URL formats: owner/repo, github.com/owner/repo, or full HTTPS URLs
• Automatically configures draft PR mode so your Claude sessions post artifacts directly to your PR

Smarter Rebase Conflict Resolution

• Claude now has auto-approved access to safe git commands during conflict resolution (status, diff, log, add, rebase continue/abort)
• Resolves conflicts faster without requiring manual approval for each command
• Destructive commands (reset, checkout) still require approval to prevent accidental data loss

✨ Improvements

Automatic Settings Gitignore

• Local settings files (.iloom/settings.local.json) are now automatically added to your global gitignore
• Previously required running il init manually

🐛 Bug Fixes

Third-Party Repository Pull Requests

• Fixed PR creation for contributed repositories—iloom now uses the repository's default branch instead of assuming main

---

Full Changelog: v0.6.0...v0.6.1