plugins-install.md

plugins install

specd plugins install installs one or more plugins and records them in specd.yaml.

Command

specd plugins install <plugin> [<plugin>...]

Options:

• --format <text|json|toon> output format (default: text)
• --config <path> explicit specd.yaml path

Behavior

• Validates plugin package names before attempting install.
• Skips plugins already declared in config and prints a warning containing already installed and update.
• For non-declared plugins:
  • Loads plugin runtime through plugin manager.
  • Runs install use case.
  • Persists declaration via ConfigWriter.addPlugin() under plugins.agents.
• Continues after per-plugin failures.
• Exits with code 1 if at least one plugin fails.

For agent plugins that install skills (@specd/plugin-agent-codex, @specd/plugin-agent-claude, @specd/plugin-agent-copilot, @specd/plugin-agent-opencode):

• Skill-local files are installed under the agent root at <agent-skills-dir>/<skill-name>/.
• Files marked as shared are installed once under <agent-skills-dir>/_specd-shared/.
• Shared markdown files are written as-is (no skill frontmatter injection).

Output

Text output prints:

Installed plugins:
<plugin-name>  <installed|skipped|error>  <detail>

JSON/TOON output:

{
  "plugins": [
    {
      "name": "@specd/plugin-agent-claude",
      "status": "installed",
      "detail": "installed '@specd/plugin-agent-claude'"
    }
  ],
  "hasErrors": false
}