soubi

The file-based framework for portable agent plugins.

Quick start

npx soubi@latest init my-plugin
cd my-plugin
npm run build

The initializer creates a plugin, installs its dependencies, and initializes Git when appropriate. The generated project builds native artifacts for twenty-two coding-agent harnesses, including Claude Code, Codex, OpenCode, Copilot CLI, Pi, OMP, Hermes, Kimi, Kilo, Maki, and Herdr.

The CLI and authoring helpers are included in this one package:

import { defineConfig, defineSkill } from "soubi";
import { compileProject } from "soubi/compiler";

Add Soubi to an existing project without replacing its files or scripts:

cd my-project
npx soubi@latest init .

Commands

soubi init
soubi build
soubi check
soubi install
soubi uninstall
soubi tools
soubi port
soubi add-harness
soubi dev

See the full documentation and source.