Skip to main content
Guide · How-to

Install senkani

Clone the repo, build with Swift Package Manager, register hooks, launch the workspace. Three minutes end-to-end on Apple Silicon.

Prerequisites

Step 1 · Clone + build
git clone https://github.com/ckluis/senkani
cd senkani
swift build -c release

First build takes ~4 minutes. Subsequent builds are incremental.

Step 2 · Register
.build/release/senkani init

Writes the hook binary to ~/.senkani/bin/senkani-hook, appends an MCP server entry to ~/.claude/settings.json, registers PreToolUse + PostToolUse hooks. Idempotent — safe to re-run.

Step 3 · Verify
.build/release/senkani doctor

Should report all green: MCP server registered, hooks registered, binary path resolved, grammar versions within window. If anything is amber or red, run senkani doctor --fix.

Step 4 · Launch the workspace
.build/release/senkani

SwiftUI workspace opens. ⌘K opens the pane palette; start with an Analytics pane to watch your first session compress.

If you don't use Claude Code

If you use Cursor, Copilot, or another agent that doesn't speak MCP, skip the server registration and install hooks only:

.build/release/senkani init --hooks-only

You get the filter pipeline and smart denials, but not the 19 MCP tools.

Next

Wire up Claude Code →