LOOM

Linked Orchestration Of Multirepos — a Rust CLI/TUI that makes a distributed monorepo feel like a monorepo for the duration of a workstream.

The Problem

Developers working with tightly-coupled repositories face a growing friction problem. When a change in one repo requires corresponding changes in others, main checkouts become contested. Branches conflict, uncommitted changes block new work, and switching between parallel tasks means manual cleanup.

Git worktrees solve this for single repositories. But no tool coordinates worktrees across multiple repositories with lifecycle management, agent-ready environments, and cross-machine portability.

AI coding agents amplify the problem — they need clean, isolated, pre-configured multi-repo environments on demand.

How It Works

LOOM creates a centralized workspace directory containing correlated git worktrees — one per repo, all on a namespaced branch (loom/{workspace-name}). The workspace is self-contained, isolated from your main checkouts, and disposable when done.

~/workspaces/sipi-xyz/
├── .loom.json          # workspace manifest
├── CLAUDE.md           # generated — agent context
├── .claude/
│   └── settings.json
├── sipi/               # ← git worktree
├── dsp-api/            # ← git worktree
└── dsp-das/            # ← git worktree

Quick Start

# Install (pre-built binary — no Rust toolchain needed)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/subotic/loom/releases/latest/download/loom-cli-installer.sh | sh

# Or install from source
cargo install loom-cli

# First-time setup
loom init

# Create a workspace
loom new my-feature

# Check status
loom status

# Run a command across all repos
loom exec cargo check

# Push branches and sync state
loom save

# Tear down when done
loom down

Commands

For detailed usage, flags, and config reference, see docs/USER-GUIDE.md.

Command	Description
loom init	First-run setup — creates config with scan roots, workspace root, sync repo
loom new [name]	Create a workspace with correlated worktrees
loom add <repo>	Add a repo to the current workspace
loom remove <repo>	Remove a repo (refuses if dirty)
loom list / loom ls	List all workspaces
loom status [name]	Per-repo branch, dirty state, ahead/behind
loom exec <cmd>	Run a command across all repos in the workspace
loom shell [name]	Open a terminal in the workspace
loom save	Push branches and sync workspace manifest
loom open <name>	Reconstruct a workspace from sync manifest (cross-machine)
loom down [name]	Tear down a workspace (safe — warns on dirty repos)
loom refresh [name]	Regenerate agent files from current config
loom tui	Open the interactive TUI
loom update	Check for updates and install the latest version
loom completions <shell>	Generate shell completions (bash, zsh, fish, elvish, powershell)

Configuration

LOOM stores its config at ~/.config/loom/config.toml:

[registry]
scan_roots = ["~/_github.com"]    # where to discover repos

[workspace]
root = "~/workspaces"              # where workspaces live

[sync]
repo = "~/_github.com/user/pkm"   # git repo for cross-machine sync
path = "loom/"                     # directory within sync repo

[terminal]
command = "ghostty"                # terminal for `loom shell`

[agents]
enabled = ["claude-code"]          # agent integrations to generate

# [update]
# enabled = false                  # disable auto-update (default: true)

Loom checks for updates hourly on startup and notifies you when a new version is available. Run loom update to install. To disable: set LOOM_DISABLE_UPDATE=1 or add [update] enabled = false to config.

Agent Integration

Workspaces are agent-ready out of the box. LOOM generates:

• CLAUDE.md — workspace context with repo table, branches, and sources
• .claude/settings.json — additionalDirectories so Claude Code can access all repos

Drop into any workspace and start an AI coding session immediately.

Cross-Machine Sync

loom save pushes workspace manifests to a sync repo (e.g., your PKM). On another machine, loom open my-feature reconstructs the workspace — cloning missing repos, creating worktrees, and generating agent files.

License

MIT