super-agent-cli-plugins

fficial plugin repository for Super Agent CLI. Extend your Super Agent CLI with custom tools, integrations, and capabilities through a simple plugin system.

0
0
0
public
Forked

Super Agent CLI Plugins

Official plugin repository for Super Agent CLI.

Extend your Super Agent CLI with custom tools, integrations, and capabilities through a simple plugin system.

πŸš€ Quick Start

See QUICKSTART.md for a step-by-step guide to creating your first plugin.

πŸ“¦ Available Examples

Explore fully-functional example plugins in the examples/ directory:

  • undefinedweather - External API integration with weather data
  • undefineddatabase - Database query tools with state management
  • undefinednotify - System notifications and cross-platform integration

🎨 Templates

Get started quickly with our templates in the templates/ directory:

  • undefinedbasic - Minimal single-tool plugin
  • undefinedadvanced - Full-featured plugin with tests and CI

πŸ“– Plugin API

All plugins must export a SuperAgentPlugin object:

export interface SuperAgentPlugin {
  name: string; // Unique plugin identifier
  version: string; // Semantic version
  description?: string; // Human-readable description
  tools?: SuperAgentTool[]; // Tools provided by this plugin
  onInit?: (context: PluginContext) => Promise<void>;
  onShutdown?: () => Promise<void>;
}

Tool Definition

export interface SuperAgentTool {
  type: "function";
  function: {
    name: string;
    description: string;
    parameters?: {
      type: "object";
      properties: Record<string, any>;
      required?: string[];
    };
    executor: (args: any, context: any) => Promise<string>;
  };
}

πŸ”§ Installing Plugins

From this repository:

super-agent plugins install @plugins/examples/weather

From local file:

super-agent plugins install ./my-plugin.js
super-agent plugins install /path/to/plugin/dist/index.js

List installed plugins:

super-agent plugins list

Remove a plugin:

super-agent plugins uninstall weather

πŸ“ Contributing

We welcome plugin contributions! Please see our Contributing Guidelines for details.

Plugin Submission Checklist

πŸ“„ License

MIT - See LICENSE for details.

[beta]v0.3.0