relic-cli 0.8.17

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

Setup and navigation

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 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)
relic upgrade [--check] [--prompts]	Upgrade relic-cli and refresh engine hook files

Workflow commands (direct model invocation)

Requires .relic/models.json with baseUrl and model. Calls any OpenAI-compatible endpoint directly — no IDE required.

Command	Purpose
relic scan [--manifest] [--no-stream]	AI scan workflow (default) or raw manifest with --manifest
relic specify [--title t] [--no-stream] [--reset-context]	Create a new spec and run specify workflow
relic clarify [--spec id] [--no-stream] [--reset-context]	Append details or change contracts
relic plan [--spec id] [--no-stream] [--reset-context]	Create an implementation plan
relic analyse [--spec id] [--no-stream] [--reset-context]	Non-destructive consistency check
relic tasks [--spec id] [--no-stream] [--reset-context]	Generate tasks from the current plan
relic implement [--spec id] [--no-stream] [--reset-context]	Build the plan
relic fix [--spec id] [--issue desc] [--no-stream] [--reset-context]	Fix a bug using the spec as context
relic solve [--fix id] [--no-stream]	Apply the active fix document
relic constitution [--no-stream]	Regenerate .relic/constitution.md from the codebase
relic model --reset-context [--spec id]	Clear per-spec conversation history

Minimum models.json:

{ "baseUrl": "http://localhost:11434", "model": "llama3" }

---

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