Kode Agent Sdk

KODE SDK

[English](./README.md) | [中文](./README.zh-CN.md)

Event-driven, long-running AI Agent framework with enterprise-grade persistence and multi-agent collaboration.

Features

• Event-Driven Architecture - Three-channel system (Progress/Control/Monitor) for clean separation of concerns
• Long-Running & Resumable - Seven-stage checkpoints with Safe-Fork-Point for crash recovery
• Multi-Agent Collaboration - AgentPool, Room messaging, and task delegation
• Enterprise Persistence - SQLite/PostgreSQL support with unified WAL
• Cloud Sandbox - E2B and OpenSandbox integration for isolated remote code execution
• Extensible Ecosystem - MCP tools, custom Providers, Skills system

Quick Start

**One-liner setup** (install dependencies and build):

./quickstart.sh

Or install as a dependency:

npm install @shareai-lab/kode-sdk

Set environment variables:

**Linux / macOS**

export ANTHROPIC_API_KEY=sk-...
export ANTHROPIC_MODEL_ID=claude-sonnet-4-20250514  # optional, default: claude-sonnet-4-20250514
export ANTHROPIC_BASE_URL=https://api.anthropic.com  # optional, default: https://api.anthropic.com

**Windows (PowerShell)**

$env:ANTHROPIC_API_KEY="sk-..."
$env:ANTHROPIC_MODEL_ID="claude-sonnet-4-20250514"  # optional, default: claude-sonnet-4-20250514
$env:ANTHROPIC_BASE_URL="https://api.anthropic.com"  # optional, default: https://api.anthropic.com

Minimal example:

import { Agent, AnthropicProvider, JSONStore } from '@shareai-lab/kode-sdk';

const provider = new AnthropicProvider(
  process.env.ANTHROPIC_API_KEY!,
  process.env.ANTHROPIC_MODEL_ID
);

const agent = await Agent.create({
  provider,
  store: new JSONStore('./.kode'),
  systemPrompt: 'You are a helpful assistant.'
});

// Subscribe to progress events
for await (const envelope of agent.subscribe(['progress'])) {
  if (envelope.event.type =