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

# Initialize in a git repo
cd your-project
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 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

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

Download files

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

Source Distribution

anubis_vcs-0.1.0.tar.gz (18.0 kB view details)

Uploaded Source

Built Distribution

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

anubis_vcs-0.1.0-py3-none-any.whl (18.0 kB view details)

Uploaded Python 3

File details

Details for the file anubis_vcs-0.1.0.tar.gz.

File metadata

  • Download URL: anubis_vcs-0.1.0.tar.gz
  • Upload date:
  • Size: 18.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for anubis_vcs-0.1.0.tar.gz
Algorithm Hash digest
SHA256 db0ee32229f59574005ff37f165763be128a5e49d998867579b61bb4c7e1e990
MD5 14627a80c6797637fa47f5c0a7ca26df
BLAKE2b-256 41889cec31181a9e9a401d124c590525c3914b1084fee439cc6a77d98beb53bb

See more details on using hashes here.

File details

Details for the file anubis_vcs-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: anubis_vcs-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 18.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for anubis_vcs-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f3a54464f295f0da859cf008b6b987301eb3ff370adf4dd839ce0704d4b37171
MD5 32c51de6fd68a14fe7e19ab1766efb01
BLAKE2b-256 9adac6ca01cd5147c29d524f650030b2edd4aabb87168139c798c378b58ebe35

See more details on using hashes here.

Release history Release notifications | RSS feed

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

This release

0.1.0 This release

2 files

Supported by

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