plugin | Bootspring Docs

Manage Bootspring plugins and extensions.

Synopsis#

bootspring plugin <command> [options]

Description#

The plugin command manages Bootspring plugins that extend functionality. Plugins can add new agents, skills, workflows, integrations, and CLI commands.

Commands#

list#

List installed and available plugins.

bootspring plugin list [options]

Options:

Option	Description
`--installed`	Show only installed plugins
`--available`	Show available plugins from registry
`--category=<name>`	Filter by category

Categories:

Category	Description
`agents`	Additional expert agents
`skills`	Code patterns and templates
`workflows`	Custom workflows
`integrations`	Third-party integrations
`themes`	Dashboard themes

Examples:

# List all plugins
bootspring plugin list

# List installed only
bootspring plugin list --installed

# List integration plugins
bootspring plugin list --category=integrations

Output:

⚡ Bootspring Plugins

Installed:
  ✓ @bootspring/plugin-linear      1.2.0  Linear integration
  ✓ @bootspring/plugin-sentry      1.0.0  Sentry error tracking
  ✓ @bootspring/plugin-posthog     1.1.0  PostHog analytics

Available:
  ○ @bootspring/plugin-slack       1.3.0  Slack notifications
  ○ @bootspring/plugin-notion      1.0.0  Notion sync
  ○ @bootspring/plugin-datadog     1.0.0  Datadog monitoring
  ○ @bootspring/plugin-terraform   0.9.0  Terraform IaC

install#

Install a plugin.

bootspring plugin install <name> [options]

Options:

Option	Description
`--version=<v>`	Install specific version
`--save-dev`	Install as dev dependency
`--force`	Force reinstall

Examples:

# Install plugin
bootspring plugin install @bootspring/plugin-linear

# Install specific version
bootspring plugin install @bootspring/plugin-sentry --version=1.0.0

# Install from npm
bootspring plugin install bootspring-plugin-custom

uninstall#

Remove a plugin.

bootspring plugin uninstall <name> [options]

Options:

Option	Description
`--keep-config`	Keep plugin configuration

Examples:

# Uninstall plugin
bootspring plugin uninstall @bootspring/plugin-linear

# Keep config for later
bootspring plugin uninstall @bootspring/plugin-sentry --keep-config

update#

Update installed plugins.

bootspring plugin update [name] [options]

Options:

Option	Description
`--all`	Update all plugins
`--check`	Check for updates only

Examples:

# Update all plugins
bootspring plugin update --all

# Update specific plugin
bootspring plugin update @bootspring/plugin-linear

# Check for updates
bootspring plugin update --check

info#

Show plugin details.

bootspring plugin info <name>

Output:

⚡ Plugin: @bootspring/plugin-linear

Version: 1.2.0
Author: Bootspring Team
License: MIT
Repository: github.com/bootspring/plugin-linear

Description:
  Sync user stories with Linear issues. Two-way sync keeps
  your PRD and Linear in perfect harmony.

Features:
  - Import issues as user stories
  - Export stories to Linear
  - Two-way sync
  - Webhook support
  - Custom field mapping

Commands Added:
  - bootspring linear sync
  - bootspring linear import
  - bootspring linear export

Configuration:
  plugins:
    linear:
      apiKey: "lin_api_xxx"
      teamId: "TEAM"
      defaultProject: "PROJECT"

create#

Create a new plugin project.

bootspring plugin create <name> [options]

Options:

Option	Description
`--template=<name>`	Plugin template
`--typescript`	Use TypeScript (default)

Templates:

Template	Description
`basic`	Basic plugin structure
`agent`	Custom agent plugin
`skill`	Custom skill plugin
`workflow`	Custom workflow plugin
`integration`	Integration plugin

Examples:

# Create basic plugin
bootspring plugin create my-plugin

# Create agent plugin
bootspring plugin create my-agent --template=agent

# Create integration
bootspring plugin create my-integration --template=integration

publish#

Publish a plugin to the registry.

bootspring plugin publish [options]

Options:

Option	Description
`--access=<level>`	Access level (public, private)
`--tag=<name>`	Publish tag (latest, beta)

Examples:

# Publish to registry
bootspring plugin publish

# Publish as beta
bootspring plugin publish --tag=beta

config#

Configure plugin settings.

bootspring plugin config <name> [options]

Options:

Option	Description
`--set=<key>=<value>`	Set configuration value
`--get=<key>`	Get configuration value
`--reset`	Reset to defaults

Examples:

# Set API key
bootspring plugin config linear --set=apiKey=lin_api_xxx

# Get current config
bootspring plugin config linear --get=teamId

# Reset configuration
bootspring plugin config linear --reset

Official Plugins#

Integration Plugins#

Plugin	Description
`@bootspring/plugin-linear`	Linear project management
`@bootspring/plugin-notion`	Notion documentation
`@bootspring/plugin-slack`	Slack notifications
`@bootspring/plugin-discord`	Discord integration
`@bootspring/plugin-github`	Enhanced GitHub features

Monitoring Plugins#

Plugin	Description
`@bootspring/plugin-sentry`	Error tracking
`@bootspring/plugin-posthog`	Product analytics
`@bootspring/plugin-datadog`	APM monitoring
`@bootspring/plugin-logflare`	Log management

DevOps Plugins#

Plugin	Description
`@bootspring/plugin-terraform`	Infrastructure as code
`@bootspring/plugin-docker`	Docker management
`@bootspring/plugin-k8s`	Kubernetes integration
`@bootspring/plugin-aws`	AWS services

Plugin Development#

Plugin Structure#

my-plugin/
├── package.json
├── src/
│   ├── index.ts        # Plugin entry
│   ├── commands/       # CLI commands
│   ├── agents/         # Custom agents
│   ├── skills/         # Custom skills
│   └── workflows/      # Custom workflows
├── templates/          # Code templates
└── README.md

Plugin Interface#

// src/index.ts
import { Plugin, PluginContext } from '@bootspring/plugin-sdk';

export default class MyPlugin implements Plugin {
  name = 'my-plugin';
  version = '1.0.0';

  async activate(context: PluginContext) {
    // Register commands
    context.registerCommand('my-command', this.myCommand);

    // Register agents
    context.registerAgent('my-agent', myAgentConfig);

    // Register skills
    context.registerSkill('my-skill', mySkillConfig);
  }

  async deactivate() {
    // Cleanup
  }

  private async myCommand(args: string[]) {
    // Command implementation
  }
}

Configuration Schema#

// Plugin config schema
export const configSchema = {
  apiKey: {
    type: 'string',
    required: true,
    secret: true,
    description: 'API key for the service',
  },
  teamId: {
    type: 'string',
    required: false,
    description: 'Team identifier',
  },
  syncInterval: {
    type: 'number',
    default: 300,
    description: 'Sync interval in seconds',
  },
};

Configuration#

Plugin configuration in bootspring.config.js:

module.exports = {
  plugins: {
    // Plugin-specific config
    linear: {
      apiKey: process.env.LINEAR_API_KEY,
      teamId: 'TEAM',
      defaultProject: 'PROJECT',
      twoWaySync: true,
    },

    sentry: {
      dsn: process.env.SENTRY_DSN,
      environment: process.env.NODE_ENV,
    },

    posthog: {
      apiKey: process.env.POSTHOG_KEY,
      host: 'https://app.posthog.com',
    },
  },
};

Examples#

Install and Configure Linear#

# Install plugin
bootspring plugin install @bootspring/plugin-linear

# Configure
bootspring plugin config linear --set=apiKey=$LINEAR_API_KEY
bootspring plugin config linear --set=teamId=TASK

# Use plugin commands
bootspring linear sync
bootspring linear import --project=TASK

Create Custom Agent Plugin#

# Create plugin
bootspring plugin create my-expert-agent --template=agent

# Develop...
cd my-expert-agent
npm install
npm run build

# Test locally
bootspring plugin install ./my-expert-agent

# Publish
bootspring plugin publish

bootspring config - Global configuration
bootspring mcp - MCP server management

Plugin Development - Build plugins
MCP Integration - Protocol details