Spin up a shadow
A native Git worktree gives each agent a clean, isolated branch of your project.
Introducing Git Ghost v0.1 Open Source Shadow Worktree Daemon
Run AI Agents in the Background.
Never Lock Your Workspace.
Git worktrees give each agent its own folder and branch in the same repository. Git Ghost is designed to run Claude Code, Codex, and local agents there while you keep editing main.
See the ghost at work A LITTLE PREVIEW
Git Ghost terminal demonstration
# 1. Install the ghost CLI $ npm install -g git-ghost # 2. Launch an AI agent in a background shadow worktree $ ghost run "Refactor auth middleware to OAuth2" [👻 Ghost] Created shadow worktree (.git/ghost/task-101) [👻 Ghost] Running Claude Code in background... [██████████] 100% [👻 Ghost] Running test suite... PASS (14/14) # 3. Preview and merge when ready $ ghost merge 101 ✔ Successfully fast-forwarded 4 files into main workspace!
Designed to work alongsideClaude CodeCursorCodexlocal agents
THE SHADOW WORKFLOW
Your workspace stays yours.
Git Ghost puts agent work in its own corner of the repo. You keep moving in the one you know.
Keep your flow
The agent works in the background. Your main workspace stays open for you.
Review, then merge
Inspect the changes and bring them back when they’re ready. Fast-forward only when Git allows it.
UNDER THE HOOD
One repository. Two working directories.
A native Git worktree is an additional working directory linked to the same repository. It shares commit history, while checking out its own files on its own branch.
You · main workspace
my-repo/
src/auth.tsedited by you
Your edits stay here
Agent · shadow worktree
.git/ghost/task-101/
src/auth.tsagent's version
Agent changes stay here
- Start from a committed point in your project.
- Ghost creates a task branch and shadow directory.
- The agent builds and tests there as you edit the main directory. Uncommitted main edits are not copied over.
- Review the diff and test results, then choose whether to integrate.
- Fast-forward is possible only when main is an ancestor of the task branch. If they diverge, reconcile them before integrating.
Scope: Worktrees isolate checked-out files, not processes or shared services. They are not a security sandbox.
Read the official Git worktree documentationISOLATION BY DESIGN
Parallel work.
Separate paths.
Worktrees share your repository history while giving each task its own working tree and branch. Agent changes stay apart from your active files until you review them.
Merging depends on the branch relationship and any changes made in the meantime.
main workspaceyour active filesYOU
branch
shadow worktreeagent task-101ISOLATED
changes stay here until you review
GOOD QUESTIONS
A few things to know.
Does Git Ghost run the AI agent for me?
Git Ghost is designed to launch supported coding agents inside a shadow worktree. This page is a product preview; it does not run an agent or install the daemon.
Will changes merge automatically?
No. The demo illustrates a successful fast-forward. In a real repository, Git can fast-forward only when the branch relationship permits it. Review changes and resolve divergence or conflicts as needed.
What happens after I join?
Your email and consent record are stored so the Git Ghost website operator can manage the waitlist and contact you about early access. A request does not guarantee an invitation, and no email is sent automatically. See the Privacy Policy for details or to make a privacy request.
Give your agents
room to work.
Join the waitlist Request early access. An invitation is not guaranteed.