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

v0.6.0

Release Notes (v0.5.0 → v0.6.0)

🎉 New Features

Multi-Language Project Support

• Work on Python, Rust, Ruby, Go, and other non-Node.js projects with full iloom capabilities
• New .iloom/package.iloom.json configuration file lets you define scripts as raw shell commands
• il init now detects your project's language and offers to generate appropriate configuration
• iloom intelligently routes script execution: package manager for Node.js, direct shell for everything else

New Build Workflow Commands

• il build - Run your project's build script
• il lint - Run your linter
• il test - Run your test suite
• il compile / il typecheck - Run type checking with automatic fallback between compile and typecheck scripts
• il dev-server - Now works with multi-language projects
• All commands use the configuration auto-detected by il init

IDE CLI Validation (#372)

• il start now verifies your configured IDE's CLI tool is available before creating a workspace
• Provides installation hints when the CLI tool isn't found

Copy Gitignored Files to Looms (#400)

• New copyGitIgnoredPatterns setting copies local files (SQLite databases, test fixtures, sensitive configs) to each loom
• Supports glob patterns like *.db, **/*.sqlite, {data,fixtures}/*.sql
• One-way copy during il start - your main workspace stays unchanged

Enhanced Session Summaries (#363)

• Session summaries now incorporate recap data from your work session
• Better context capture for future reference and team knowledge sharing

Dark Mode Terminal Support (#373)

• Automatically detects macOS dark mode and adjusts terminal colors for better contrast
• Brighter color palette optimized for dark terminal themes

🐛 Bug Fixes

Linear API Token Configuration (#381)

• Linear API tokens configured in settings are now properly passed to the Linear service

Stale Looms Count (#399)

• Active loom counts now correctly exclude stale looms where the worktree no longer exists

Init Setup Flow (#397)

• Setup button now correctly hides after successful configuration
• Projects are marked as configured only after init completes successfully

Abort Commit Exit Code (#398)

• Aborting a commit now returns exit code 130 (matching Unix conventions) instead of silently succeeding

Description Validation with --body (#380)

• Description validation is now appropriately relaxed when using the --body flag

📚 Documentation

Contribution Guide Updates (#394)

• Clearer guidance on creating PRs with iloom for automatic context generation
• Updated default merge behavior to github-draft-pr for contributor workflows

Multi-Language Documentation

• Comprehensive guide for Python, Rust, Ruby, Go projects
• Script examples for all supported languages
• Secret storage limitations clearly documented

---

Full Changelog: v0.5.0...v0.6.0

v0.5.5

Release Notes (v0.5.4 → v0.5.5)

🎉 New Features

Copy Gitignored Files to Looms (#400)

• Looms can now include local files that aren't tracked by Git—like SQLite databases, test fixtures, or sensitive configuration
• Configure copyGitIgnoredPatterns with glob patterns (e.g., *.db, data/**/*.json) to specify which files to copy
• Files are automatically copied when creating looms, so your isolated environments work out of the box

---

Full Changelog: v0.5.4...v0.5.5

v0.5.4

Release Notes (v0.5.3 → v0.5.4)

🎉 Improvements

Clearer Assumption Documentation (#396)

• Improved how agents distinguish between scanning for existing answers and documenting their own assumptions
• Results in more transparent reasoning and better-documented decision-making in your issue comments

🐛 Bug Fixes

Accurate Loom Count Display (#399)

• Fixed stale looms appearing in the active looms count
• il list now correctly excludes looms where the worktree has been deleted externally

Proper Exit Code on Commit Abort (#398)

• When you cancel a commit during il finish, iloom now exits with the standard Unix code 130 (SIGINT)
• Scripts and automation can now correctly detect user-cancelled operations

VS Code Extension Setup Button Hidden After Configuration (#397)

• The VS Code extension's "configure iloom" button no longer appears after you've successfully run il init
• Projects are now properly marked as configured only when the configuration wizard completes successfully

---

Full Changelog: v0.5.3...v0.5.4

v0.5.3

Release Notes (v0.5.0 → v0.5.3)

🎉 New Features

Session Recap Integration with Session Summaries (#363)

• Session summaries now automatically incorporate your recap data for richer, more contextual handoff documentation
• Gracefully handles missing recap files without breaking the summary flow

Dark Mode Terminal Support (#373)

• Terminal colors now automatically adapt to your system's dark/light mode setting
• Brighter, higher-contrast color palette when running in dark terminals for improved readability

Markdown-Formatted Recap Output (#384)

• il recap now outputs beautifully formatted markdown with organized sections
• Easier to read and share session recaps

Linear API Token Configuration (#381)

• Configure your Linear API token directly in iloom settings
• No need to set environment variables manually

IDE Availability Validation (#372)

• iloom now checks if your configured IDE (VS Code, Cursor, etc.) is available before starting a workspace
• Provides helpful installation hints if your IDE isn't found

Relaxed Description Validation with --body Flag (#380)

• When providing a full --body for issues, iloom accepts any non-empty description
• Stricter validation only applies when you're not providing a detailed body

📚 Documentation

Updated Contribution Guide (#394)

• Clarified how to create PRs with proper context using iloom
• Documented that iloom automatically posts AI analysis and implementation plans to PRs

---

Full Changelog: v0.5.0...v0.5.3

v0.5.0

🎉 New Features

Loom Recap: Track Decisions and Progress in Real-Time

• New il recap command provides instant access to your current loom's context: the goal, key decisions made, and artifacts created
• iloom agents now log important insights, assumptions, and risks as they work, building a persistent record of "why" alongside "what"
• Artifacts like comments, issues, and PRs are automatically tracked and displayed
• Use il recap [identifier] to check any loom's status from anywhere
• Complexity assessments (trivial/simple/complex) are captured at routing points to inform future planning

Draft PR Mode for Collaborative Workflows

• New github-draft-pr merge behavior creates a draft PR immediately when you start a loom
• Session summaries and agent analysis are posted directly to the PR, keeping everything in one place
• On il finish, the draft is automatically marked ready for review
• Ideal for fork contributions and teams requiring PR-based workflows (#360, #367)

Improved Post-Workflow Assistance

• After completing their primary task, agents can now route you to specialized help for common next steps
• Clear guidance for navigating between looms, finishing work, and getting additional help (#355)

🐛 Bug Fixes

Rebase Before Validation

• Looms now rebase onto main before running validation, ensuring tests run against the latest code (#344)

PR-to-Issue Linking

• When starting a loom from a PR that references an issue (via branch naming), the issue is now properly linked in loom metadata (#349)

✨ Improvements

Environment Variable Loading for Dev Servers

• New sourceEnvOnStart setting automatically loads .env files when starting dev servers
• Ensures your workspace-specific environment is applied without manual configuration (#339)

Issue and PR Link Tracking

• Loom metadata now tracks all related GitHub issue and PR URLs
• JSON output includes these links for integration with external tools (#342)

Configurable Attribution

• Control when iloom attribution appears in session summaries: never, only for forks, or always (#341)

Deprecated Shell Autocomplete

• Removed shell autocomplete setup from il init (#343)

---

Full Changelog: v0.4.1...v0.5.0

v0.4.1

Release Notes (v0.4.0 → v0.4.1)

🎉 New Features

Open Interactive Workspace Terminals (il shell)

• Instantly open a shell inside any workspace with full environment setup
• Automatically loads workspace environment variables when sourceEnvOnStart is enabled
• Sets ILOOM_LOOM environment variable for PS1 customization so you always know which loom you're in
• Works with issues, PRs, or branch identifiers with auto-detection
• Integrates seamlessly with multi-terminal mode (#335)

Smart Editor Integration for Commit Messages

• iloom now detects and uses your IDE's terminal to edit commit messages
• Supports Antigravity, Cursor, and VS Code with automatic priority detection
• Falls back gracefully when preferred editor isn't available (#333, #334)

Project Path Tracking

• Looms now remember which project they belong to via projectPath metadata
• Enables better project identification across multiple repositories (#340)

🐛 Bug Fixes

Branch Mode CLI Isolation

• CLI isolation is now correctly skipped in branch mode environments (#338)

Quieter Environment File Handling

• Missing .env files are now logged at debug level instead of showing warnings (#337)

---

Full Changelog: v0.4.0...v0.4.1

v0.4.0

Release Notes (v0.3.0 → v0.4.0)

🎉 New Features

Child Loom Support

• Create nested looms to tackle sub-tasks while preserving context (#316)
• Child looms automatically track their parent relationship
• Merge target resolution intelligently routes changes back to the correct branch (#328)

Session Resumption

• Claude sessions now persist with deterministic session IDs (#305)
• Resume your conversation exactly where you left off when switching between looms
• Automatically reconnects to in-progress sessions

Automatic Session Summaries

• Capture key decisions and lessons learned when finishing a loom (#308)
• Summaries are posted to your issue tracker as permanent project knowledge
• Configure the summary model via settings.summary.model

VSCode Integration Improvements

• Claude Code hooks for session state monitoring (#311)
• VSCode-specific commit message editing flow (#310)

New Commands

• il dev-server (alias dev) - Start your dev server in a loom workspace (#292)
• il projects - List all configured iloom projects (#312)
• il summary - Manually generate session summaries

JSON Output for Automation

• il start --json for CI/CD integration (#304)
• il finish --json and il cleanup --json for scripted workflows (#306)
• il add-issue --json and il enhance --json for programmatic access (#300)

Configuration Enhancements

• Separate terminal and VSCode color settings (#258)
• Global color collision avoidance across all projects (#284)
• Configurable spin orchestrator model (#228)
• dotenv-flow support (.env, .env.local, .env.{NODE_ENV}) (#254)

TRIVIAL Complexity Classification

• Skip analysis and planning phases entirely for trivial tasks (#285)
• Get straight to implementation on simple changes

Antigravity IDE Support

• Full support for the Antigravity IDE (#274)

🐛 Bug Fixes

• Fix GitHub CLI validation for multi-remote repositories (#266)
• Fix comment ID format in GitHub issue management (#270)
• Fix merge safety checks to prevent accidental data loss (#275)
• Fix prompt functions to re-prompt on invalid input instead of silently defaulting
• Fix setRawMode errors in non-TTY environments (VS Code command palette, CI)
• Fix symlink resolution in project path checks (#313)
• Fix headless mode prompt handling in Claude CLI calls (#329)
• Handle Ctrl+C gracefully in prompt utility (#282)

📚 Documentation

• Comprehensive command reference documentation
• New "Is iloom Right for You?" guide for different team sizes
• Updated README with session summaries feature

---

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Release Notes (v0.2.0 → v0.3.0)

🎉 New Features

Enhanced AI Analysis Intelligence (#232)

• Comprehensive research framework guides AI agents through systematic problem investigation
• Agents follow structured research hierarchy: Skills → Context7 → WebSearch
• Quality controls prevent generic or templated analysis that looks thorough but lacks substance
• Cross-cutting change analysis helps identify broader impacts before implementation begins
• Results in better-informed plans and fewer surprises during development

Linear Issue Tracking Support (#237, #263)

• Full support for Linear issues alongside GitHub
• Native Linear SDK integration for reliable issue management
• Works with Linear issue identifiers (e.g., TEAM-123)
• Configure your Linear API token and start working with Linear issues immediately
• All iloom workflows (start, finish, enhance) work seamlessly with Linear

Multi-IDE Support (#200)

• Choose your preferred editor: VSCode, Cursor, WebStorm, Sublime Text, IntelliJ, or Windsurf
• Configure via ide setting in .iloom/settings.json
• iloom automatically detects which editors are installed
• VSCode remains the default for seamless upgrade experience

Global Settings (#260)

• Define iloom defaults across all your projects with ~/.config/iloom-ai/settings.json
• Settings hierarchy: CLI args → local → project → global → defaults
• Perfect for personal preferences like IDE choice, ports, or workflow settings
• Project-specific settings still take precedence

First-Run Setup Experience (#202)

• Automatic detection when iloom hasn't been configured yet
• Interactive setup wizard launches automatically for first-time users
• Seamless onboarding before running your first command

Child Loom Support (#217)

• Work on subtasks, bug fixes, or experiments without leaving your current context
• Child looms automatically inherit database state and branch from parent workspace
• Dedicated subdirectory structure keeps parent and child workspaces organized
• Warnings when finishing parent looms that have active children
• Enables safe isolation for breaking down complex issues into smaller pieces

Quick Configuration Updates (#234)

• Quickly tell il init what changes you want without going through the full wizard
• Example: il init "use Cursor as my IDE"
• Skip the interactive prompts when you know exactly what to configure

Configurable Environment Sourcing (#244)

• New sourceEnvOnStart setting controls whether .env files are sourced when launching terminals
• Provides shell compatibility control for different development environments
• Useful when your shell doesn't support automatic environment loading

Enhanced Issue Creation

• --body option for il start and il feedback commands lets you provide custom issue descriptions (#253)
• Streamlined issue creation workflow removes unnecessary enhancement steps (#251)
• Get straight to work without waiting for AI processing during issue creation

🐛 Bug Fixes

Settings Deep Merge (#235)

• Fixed settings merge logic to preserve non-default values from base configuration
• Local overrides now properly respect base settings without overwriting them

Existing Branch Support (#187)

• Fixed error when trying to create looms from existing branches
• You can now start looms from branches you created outside iloom
• Reduces friction when transitioning existing work into the iloom workflow

CLI Symlink Cleanup (#243)

• CLI tool symlinks are now properly cleaned up when removing workspaces
• Extracts issue numbers from branch names to find and remove the correct executables

Non-Git Directory Handling (#230)

• Commands now gracefully handle being run outside git repositories
• No more cryptic error messages when accidentally running il list in the wrong directory
• il init no longer fails when run in non-git directories

📚 Documentation

Contributing Resources (#252)

• Comprehensive contributing guide with setup instructions and workflow details
• Code of conduct establishing community standards
• Clear guidance for new contributors on finding starter tasks

Linear Integration Documentation (#237)

• Complete setup guide for Linear issue tracking
• API token configuration instructions
• Examples of Linear workflows with iloom

README Improvements

• Added screenshot showing iloom in action
• Updated known limitations section with better formatting
• Clarified iloom's core purpose and value proposition
• Multi-IDE configuration documentation
• Global settings usage examples

---

Full Changelog: v0.2.0...v0.3.0

v0.2.0

This is a major release with significant new features, a complete rebrand from Hatchbox to iloom, and numerous quality-of-life improvements.

🎨 Rebrand: Hatchbox → iloom

The project has been completely rebranded from "Hatchbox" to "iloom". Migration is automatic:

• Settings migrate automatically from .hatchbox/ to .iloom/
• The hatchbox CLI automatically migrates to iloom on update
• Both iloom and il command aliases are now supported in shell completion (#224)

✨ New Features

New Commands:

• il rebase - Claude-assisted rebase with conflict resolution guidance (#209)
• il contribute - Streamlined contributor onboarding workflow (#220)
• il feedback - Submit feedback with automatic diagnostic information (#173, #179)
• il spin - Renamed from ignite (alias preserved for backwards compatibility) (#206)

Merge Mode Configuration (#124)

• Choose between local merge or GitHub PR workflows via mergeMode setting
• New PRManager for handling GitHub PR creation and management
• Configurable per-project to match your team's workflow

Enhanced Init Command (#184)

• Claude-guided interactive configuration
• Walks you through setting up iloom for your project

First-Time User Experience (#223)

• Onboarding context for new users
• Guided introduction to iloom capabilities

iTerm2 Support (#189)

• Terminal launching now supports iTerm2 in addition to existing terminals
• Claude tab launches last for better UX (#180)

Multi-Remote Repository Support (#219)

• Select which GitHub remote to use when multiple remotes are configured
• Helpful for fork-based workflows

⚙️ Configuration & Settings

• Configurable database URL environment variable name (#168)
• Neon database provider configuration with refactored components (#222)
• Custom executable path and arguments in LoomLauncher
• Settings now copied to worktrees - .env and iloom settings are copied (#186)
• Local settings file (settings.local.json) for untracked configuration

🔧 Improvements

• Terminal close warning when finishing from within loom directory (#216)
• Ask for confirmation before proceeding instead of stopping (#227)
• CI environment variable set when running scripts (#170)
• Update notifier improvements with better caching and debugging
• Test optimizations for faster test execution
• Schema export script added to build process

📝 Documentation

• Technical architecture documentation added
• Enhanced planning documentation with DRY principles
• Updated README with clearer examples and configuration options

🐛 Bug Fixes

• Fixed handling of empty repositories
• Fixed update command npm installation handling
• Removed unused legacy package detection

📄 License

• License updated to BUSL-1.1

---

Full Changelog: acreeger/iloom-cli@v0.1.4...v0.2.0