https://github.com/priyashpatil/rift
A git worktree manager for parallel AI agent development
https://github.com/priyashpatil/rift
claude-code codex cursor developer-tools git-worktrees opencode vscode windsurf
Last synced: 28 days ago
JSON representation
A git worktree manager for parallel AI agent development
- Host: GitHub
- URL: https://github.com/priyashpatil/rift
- Owner: priyashpatil
- License: mit
- Archived: true
- Created: 2026-02-15T07:44:57.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-03T07:14:30.000Z (about 1 month ago)
- Last Synced: 2026-05-03T09:15:01.192Z (about 1 month ago)
- Topics: claude-code, codex, cursor, developer-tools, git-worktrees, opencode, vscode, windsurf
- Language: TypeScript
- Homepage: https://rift.priyashpatil.com
- Size: 726 KB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Rift
[](https://codecov.io/gh/priyashpatil/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
```bash
npm install -g @priyashpatil/rift
```
## Quick Start
```bash
# 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 `. 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](https://rift.priyashpatil.com).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, commit conventions, and code style.
## License
MIT