CommandKit AI Plugin
Activation guidance
Use when implementing natural-language command execution or AI tool orchestration.
Required filesystem expectations
- plugin registration in
commandkit.config.ts - AI runtime config in
src/ai.tsorsrc/ai.js - AI-enabled command files in
src/app/commands/**
Execution workflow
- Register
ai()plugin. - Configure
configureAI()insrc/ai.*. - Implement
aiConfigschema andaicommand handlers. - Add tool registration and robust error handling.
- Validate trigger filter, permissions, and response safety.
Guardrails
- Never hardcode API keys.
- Treat AI output as untrusted input for sensitive operations.
- Keep tool descriptions explicit and narrow.
Reference index
| Name | Description |
|---|---|
references/00-filesystem-structure.md | File layout and export expectations for AI-enabled projects. |
references/01-plugin-setup.md | Minimal plugin wiring in config. |
references/02-configure-ai-model.md | Model selection, message filters, and runtime option patterns. |
references/03-ai-command-schema.md | Typed schema + AI command implementation pattern. |
references/04-custom-tools.md | Tool creation and safe exposure patterns. |
Tool index
| Name | Description |
|---|---|
tools/generate-ai-command-template.mjs | Prints a starter AI command template with schema and handler exports. |