Skip to main content

Anubis

AI-native version control. Semantic commits and reasoning traces on top of git.

Anubis helps AI coding assistants (Claude, Cursor, Copilot) preserve context across sessions. Create checkpoints that capture not just code state, but why changes were made.

The Problem

When working with AI coding assistants:

  • Sessions end and context is lost
  • You can't resume exactly where you left off
  • There's no record of the reasoning behind changes
  • Code review lacks the "why"

The Solution

Anubis wraps git and adds:

  • Checkpoints with reasoning traces ("I'm trying approach A because...")
  • File snapshots capturing content and diffs at each checkpoint
  • Semantic analysis detecting what changed (added function, renamed class)
  • AI-friendly output for injecting context into new sessions

Installation

pip install anubis-vcs

Requires Python 3.11+ and git.

Quick Start

# One-command setup (initializes + configures Claude Code)
cd your-project
anubis setup

# Or initialize manually
anubis init

# Create a checkpoint with reasoning
anubis checkpoint "Refactoring auth" -r "Trying JWT approach, moving from sessions"

# View checkpoint history
anubis log

# Resume with AI-optimized output (perfect for pasting into Claude/ChatGPT)
anubis resume abc123 --format=prompt

# See semantic analysis of changes
anubis analyze

Commands

Command Description
anubis setup One-command setup (init + MCP + hooks)
anubis init Initialize Anubis in a git repo
anubis checkpoint "msg" -r "reasoning" Create checkpoint with reasoning
anubis status Show current state and recent checkpoints
anubis log View checkpoint history
anubis resume <id> View checkpoint details
anubis resume <id> --format=prompt AI-optimized output for context injection
anubis resume <id> --format=json Machine-readable output
anubis analyze Semantic analysis of current changes
anubis commit "msg" -r "reasoning" Semantic commit (wraps git commit)
anubis hooks setup Set up Claude Code integration

Example: AI-Friendly Resume

$ anubis resume abc123 --format=prompt

Output:

# Checkpoint: abc123
**Message:** Refactoring auth system
**Created:** 2024-01-15T10:30:00

## Reasoning
Trying JWT approach. Sessions were causing issues with horizontal scaling.
Planning to add refresh token rotation next.

## Changed Files

### src/auth.py (modified)
diff
- from flask import session
+ import jwt
+
+ def create_token(user_id: str) -> str:
+     return jwt.encode({"user_id": user_id}, SECRET_KEY)

Copy this into your AI assistant to resume exactly where you left off.

Claude Code Integration

Connect Anubis directly to Claude Code via MCP for seamless checkpoint access:

# Add Anubis MCP server to Claude Code
claude mcp add anubis -- anubis-mcp

# Verify connection
claude mcp list

Once connected, Claude Code can:

  • List and resume from checkpoints automatically
  • Create checkpoints with reasoning during coding
  • Access semantic analysis of changes

Hooks (Auto-checkpoint)

Auto-checkpoint when Claude Code makes changes:

anubis hooks setup

Add the output to ~/.claude/settings.json to enable automatic checkpoints on file edits.

How It Works

  • Metadata stored in .anubis/ directory (gitignored)
  • Wraps git for file versioning
  • SQLite database for checkpoints and semantic data
  • AST parsing for Python/JavaScript semantic analysis

License

MIT

Metadata

Release files for anubis-vcs 0.5.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anubis-vcs 0.5.5
File Size Uploaded Provenance Actions
anubis_vcs-0.5.5.tar.gz 27.1 kB Without provenance Details for anubis_vcs-0.5.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for anubis-vcs 0.5.5
File Interpreter ABI Platform Actions
anubis_vcs-0.5.5-py3-none-any.whl Python 3 none any Details for anubis_vcs-0.5.5-py3-none-any.whl

Total release size: 53.6 kB

Release files / anubis_vcs-0.5.5.tar.gz

Download URL anubis_vcs-0.5.5.tar.gz
Size 27.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1c68092cb1e9edea54fd60e4b73b48b484bc97572c43209e86032ab22abbd123
BLAKE2b-256 checksum
How to use checksums
dca4072415d71cc8a7197b426722c22e2c04885c3d5cbda30e8a78b46150a86c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.11.16

Release files / anubis_vcs-0.5.5-py3-none-any.whl

Download URL anubis_vcs-0.5.5-py3-none-any.whl
Size 26.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c01502dc1e6cbd5ae2ceb584695d61c2ac1ed8445473bed78f130ead17908dcd
BLAKE2b-256 checksum
How to use checksums
4bac66bc7ebc42adf95912f6b84f72694b386b20f6b5c1381553b77a193f7a39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.11.16

Security for anubis-vcs 0.5.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page