Skip to content
Applied AI, product engineering, and notes from the workLearn more

Open source · AGPL-3.0

Khadim

A local-first terminal coding agent. Interactive or headless, with a typed SDK and JSON event stream, 19+ providers, and tools that run locally. Desktop Agents (Alpha) and Studio (Beta) are in progress — not shipped yet.

  • Local-first
  • Interactive + headless
  • Typed SDK
  • WASM plugins
  • 19+ providers
Khadim Electron home screen
19+AI providers
2Run modes
LocalWorkspace tools
AGPL-3.0License

What Khadim does today

The CLI coding agent is the stable entry point today. The same agent engine and event stream power the desktop app, web app, SDK, and plugins.

01

Interactive terminal + headless exec

Streaming terminal UI with slash commands, saved sessions, and provider/model switching. Or run a single task headless with --prompt and exec, and stream JSON events with --json for scripts and CI.

02

Typed SDK and JSON events

Embed Khadim in Node.js apps with runAgentStream. The same normalized event stream — text_delta, step_start, step_update, step_complete, question, done, error — drives the CLI, desktop, and web.

03

19+ providers, including local

OpenAI, Anthropic, Gemini, Groq, xAI, OpenRouter, Mistral, Cerebras, Copilot, Codex, and local-compatible options. Credentials are read from environment variables or the interactive settings panel.

04

WASM plugin sandbox

Plugins are sandboxed WebAssembly modules that expose tools to the agent. A manifest requests fs, http, store, and desktop UI capabilities. Tools run locally, on your machine, unless you opt into a remote runner.

Platform direction and status

One shared agent engine. The CLI is the workhorse today; desktop and web are active build surfaces — tracked as Alpha/Beta, not as finished products.

  • CLI coding agentShipped

    apps/khadim-cli — interactive terminal UI, headless exec, SDK, and npm package.

  • Agent engine & providersShipped

    crates/khadim-ai-core and khadim-coding-agent — provider integrations, model registry, agent loop, sessions.

  • DocumentationShipped

    Astro Starlight docs site at unravelaidk.github.io/khadim.

  • Desktop — AgentsAlpha

    Electron desktop prototype for agent runs and local projects. Under active development.

  • Desktop — StudioBeta

    Artifact workspace for documents, React sites, and canvases in the desktop prototype.

Start with the CLI today

Khadim runs locally and calls the provider you configure. Install the npm package or use the installer script — desktop and web arrive incrementally.