MCPcopy Index your code
hub / github.com/Wirasm/kild

github.com/Wirasm/kild @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
171 symbols 487 edges 48 files 22 documented · 13%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

kild

kild v2 — a ground-up rewrite, under active development. kild was rebuilt from Rust to TypeScript on bun (engine + CLI) with a Tauri + SvelteKit cockpit. Expect churn while v2 stabilises. The original Rust implementation (v1) is preserved at the v1-rust tag and the archive/rust branch.

A developer cockpit for orchestrating coding-agent teams across projects. The human plans and reviews; agents (pi) automate the coding. kild gives observability and steering — a native UI to watch and steer many agents at once, plus a CLI any command-line agent can drive.

  • Engine (engine/, TypeScript on bun) — the agent runtime, daemon, and CLI. Runs each agent session in its own subprocess on the pi coding-agent SDK (native pi auth, real concurrency), and exposes them over HTTP + WebSocket.
  • Cockpit (app/, Tauri + SvelteKit) — a native window that talks to the engine over HTTP + WebSocket. The only Rust is the thin Tauri shell.

pi owns the agent runtime (providers, sessions, compaction, auth); kild owns orchestration (sessions, worktrees, projects, the cockpit). We don't reimplement what pi already does.

Run

cd app && bun install && bun run tauri dev   # builds the engine, opens the window

The engine on its own:

cd engine && bun install && bun run dev      # HTTP + WS on 127.0.0.1:4517
bun run cli -- run --model anthropic/claude-haiku-4-5 "what files are here?"

pi must be on PATH and authenticated (~/.pi/agent/auth.json).

See CLAUDE.md for principles and architecture.

Extension points exported contracts — how you extend this code

CockpitEvent (Interface)
(no doc)
engine/src/kild/observability.ts
Agent (Interface)
(no doc)
engine/src/kild/agents.ts
RunOutcome (Interface)
(no doc)
engine/src/kild/run.ts
RunRequest (Interface)
(no doc)
engine/src/kild/run.ts
RawAgentEvent (Interface)
(no doc)
engine/src/kild/events.ts

Core symbols most depended-on inside this repo

join
called by 36
engine/src/kild/comms-bus.ts
get
called by 15
engine/src/kild/room/room-registry.ts
prompt
called by 13
engine/src/kild/sessions.ts
send
called by 13
app/src/lib/api.ts
worktreePath
called by 12
engine/src/kild/worktree.ts
ensureWorktree
called by 12
engine/src/kild/worktree.ts
assertSafeBranch
called by 11
engine/src/kild/worktree.ts
findProject
called by 10
engine/src/kild/projects.ts

Shape

Function 93
Method 43
Interface 23
Class 12

Languages

TypeScript98%
Rust2%

Modules by API surface

engine/src/kild/sessions.ts18 symbols
app/src/lib/api.ts17 symbols
engine/src/kild/worktree.ts15 symbols
engine/src/kild/room/room-manager.ts14 symbols
engine/src/cli.ts11 symbols
engine/src/kild/comms-bus.ts9 symbols
engine/src/server.ts8 symbols
engine/src/kild/room/room-types.ts8 symbols
engine/src/kild/room/room-registry.ts8 symbols
engine/src/kild/agents.ts7 symbols
engine/src/worker.ts6 symbols
engine/src/kild/projects.ts6 symbols

For agents

$ claude mcp add kild \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact