Quickstart

Get Semantica tracking AI activity in your repository in under two minutes.

Step 1: Install

Homebrew (macOS)

brew install semanticash/tap/semantica

Shell script (macOS / Linux)

curl -fsSL https://semantica.sh/install.sh | sh

Verify the install

semantica --version

Step 2: Enable in your repo

Navigate to an existing Git repository and run:

cd /path/to/your/repo
semantica enable

This does four things:

Creates .semantica/ with a SQLite database and blob store
Installs pre-commit, commit-msg, and post-commit Git hooks
Auto-detects installed AI providers and sets up capture hooks for each
Creates a baseline checkpoint of the current state of your repository

You'll see output like:

✓ Initialized .semantica/
✓ Installed Git hooks (pre-commit, commit-msg, post-commit)
✓ Detected providers: claude-code, cursor
✓ Created baseline checkpoint chk_abc123
Semantica is enabled. Every commit is now tracked.

Step 3: Make a commit

Work normally. Use your AI agent as you always would. When you commit:

git add .
git commit -m "add authentication module"

Semantica runs silently in the background. After a moment, a checkpoint is created, agent session data is ingested, and attribution is computed.

The commit message will include a trailer:

add authentication module

Semantica-Checkpoint: chk_def456
Semantica-Attribution: 78% claude_code (31/40 lines)
Semantica-Diagnostics: 3 files, lines: 28 exact, 2 modified, 1 formatted

Step 4: View attribution

See what percentage of a commit was AI-generated:

semantica blame HEAD

Get a full breakdown of what happened:

semantica explain HEAD

See all checkpoints:

semantica list

What's next

Connect to the dashboard: semantica auth login then semantica connect to push attribution to semantica.sh for team visibility and GitHub PR comments
Enable auto-playbook: semantica set auto-playbook enabled to generate LLM summaries of every commit
Enable MCP: semantica mcp enable to let your AI agents search past solutions
Explore commands: see the full Commands reference