Installation

reqstool-ai is distributed as a plugin that works with both Claude Code and GitHub Copilot CLI.

Claude Code

# Add marketplace (one-time)
/plugin marketplace add reqstool/reqstool-ai

# Install core plugin
/plugin install reqstool@reqstool-ai --scope project

# Optional: OpenSpec integration
/plugin install reqstool-openspec@reqstool-ai --scope project

GitHub Copilot CLI

# Add marketplace (one-time)
copilot plugin marketplace add reqstool/reqstool-ai

# Install core plugin
copilot plugin install reqstool@reqstool-ai

# Optional: OpenSpec integration
copilot plugin install reqstool-openspec@reqstool-ai

Post-install configuration

After installing the plugin, create a .reqstool-ai.yaml config file in your project root. Use the template from the repo as a starting point:

# Project URN — matches the urn in your reqstool YAML files
urn: my-project

# Revision string for new requirements and SVCs
revision: "0.1.0"

# System-level reqstool directory (contains the SSOT requirements and SVCs)
system:
  path: docs/reqstool

# Subproject modules
modules:
  core:
    path: core/docs/reqstool
    req_prefix: CORE_
    svc_prefix: SVC_CORE_

Edit the values to match your project’s structure. See Configuration for the full reference.

Testing locally

To test the plugins without installing from the marketplace:

# Claude Code
claude --plugin-dir ./plugins/reqstool
claude --plugin-dir ./plugins/reqstool-openspec

# Copilot CLI
copilot plugin install --path ./plugins/reqstool
copilot plugin install --path ./plugins/reqstool-openspec

Updating

# Claude Code
/plugin update reqstool@reqstool-ai
/plugin update reqstool-openspec@reqstool-ai

# Copilot CLI
copilot plugin update reqstool@reqstool-ai
copilot plugin update reqstool-openspec@reqstool-ai