Plugin Developer Guide

CLI Reference

Complete reference for all kazibee commands.

Tool Discovery

Commands for finding and inspecting tools available in the current directory.

kazibee-terminal

dev@local:~/workspace $ kazibee list

dev@local:~/workspace $ kazibee list --all

dev@local:~/workspace $ kazibee info

dev@local:~/workspace $ kazibee show my-plugin

list

List tools available in the current directory. Use -a, --all to list all registered tools across all directories.

info

Show detailed tool info including source, .d.ts path, and masked environment variables.

show

Print the combined .d.ts interface for a tool. Usage: kazibee show [toolName].

Tool Management

Install, link, and remove tools.

kazibee-terminal

dev@local:~/workspace $ kazibee install my-plugin github:org/my-plugin#abc123

dev@local:~/workspace $ kazibee install my-plugin org/my-plugin

dev@local:~/workspace $ kazibee link my-plugin ./my-plugin

dev@local:~/workspace $ kazibee uninstall my-plugin

dev@local:~/workspace $ kazibee unlink my-plugin

dev@local:~/workspace $ kazibee remove my-plugin --global

install

Install a tool from GitHub. Source format: github:owner/repo#sha or shorthand owner/repo. Flags: -g, --global, --skip-permissions.

link

Link a local tool directory for development. Path must contain package.json. Flags: -g, --global, --skip-permissions.

uninstall

Uninstall a GitHub-installed tool. Removes registration and files if orphaned. Flag: -g, --global. Errors if tool is linked — use unlink instead.

unlink

Unlink a locally-linked tool. Flag: -g, --global. Errors if tool is GitHub-installed — use uninstall instead.

remove

Remove tool registration without deleting files. Flag: -g, --global.

Environment & Config

Manage environment variables for tools.

kazibee-terminal

dev@local:~/workspace $ kazibee env my-plugin

dev@local:~/workspace $ kazibee env my-plugin --set API_KEY=sk-your-key SECRET=abc123

dev@local:~/workspace $ kazibee env my-plugin --delete API_KEY

dev@local:~/workspace $ kazibee env my-plugin --global --set API_KEY=sk-your-key

env

Manage environment variables for a tool. With no flags, displays current env. Flags: --set KEY=VALUE (multiple pairs), --delete KEY (multiple keys), -g, --global.

Development & Debugging

Commands for developing, testing, and debugging plugins.

kazibee-terminal

dev@local:~/workspace $ kazibee spec

dev@local:~/workspace $ kazibee spec LINK_SPEC

dev@local:~/workspace $ kazibee llm

dev@local:~/workspace $ kazibee llm my-plugin

dev@local:~/workspace $ echo 'Use my-plugin to greet the world' | kazibee exec

dev@local:~/workspace $ kazibee usage claude

dev@local:~/workspace $ kazibee usage claude --install

spec

List or print built-in specification documents. No argument lists all specs. With an argument, prints that spec's content. Available specs: LINK_SPEC, PERMISSIONS_SPEC, COMMAND_ARGS, CONTEXT_SPEC. Useful during development and for AI agents helping develop plugins.

llm

Print llm.txt documentation. No argument prints Kazibee's own llm.txt. With a tool name, prints that tool's llm.txt.

exec

Execute JavaScript code from stdin in a sandbox with tool access. Tools are available as tools["name"].

usage

Print tool usage documentation. Targets: claude, codex. Flag: --install to write the skill file to ~/.claude/skills/kazibee/SKILL.md or ~/.codex/skills/kazibee/SKILL.md.

Plugin Commands (Dynamic)

Run commands exported by installed tools. With no subcommand, lists available commands. Commands that return Record<string, string> are auto-persisted as environment variables.

kazibee-terminal

dev@local:~/workspace $ kazibee my-plugin

dev@local:~/workspace $ kazibee my-plugin login

dev@local:~/workspace $ kazibee my-plugin sync --force

Kazibee

Bounded AI execution. Free and open source.