Plugin Developer Guide

Plugin Structure

Directory layout and file roles for a complete plugin.

A complete plugin directory looks like this:

my-plugin/

├─ package.json

├─ tsconfig.json

├─ permissions.json (optional)

├─ llm.txt (optional)

├─ setup.ts (optional)

├─ README.md

└─ src/

├─ index.ts (required - main entry)

└─ command.ts (optional - CLI commands)

package.json

Plugin metadata, entry points, and Kazibee configuration.

src/index.ts

Main entry. Exports a default function returning the plugin API.

src/command.ts

Named exports become CLI commands (e.g. kazibee my-plugin login).

permissions.json

Declares required environment variables and their sources.

llm.txt

Instructions for AI agents on how to use the plugin effectively.

setup.ts

Runs once at install/link time to set SYSTEM-level env defaults.