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.jsonTranslation details
- Command argument placeholders become Gemini's
{{args}}form. - MCP servers are written under
mcpServersingemini-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 geminiUse soubi check --harness gemini when a hook must block execution; it distinguishes blocking events from observe-only events.