Rift

Git worktree manager for parallel AI agent development.

Rift lets you spin up isolated git worktrees, each with its own branch, and automatically launch an AI coding agent inside them. Work on multiple features simultaneously without stashing or switching branches.

Features

• Work on everything at once — every task gets its own isolated worktree and branch, so you never stash, switch, or wait again
• Bring any agent — Codex, Amp, Claude Code, OpenCode, or any CLI command — just plug it in
• Zero port conflicts — deterministic hash-based port mapping means every worktree runs services simultaneously without collisions
• Hooks that handle the busywork — auto-install deps, seed databases, assign ports — all triggered by worktree lifecycle events
• Launch and go — rift open creates the branch, sets up the worktree, and drops you in with your agent running

Install

npm install -g @priyashpatil/rift

Quick Start

# 1. Set up shell integration (one-time)
rift config

# 2. Restart your shell, then initialize a project
cd my-project
rift init

# 3. Open a worktree — creates a branch and launches your agent
rift open

# 4. When done, close the worktree and delete its branch
rift close

Supported Agents

Any CLI command works. Set it in rift.yaml or via rift config --agent <cmd>. Common agents include Codex, Amp, Claude Code, OpenCode, Copilot, Aider, Gemini, and Kiro.

Documentation

Full documentation including command reference, lifecycle hooks, and framework-specific guides is available at the docs site.

Contributing

See CONTRIBUTING.md for development setup, commit conventions, and code style.

License

MIT