VibeCody Plugin Development Guide

name = "my-plugin"
version = "1.0.0"
description = "What this plugin does"
author = "Your Name"

[[hooks]]
event = "PostToolUse"
tools = ["write_file", "apply_patch"]
command = "hooks/post-write.sh"

name = "my-plugin"
version = "1.0.0"
display_name = "My Plugin"
description = "A detailed description of the plugin"
author = "Your Name"
license = "MIT"
repository = "https://github.com/user/vibecody-my-plugin"
homepage = "https://example.com"
kind = "connector"       # connector | adapter | optimizer | theme | skillpack | workflow | extension
min_vibecli_version = "0.1.0"
max_vibecli_version = "2.0.0"
keywords = ["jira", "project-management", "issues"]
icon = "icon.png"
platforms = ["macos", "linux", "windows"]

# Capabilities the plugin requires
capabilities = ["FileRead", "FileWrite", "NetworkAccess"]

# Dependencies on other plugins
[[dependencies]]
name = "vibecody-core-utils"
version = ">=1.0.0"

# Hook definitions
[[hooks]]
event = "PostToolUse"
tools = ["write_file"]
handler = "hooks/post-write.sh"
priority = 100           # Lower runs first
async_exec = false       # true = non-blocking

# Command definitions
[[commands]]
name = "lint"
description = "Run linter on changed files"
handler = "commands/lint.sh"

[[commands.args]]
name = "fix"
description = "Auto-fix issues"
required = false
default = "false"

# Plugin-specific settings
[[settings]]
key = "api_url"
description = "API endpoint URL"
type = "string"
required = true

[[settings]]
key = "api_token"
description = "API authentication token"
type = "secret"          # string | number | boolean | secret | filepath | enum
required = true

[[settings]]
key = "severity"
description = "Minimum severity to report"
type = "enum"
values = ["low", "medium", "high", "critical"]
default = "medium"

# Shell command hook — runs on every file write
[[hooks]]
event = "PostToolUse"
tools = ["write_file"]
handler = { command = "sh .vibecli/hooks/format.sh" }
async = false

# LLM hook — AI-powered safety check
[[hooks]]
event = "PreToolUse"
tools = ["bash"]
handler = { llm = "Check if this bash command is safe. Block if it could delete important data." }

# HTTP webhook — external service integration
[[hooks]]
event = "FileSaved"
paths = ["**/*.rs"]
handler = { url = "https://linter.example.com/check", method = "POST", timeout_ms = 5000 }
async = true

[[hooks]]
event = "PostToolUse"
tools = ["write_file", "apply_patch"]   # Only file-write tools
paths = ["src/**/*.rs", "tests/**"]     # Only Rust source files
handler = { command = "cargo clippy" }

# ~/.vibecli/config.toml

[[mcp_servers]]
name = "github"
command = "npx"
args = ["@modelcontextprotocol/server-github", "--token", "$GITHUB_TOKEN"]

[[mcp_servers]]
name = "filesystem"
command = "npx"
args = ["@modelcontextprotocol/server-filesystem", "/path/to/allowed"]

# Provider selection
[ollama]
model = "llama3.2"
api_url = "http://localhost:11434"

[claude]
api_key = "sk-..."
model = "claude-sonnet-4-20250514"
api_url = "https://api.anthropic.com"       # Configurable
thinking_budget_tokens = 10000               # Extended thinking

[openai]
api_key = "sk-..."
model = "gpt-4o"
api_url = "https://api.openai.com/v1"       # Configurable

# Failover chain — auto-switch on provider failure
[failover]
providers = ["claude", "openai", "ollama"]

# Index configuration
[index]
embedding_provider = "ollama"
embedding_model = "nomic-embed-text"

# Hook definitions
[[hooks]]
event = "PostToolUse"
tools = ["write_file"]
handler = { command = "sh .vibecli/hooks/format.sh" }

# MCP server connections
[[mcp_servers]]
name = "github"
command = "npx"
args = ["@modelcontextprotocol/server-github"]

# UI preferences
[ui]
theme = "dark"

# Safety settings
[safety]
max_file_size = 1048576
blocked_commands = ["rm -rf /", "mkfs", "dd if="]

# Tool configuration
[tools]
search_engine = "duckduckgo"    # duckduckgo | tavily | brave
tavily_api_key = ""
brave_api_key = ""

# Memory (auto-facts)
[memory]
enabled = true
max_facts = 100

# Shell environment policy
[tools.env]
inherit = "core"                 # all | core | none
include = ["PATH", "HOME", "LANG", "NODE_*"]
exclude = ["AWS_SECRET*", "*_TOKEN"]

[tools.env.set]
EDITOR = "vim"

# Routing (use different providers for planning vs execution)
[routing]
planner_provider = "claude"
executor_provider = "ollama"

# Sandbox settings
[sandbox]
enabled = false
runtime = "docker"               # docker | podman | opensandbox
image = "ubuntu:22.04"

name = "vibecody-jira"
version = "1.2.0"
display_name = "Jira Integration"
description = "Sync VibeCLI tasks with Jira issues"
author = "VibeCody Team"
license = "MIT"
kind = "connector"
capabilities = ["NetworkAccess", "FileRead"]
keywords = ["jira", "project-management", "issues", "agile"]

[[settings]]
key = "jira_url"
description = "Jira instance URL"
type = "string"
required = true

[[settings]]
key = "jira_token"
description = "Jira API token"
type = "secret"
required = true

[[hooks]]
event = "TaskCompleted"
handler = "hooks/sync-on-complete.sh"

[[commands]]
name = "create-ticket"
description = "Create a Jira ticket from the current task"
handler = "commands/create-ticket.sh"

[[commands.args]]
name = "project"
description = "Jira project key"
required = true

[[commands.args]]
name = "type"
description = "Issue type"
required = false
default = "Task"

# In ~/.vibecli/config.toml
[[hooks]]
event = "PostToolUse"
tools = ["write_file"]
paths = ["**/*.ts", "**/*.tsx", "**/*.js"]
handler = { command = "npx prettier --write $FILE" }
async = true

# Add to ~/.vibecli/config.toml
[[hooks]]
event = "PreToolUse"
tools = ["bash"]
handler = { command = "python3 .vibecli/hooks/safety-check.py" }

# Add to ~/.vibecli/config.toml
[[mcp_servers]]
name = "my-service"
command = "node"
args = ["my-mcp-server.js"]