RepoKernel is the coordination layer between your AI coding agents and your Git repository. Every task runs in its own worktree, locked to declared file paths, sequenced by dependencies, and gated by review before anything reachesDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/xantorres/repokernel/llms.txt
Use this file to discover all available pages before exploring further.
main. No daemon, no cloud, no database — your repo is the source of truth.
Quickstart
Install RepoKernel and run your first AI coding task in under 60 seconds.
Core Concepts
Learn tasks, sprints, epics, queues, reviews, and gates — the full model.
CLI Reference
Every command, flag, and exit code documented with real examples.
Configuration
Configure paths, policies, worktrees, automation, and parallel execution.
Why RepoKernel
Running one AI coding agent is easy. Running three in parallel against the same repo is where things fall apart — state conflicts, double-dispatch, scope creep, and zero visibility. RepoKernel fixes each of these at the filesystem layer.Isolated Worktrees
Each task runs in its own
git worktree. Your main branch stays clean until review and merge.Atomic Sprint Claims
Two parallel
rk run invocations cannot both pick up the same sprint — claims are filesystem-atomic.Scope Enforcement
allowed_paths in sprint frontmatter flags out-of-scope edits at review time before merge.Review Gates
Configured checks must pass and a review verdict must be recorded before anything reaches
main.Merge-Safe Registry
A custom Git merge driver unions agent state by ID — no JSON conflict markers between parallel agents.
Crash Recovery
Failed or runaway agents leave a resumable run, not a corrupted repository.
Four Ways to Use It
Fastpath
One task, one worktree, done.
rk run -m "..." is the fastest path to agent-assisted coding.Agent-Operated
Install the bundled skill into Claude Code, Cursor, Windsurf, or Copilot so your agent drives
rk directly.Epics & Sprints
Multi-task projects with dependency graphs, parallel waves, and full audit trails.
Multi-Agent Fleet
Team status, merge-safe state, tracker and PR bridges for 3+ agents in parallel.
Guides
Parallel Waves
Run independent sprints concurrently with path-conflict detection and dependency ordering.
Agent Adapters
Configure Claude, Codex, Ollama, or a custom shell command as your coding agent.
CI Integration
Gate PRs with
rk validate using the official GitHub Actions composite action.Tracker Bridge
Import issues from Linear, Jira, and GitHub Issues and write status back.