@copado/create-agentia-plugin

Scaffold a TypeScript oclif plugin for Agentia CLI.

Create a plugin

npm init @copado/agentia-plugin my-plugin

The generator asks for the package name, description, author, command topic, and command name. It then creates the project and installs its dependencies.

The destination can be a relative or absolute path:

npm init @copado/agentia-plugin /path/to/my-plugin

Start developing

After generation:

cd my-plugin
npm run build
agentia plugins link .

Run the generated sample command:

agentia <topic> <command>

Re-run npm run build after changing TypeScript files.

What plugins can do today

• Add new commands (agentia <topic> <command>)
• Use oclif flags, args, and standard command lifecycle
• Link or install like any other oclif plugin

Not supported yet

• Calling Agentia CLI internals (auth, org/context, work items, git, and similar host services)
• Extending or wrapping existing Agentia commands (cicd work commit, and so on)
• Registering MCP tools through a plugin (agentia mcp start only loads tools shipped with the CLI)

A first-party API for selected CLI integration points is planned. Do not depend on private Agentia source paths in the meantime.

Requirements

• Node.js 18 or newer
• Agentia CLI available on your PATH for linking and running the plugin