Agent

DocsAgentExtensions

Extend the Spectral agent with built-in extensions for project management, Studio integration, and automatic project discovery.

Extensions

Extensions are pre-built tools that add capabilities to your agent. They live in .spectral/extensions/ and are loaded automatically when you start the agent — no configuration required.

Built-in Extensions

Spectral ships with these extensions ready to use:

  • Kanban Bridge — Execute Kanban tasks directly from your Studio board. The agent reads task descriptions, follows instructions, and updates task status automatically.
  • Studio Binding — Link your local project to Aexol Studio for remote tools, shared sessions, and cloud-backed persistence. Run spectral bind from your project root to connect.
  • Auto-Research — Automatically discovers your project structure, conventions, dependencies, and workflows. Auto-research runs when the agent detects gaps in its project knowledge, producing tool definitions and project patterns that improve accuracy.

Using Extensions

Extensions are loaded automatically from .spectral/extensions/. To add a user extension:

  1. Create a directory under .spectral/extensions/<extension-name>/
  2. Add an index.ts entry point
  3. Restart spectral serve

The agent discovers and loads all extensions on startup. No extra flags or imports needed.

Additional Extensions

Spectral also includes native extensions for browser automation, SEO analysis, PDF generation, and more. These are loaded automatically and require no setup.

For now, custom extension authoring is an advanced workflow: follow the patterns in the existing extensions in your project and test changes locally before sharing them with your team.

Next Steps