Spec Oxide

Spec-driven development for humans and AI - optimized for Claude Code with built-in MCP

Spec Oxide is a comprehensive workflow and toolset that enables spec-driven development for AI-assisted coding. You agree on what to build before any code is written.

What do you get?

📋 Spec Driven Workflow with three simple commands

Core principle: Specs are the source of truth. Changes are proposals that modify that truth.

• /spox:propose - Propose a change and lock your intent
• /spox:implement - Implement the defined task list with comprehensive verification
• /spox:archive - Keep the accepted specs in sync by merging the change proposal The built-in Spox MCP server provides tools for spec and change management. Always use for spec operations—never use CLI commands or direct file manipulation when working through an AI agent.

Get started in minutes—no extra API keys required

For setup and update instructions read the Setup Guide. Setup takes just a couple of minutes. Besides Claude Code, there are no additional API keys required.

# Setup
cargo install spec-oxide

# Initialize a new project
spox init

# Run the setup script to configure MCP servers (Serena, Context7)
.spox/setup.sh

# Run Claude Code
claude

# Get started with /spox:setup

User Guide

Spec Oxide User Guide

Workflow with the built-in MCP server

Explore → list_specs, list_changes, search_specs
Understand → get_spec_requirements, get_scenario, get_change
Validate → validate_spec, validate_change

Example Usage

# List all specs
mcp__spox__list_specs

# Search for authentication-related specs
mcp__spox__search_specs query="authentication"

# Get requirements for a specific spec
mcp__spox__get_spec_requirements spec_id="auth"

# Validate a change proposal
mcp__spox__validate_change change_id="add-two-factor-auth"

Tool Reference