Skip to main content

ProcessFork integration for Claude Code — adds /snapshot, /fork, /merge slash commands.

Project description

processfork-claude-code

ProcessFork integration for Claude Code. Adds three slash-commands inside any Claude Code session:

  • /snapshot [name] — captures the live session into a .pfimg and prints the CID.
  • /fork [N] [hint] — forks N divergent branches.
  • /merge <branch> [-> main] — three-way merge with conflict surfacing.

Install

pip install processfork-claude-code

Use

pf-wrap-claude --store ~/.processfork

This drops three command files into ~/.claude/commands/processfork/, configures PF_AGENT_KIND=claude-code in the env, and registers a hook script that taps the effect ledger on every tool call. Restart your Claude Code session and the commands appear under /.

How it works

The wrapper is a thin Python layer over the ProcessFork SDK (processfork). The slash-command files invoke processfork.snapshot, processfork.fork, and processfork.merge against your local store.

Tool-call interception goes through Claude Code's PreToolUse / PostToolUse hooks; each invocation is appended to the effect ledger with the side-effect class declared in ~/.processfork/tool-classes.toml (unknown tools default to irreversible — safe by default).

See agent_docs/integration-claude-code.md in the main repo for the full spec.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

processfork_claude_code-1.0.0.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

processfork_claude_code-1.0.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file processfork_claude_code-1.0.0.tar.gz.

File metadata

  • Download URL: processfork_claude_code-1.0.0.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for processfork_claude_code-1.0.0.tar.gz
Algorithm Hash digest
SHA256 9da2287b69a9196ac792972f7c5ab68d5de0b3aecb69023cbcfe249021a0f415
MD5 9b6cf0d9fd2c0a167e6bf841adbb2f2e
BLAKE2b-256 c7abb5fd616a0f36e432c8959e362886c3227ad37ed356fb19df52d13b5672f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for processfork_claude_code-1.0.0.tar.gz:

Publisher: release.yml on manav8498/processfork

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file processfork_claude_code-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for processfork_claude_code-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5cfd475f450127b45e86307eb38601283d035dfb0cda3123bfa993b94d56429c
MD5 bf01a6147eebd8b926561725a40288c0
BLAKE2b-256 949febfc4d632fd0c64632041e37068f577791fd202c592fad1c5cae28aeb657

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page