Reqvire

Requirements-as-context framework for modern engineering teams.

📖 Documentation • 🔍 Browse Model • 🚀 Quick Start • 👥 Contributing

---

What is Reqvire?

Reqvire is a lightweight, Git-native Requirements-as-Context framework that turns specifications into structured, AI-ready context: enabling smarter development, traceability, and consistent change management.

It unifies system modeling, requirements management, context engineering and AI-assisted development into a single workflow—providing complete traceability, intelligent automation, and faster delivery while staying fully aligned with your codebase.

🤖 Now Available for Coding Assistants

Use Reqvire with coding assistants through Claude Code plugin workflows and Codex skills: Install and get started →

Reqvire also ships an MCP server for AI tools that support the Model Context Protocol. Run it directly with npx and point it at the Reqvire workspace you want the assistant to inspect:

npx -y @reqvire-org/reqvire@latest --workspace /absolute/path/to/workspace mcp

MCP client configuration:

{
  "mcpServers": {
    "reqvire-myrepository": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@reqvire-org/reqvire@latest",
        "--workspace",
        "/absolute/path/to/my/repository",
        "mcp"
      ]
    }
  }
}

By default, the MCP server exposes read/report tools only. To allow mutation tools, add --enable-mutations after mcp.

---

Key Features

Requirements-as-Context

Create a structured, canonical source of truth for your project.
Reqvire provides a consistent context layer that AI tools can reliably query—so they always understand what needs to be built, where changes belong, and how system components fit together.

Requirements-as-Code

Evolve requirements from static documents into version-controlled, executable artifacts.
Reqvire keeps your system model alive in Git—no more lost specs, outdated docs, or knowledge locked in transient tickets.

Intelligent Engineering

Bring Model-Based Systems Engineering (MBSE) directly into your Git workflow:

• Specification-Driven Development
  Develop from requirements. Enforce clear specifications and generate code that stays tied to its originating requirements.

• Automated Traceability
  Maintain instant, bidirectional links between requirements, code, tests, and artifacts.

• Verification & Validation
  Track verifications, ensure coverage, and validate that implementations meet intended behavior.

• Smart Change Propagation
  Identify impacted parts of the system and help propagate requirement changes consistently across the model and codebase.

• Seamless Integration
  Works naturally with branches, pull requests, reviews, and CI/CD. No workflow disruption—just added intelligence.

Get Started

Installation

Prerequisites

To install the Reqvire CLI:

curl -fsSL https://raw.githubusercontent.com/reqvire-org/reqvire/main/scripts/install.sh | bash

For detailed CLI installation options, see the Installation Guide.

Installing Assistant Integrations

Claude Code Plugin

Before installing the plugin, ensure you have:

1. Claude Code installed (available at claude.com/claude-code)

The Reqvire plugin is available through the reqvire-org marketplace for Claude Code:

1. Add the marketplace - In Claude Code, run:

   /plugin marketplace add https://github.com/reqvire-org/reqvire
   

2. Install the plugin - Then run:

   /plugin install reqvire@reqvire-org
   

3. Restart Claude Code to activate the plugin

To read more about assistant integrations, see Coding Assistants.

Codex Skill (Reqvire SysEng)

This repository includes an installable Codex skill package at codex-skills/reqvire-syseng.

The skill uses the npm package by default, so a separate Reqvire binary install is not required for assistant workflows:

npx -y @reqvire-org/reqvire@latest --workspace /absolute/path/to/workspace validate

To pin assistant workflows to a specific Reqvire release, set REQVIRE_NPX_PACKAGE, for example:

export REQVIRE_NPX_PACKAGE=@reqvire-org/reqvire@0.13.2

To install the skill globally on your machine, clone this repository and run the installer:

git clone https://github.com/reqvire-org/reqvire.git
cd reqvire
./scripts/install-codex-skill.sh

The installer uses CODEX_HOME when it is set. If it is not set, it defaults to ~/.codex.

It copies codex-skills/reqvire-syseng to:

$CODEX_HOME/skills/reqvire-syseng

Default path when CODEX_HOME is unset:

~/.codex/skills/reqvire-syseng

If you are already inside a local Reqvire checkout, just run:

./scripts/install-codex-skill.sh

Restart Codex after installing or updating the skill.

See doc/CODEX_SKILLS.md for details.

Next Steps

• Documentation - Learn how to use Reqvire
• Browse Model - Explore Reqvire's own specifications

---

Contributing

External pull request contributions are by invitation only.

How to Contribute

1. Read the Contributing Guide - Understand contribution policy and invited workflow
2. Open or upvote an issue - Propose features, behavior changes, and bug reports
3. Contribute analysis - Share reproduction details and implementation ideas in issue threads
4. Submit a PR only if invited - Uninvited PRs may be closed without review

Important: Reqvire follows an MBSE workflow. Invited code changes should include corresponding requirements, verifications, and tests. See Contributor Documentation for details.

Quick Links

• Report a Bug
• Request a Feature
• Ask a Question
• Contributor Guide

Contributor License Agreement

All contributors must accept our Contributor License Agreement. The CLA process is automated through GitHub PR comments.

---

Credits

reqvire is an open-source project created and maintained by Ilija Ljubicic.

Special Thanks:

• Juanjo Andres For valuable contributions to testing and in shaping reqvire's direction, especially in the early phases of reqvire's development.

• GrapheneDB For partial sponsorship and for being the first user of reqvire. Their support helped shape the tool's early direction.

What's Next?

Join Our Growing Community

• ⭐ Star us on GitHub to stay updated
• 💬 Join discussions to share your use cases
• 📝 Contribute to make Reqvire even better
• 🐦 Follow updates on our blog and social media

---

License

Licensed under the Apache 2.0 License.

---