relic-cli 0.8.0

Spec-driven development with a shared artifact layer

relic-cli

Spec-driven development with a shared artifact layer — Python / uv distribution.

Relic connects all your specs through a shared "brain" of domains, contracts, rules, and assumptions. Intersection detection between specs. Specs that stay alive through bug fixes.

This package ships a pre-compiled native binary — no Node.js or Python runtime required at execution time.

---

Install

uv tool install relic-cli

Or with pip:

pip install relic-cli

---

Getting started

cd my-project
relic init

# Open your AI agent (Claude Code, Copilot, Codex) and run:
# Existing codebase:  /relic.scan  then  /relic.constitution
# New project:        /relic.constitution  then  /relic.specify

---

CLI commands

Command	Purpose
relic init [--engine claude|copilot|codex] [--dir] [--force]	Scaffold .relic/ in your project
relic add-engine <engine>	Add AI engine hooks to an existing project
relic use <spec-id>	Set the active spec for this session
relic use --fix <fix-id>	Set the active fix (validates fix doc exists)
relic use --clear-fix	Clear the active fix from session state
relic scan [--json]	Output a project manifest for /relic.scan
relic context [--spec id] [--text]	Resolve active spec; report file/artifact status and current_fix
relic scaffold [--title t|--spec id]	Ensure spec folder exists; create from templates if new
relic validate [--text]	Check artifact integrity and ownership conflicts
relic search <keywords...>	Search shared artifact manifests by keyword tags
relic deep-search	Return all manifest entries consolidated (tldr-first triage)

---

AI slash commands

Written to your agent's hooks directory by relic init:

Slash command	Purpose
/relic.constitution	Extract project-specific principles from the codebase
/relic.scan	Bootstrap shared artifacts from existing code
/relic.specify	Create a new spec
/relic.clarify	Append details or change contracts
/relic.plan	Create an implementation plan
/relic.analyse	Non-destructive consistency check
/relic.tasks	Generate tasks from the plan
/relic.implement	Build the plan
/relic.fix	Cross-spec ownership check + diagnosis → writes fix document
/relic.solve	Apply the active fix document and close the fix
/relic.use	Switch active spec or fix from inside the AI session

---

Platform support

Pre-compiled binaries are shipped for:

Platform	Architecture
Linux	x86_64, arm64
macOS	x86_64 (Intel), arm64 (Apple Silicon)
Windows	x86_64

---

Also available via npm

npm install -g relic-cli   # requires Node.js 18+
npx relic-cli init

---

Full documentation · Report an issue