Soubi

Gemini CLI

How Soubi packages a plugin as a Gemini CLI extension.

Gemini CLI loads Soubi output as an extension. The extension manifest owns MCP configuration while Markdown and TOML files carry instructions, skills, commands, and agents.

Native output

gemini-extension.json
GEMINI.md
skills/<name>/SKILL.md
commands/<name>.toml
agents/<name>.md
hooks/hooks.json

Translation details

  • Command argument placeholders become Gemini's {{args}} form.
  • MCP servers are written under mcpServers in gemini-extension.json.
  • Portable tools are exposed through a generated MCP stdio server.
  • Observe-only Gemini events can record activity but cannot honor a blocking decision.

Build this target

pnpm soubi build ./my-plugin --harness gemini

Use soubi check --harness gemini when a hook must block execution; it distinguishes blocking events from observe-only events.

On this page