Loomen

Weave logic, seek lumen.

Vision

When AI Agents enter the development process, code evolution is no longer linear. A single idea can split into multiple paths, each growing independently, ultimately converging on the optimal solution.

Loomen provides the infrastructure for this evolution:

• Parallel Exploration — Run multiple Agents simultaneously, each trying a different approach
• Physical Isolation — Each branch exists independently in a Git Worktree, with zero interference
• Instant Backtracking — Return to any node, inheriting its code and context
• Selective Fusion — Pick the best solution and merge it back to the main line

A survival space for AI Agents. A decision space for developers.

Name

Loom (a weaving machine) + Lumen (a unit of light)

The loom weaves threads; lumen illuminates paths. Loomen weaves parallel universes of code, seeking the brightest path of evolution.

Install

bun link

Commands

weave — Spin up a new branch

Fork a new parallel universe from the current node and launch an AI Agent.

loomen weave "implement user authentication"

ray — Reveal node status

View the status of all nodes.

loomen ray

⚡ l_a1b2  PULSING   implement auth module
○ l_c3d4  IDLE      refactor database layer
● l_e5f6  FUSED     add logging system
⊘ l_g7h8  SEVERED   experimental feature

beam — Observe node logs

Stream real-time Agent logs for a specific node.

loomen beam l_a1b2

pulse — Broadcast commands

Broadcast a command to all active nodes.

loomen pulse npm test

fuse — Merge a node

Merge a node's work into a target branch.

loomen fuse l_a1b2              # merge into main
loomen fuse l_a1b2 --into dev   # merge into dev

sever — Cut a node

Terminate and clean up a node.

loomen sever l_a1b2

open — Open in editor

Open a node's working directory in your editor.

loomen open l_a1b2

Architecture

Hexagonal architecture, designed for future GUI/WebGL visualization:

Presentation  →  CLI / TUI / GUI
Application   →  weave / ray / pulse / beam / fuse / sever
Domain        →  LoomNode / LoomGraph / StateMachine
Infrastructure→  Git / FileSystem / Process adapters

Tech Stack

• Runtime: Bun
• Language: TypeScript
• Dependencies: Zero external dependencies
• Foundation: Git Worktree