---
title: Dojo — Section-level Agent Skills CLI and MCP server that streams only
  the context an agent needs — by Jad Madi (@jadmadi)
description: A static Go CLI and stdio MCP server for discovering, streaming,
  auditing, and synchronizing Agent Skills. Agents inspect a skill's table of
  contents, load one section instead of the whole file, resolve dependencies in
  topological order, and project skills across six coding harnesses. Catalogs
  are verified with SHA-256 digests before anything is installed.
href: /project/dojo/
author: Jad Madi
category: Developer Tools & Agents
domain: AI Agents & Ecosystem
status: Active CLI
license: Apache-2.0
year: "2026"
version: 1.3.0
---

# Dojo — Section-level Agent Skills CLI and MCP server that streams only the context an agent needs

A static Go CLI and stdio MCP server for discovering, streaming, auditing, and synchronizing Agent Skills. Agents inspect a skill's table of contents, load one section instead of the whole file, resolve dependencies in topological order, and project skills across six coding harnesses. Catalogs are verified with SHA-256 digests before anything is installed.

## Project Overview

- **Website**: https://jadmadi.net/project/dojo/
- **Version**: 1.3.0
- **Live Platform**: https://jadmadi.net/project/dojo
- **Repository**: https://github.com/jadmadi/dojo
- **Documentation**: https://github.com/jadmadi/dojo/blob/main/README.md
- **Domain**: AI Agents & Ecosystem
- **Category**: Developer Tools & Agents
- **Status**: Active CLI
- **Year**: 2026
- **License**: Apache-2.0 (permissive)
- **Author**: [@JadMadi](https://x.com/jadmadi)

## Quick Install & Run

### Linux & macOS

```bash
curl -fsSL https://raw.githubusercontent.com/jadmadi/dojo/main/scripts/install.sh | sh
```

### Windows (PowerShell)

```powershell
go install github.com/jadmadi/dojo/cmd/dojo@latest
```

## The Problem It Solves

Agent Skills load as whole files, so an agent that needs one procedure pays for the entire document in context. The same skills also scatter across per-harness folders and separate machines, where they drift and are maintained by hand.

## The Solution

Dojo indexes each skill's headings, streams a single section on demand, resolves dependencies in order, and bi-directionally reconciles the canonical .agents/skills store with every active harness. A linked personal registry carries the same skills between a laptop and a cloud VM.

## Key Features & Capabilities

- Section-level paging: `dojo toc` lists headings with byte sizes and `dojo load <skill>#<section>` streams one section
- Hybrid BM25 and reciprocal rank fusion search across federated catalogs
- Dependency graph with topological resolution and cycle detection (`--with-deps`)
- Bi-directional sync across Antigravity, Claude Code, Cursor, Windsurf, OpenCode, and Sila
- Personal Skills Registry that synchronizes skills.json between a laptop and a cloud VM
- Cloudflare Agent Skills Discovery RFC v0.2.0 support with SHA-256 digest verification
- Native stdio MCP server exposing 8 tools: find, toc, load, run, learn, doctor, sync, and profile
- Secret and prompt-injection scanning before a profile push
- Prebuilt binaries for Linux, macOS, and Windows on amd64 and arm64

## Technical Specifications & Architecture

- **Languages**: Go
- **Frameworks / Libraries**: Go standard library, yaml.v3
- **Architecture**: Single static binary, stdio JSON-RPC 2.0 MCP server, BM25 plus reciprocal rank fusion search, digest-verified catalog cache
- **License Model**: Apache-2.0

## Frequently Asked Questions

### Do I need to rewrite my existing skills?

No. Dojo reads the standard SKILL.md format with YAML frontmatter, and `dojo sync` imports skills it finds in supported harness folders before projecting them back out.

### Which coding agents does Dojo support?

Antigravity (Desktop and CLI), Claude Code, Cursor, Windsurf, OpenCode, and Sila, with .agents/skills as the canonical store.

### What does the MCP server expose?

Eight tools: dojo_find, dojo_toc, dojo_load, dojo_run, dojo_learn, dojo_doctor, dojo_sync, and dojo_profile, all over stdio JSON-RPC 2.0.

### Is Dojo related to KungFu?

Dojo began as a fork of the Apache-2.0 KungFu CLI by Daniela Petruzalek and is now independently maintained. Upstream credit is recorded in CREDITS.md.

## Links & References

- Project Page on Crosscurrent Code: https://jadmadi.net/project/dojo/
- Full Projects Directory: https://jadmadi.net/projects/
- Author Profile: https://jadmadi.net/about/