Skip to content

tobert/kaijutsu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

619 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

会術 Kaijutsu

"The Art of Meeting"

Kaijutsu is an agentic kernel, MCP, and UI that offers a crdt-all-the-things approach to collaborative editing with multiple models and users participating in real time. The kernel relies on diamond-types-extended, our fork of diamond-types that completes Map, Set, and Register types alongside the existing Text CRDT.

Context forking and drift are central to the workflow. Any context can be forked for isolated exploration or threaded for parallel work on the same codebase. Drift is how contexts share knowledge without sharing conversation history — multiple agents (Claude, Gemini, local models, humans) work in parallel contexts on the same kernel, drifting findings between each other with optional LLM distillation.

Kaijutsu's kernel uses Cap'n Protocol over ssh for its network IO, inheriting the ease & flexibility of ssh key access.

Status

Kaijutsu is not released yet. The kernel feels solid and reliable, and diamond-types-extended seems to be stable. The UI is very work in progress but demonstrates the possibilities beyond the terminal. The MCP works well and can be used right away as MCP and hook receiver.

-Amy

Quick Start

# First time: add your SSH key
cargo run -p kaijutsu-server -- add-key ~/.ssh/id_ed25519.pub --nick amy --admin

# Terminal 1: Server
cargo run -p kaijutsu-server

# Terminal 2: Client
cargo run -p kaijutsu-app

Crates

kaijutsu-kernel

The kernel wraps up your filesystem, models, MCPs, and contexts in a remove server over ssh. It provides its own VFS, a tool registry, an LLM registry, an agent registry, a drift router, and a pub/sub FlowBus. Contexts can be forked any time, at which point the context can be edited and even switch models and tools.

kaijutsu-crdt

Block-based CRDT document model built on diamond-types-extended. Documents are DAGs of blocks — each block is an independently-editable CRDT text buffer with metadata (role, kind, status, parent). This is the shared state that all participants (models, humans, scripts) edit concurrently.

kaijutsu-server

SSH + Cap'n Proto RPC server (87 Kernel methods + 4 World methods). Handles authentication via SQLite-backed public keys, runs EmbeddedKaish for shell command execution, and routes file I/O through CRDT blocks via KaijutsuBackend.

kaijutsu-client

RPC client library. ActorHandle provides a Send+Sync interface with 34 methods, broadcast subscriptions for server events and connection status, and automatic reconnection that re-registers subscriptions.

kaijutsu-mcp

MCP server exposing the CRDT kernel to Claude Code, Gemini CLI, opencode, and other MCP clients. 25 tools across documents, blocks, drift, execution, and identity. Can run standalone (in-memory) or connected to kaijutsu-server.

cargo run -p kaijutsu-mcp

See crates/kaijutsu-mcp/README.md for tool documentation and configuration.

kaijutsu-telemetry

OpenTelemetry integration behind a telemetry feature flag. W3C TraceContext propagation through Cap'n Proto RPC, differentiated sampling rates via KaijutsuSampler, standard OTel envvars (OTEL_EXPORTER_OTLP_ENDPOINT).

kaijutsu-app

Bevy 0.18 GUI client with custom MSDF text rendering, vim-style focus-based input, a tiling window manager, and a constellation view for navigating contexts as a radial tree graph. See crates/kaijutsu-app/README.md for details on text rendering, theming, and the UI architecture.

Documentation

Doc Purpose
docs/kernel-model.md Authoritative kernel model — start here
docs/drift.md Cross-context communication design
docs/block-tools.md CRDT block interface
docs/diamond-types-fork.md Why we forked diamond-types
docs/telemetry.md OpenTelemetry integration
docs/design-notes.md Collected design explorations

Forked Dependencies

Fork Why
diamond-types-extended Completes Map/Set/Register types alongside Text CRDT

About

会術 Kaijutsu - agentic kernel, MCP, and UI featuring CRDT-based editing tools

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages