odysa

One Agent SDK — Development skill for Claude Code

Development community

One SDK for every agent.

How to install One Agent SDK

This entry records only its repository, not the path inside it, so there is no exact command to give. Open odysa/one-agent-sdk and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What One Agent SDK does

One SDK for every agent. Embed in-process agents — like Claude Code, ChatGPT Codex, and Kimi-CLI — directly into your TypeScript applications

Alternatives in Development

  • OpenAI Codex CLI — (Rust implementation) 67.8k ★
  • Mcporter — Call MCPs via TypeScript, masquerading as simple TypeScript API 4.1k ★
  • Open Agent SDK TypeScript — Agent-SDK without CLI dependencies, as an alternative to claude-agent-sdk, completely open source 2.6k ★

README

One Agent SDK

[![npm version](https://img.shields.io/npm/v/one-agent-sdk?style=flat-square&color=cb3837&label=npm)](https://www.npmjs.com/package/one-agent-sdk) [![CI](https://img.shields.io/github/actions/workflow/status/odysa/one-agent-sdk/ci.yml?style=flat-square&label=CI)](https://github.com/odysa/one-agent-sdk/actions/workflows/ci.yml) [![TypeScript](https://img.shields.io/badge/TypeScript-5.8-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](https://opensource.org/licenses/MIT) [![Python SDK](https://img.shields.io/badge/Python_SDK-3776AB?style=flat-square&logo=python&logoColor=white)](https://github.com/odysa/one-agent-sdk-python)

**Drop-in replacement for `@anthropic-ai/claude-agent-sdk` — same API, multiple providers.**


[Getting Started](#getting-started) · [Features](#features) · [Providers](#supported-providers) · [API Reference](#api-reference) · [Examples](#examples)


import { query, tool, createSdkMcpServer } from "one-agent-sdk";

// Same API as @anthropic-ai/claude-agent-sdk — swap provider with one option
const conversation = query({
  prompt: "What's the weather?",
  options: { provider: "codex" }, // or "openai", "anthropic", "openrouter", ...
});

The Problem

`@anthropic-ai/claude-agent-sdk` has a great API — but it only works with Claude Code. If you want to use Codex or Kimi, you have to learn a completely different SDK.

The Solution

One Agent SDK is a drop-in replacement for `@anthropic-ai/claude-agent-sdk` that routes to any backend. Same `query()`, `tool()`, `createSdkMcpServer()` — just pass `options.provider` to switch:

  const conversation = query({
    prompt: "Analyze this code",
-   options: { systemPrompt: "You are helpful." },
+   optio