waazy-w

Claude Phantom — Git skill for Claude Code

Git community

Autonomous crash recovery for your terminal: wrap a command; on crash, headless Claude Code diagnoses, tests, patches on a branch, and writes a post-mortem.

How to install Claude Phantom

This entry records only its repository, not the path inside it, so there is no exact command to give. Open waazy-w/claude-phantom and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Phantom does

Autonomous crash recovery for your terminal: wrap a command; on crash, headless Claude Code diagnoses, tests, patches on a branch, and writes a post-mortem.

Alternatives in Git

GitHub Review PR — Use when a PR needs full review — resolves merge conflicts with the base first, then fixes CI failures, then a 1.5k ★
Fix GitHub Issue — by jeremymailen - Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue detai 708 ★
MiniCode Roadmap — MiniCode already has a usable lightweight terminal coding workflow, but there is still a visible gap between t 388 ★

README

claude-phantom

**[claudephantom.dev](https://claudephantom.dev)**

An autonomous crash-recovery agent for your terminal. Run your app through `phantom`; if it crashes, a headless Claude Code session diagnoses the bug, writes a failing test, patches it on a separate branch, verifies the fix independently, and leaves a post-mortem. Your branch is never touched.

![phantom recovering a crashed Node service: the app throws, phantom opens a fix branch, patches it, runs the tests itself, and writes a post-mortem](docs/demo.gif)

[![ci](https://github.com/waazy-w/claude-phantom/actions/workflows/ci.yml/badge.svg)](https://github.com/waazy-w/claude-phantom/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/claude-phantom.svg)](https://www.npmjs.com/package/claude-phantom) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![node >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](package.json) [![zero dependencies](https://img.shields.io/badge/dependencies-0-success.svg)](package.json)

Setup

**You need:** Node >= 18, git (phantom only recovers inside a git repository), and the Claude Code CLI, logged in:

npm install -g @anthropic-ai/claude-code
claude                         # follow the login prompt once

**Install and run:**

npm install -g claude-phantom
phantom npm run dev            # any command; phantom is invisible until it crashes

That is the whole setup. On a crash, phantom creates `phantom/fix--`, fixes it there, verifies, writes `.phantom/reports/-.md`, and puts you back on your branch with `git diff` / `git merge` / `git branch -D` commands to revie