auriga-workflow

English | 中文

auriga-cli

A modular Claude Code harness — install only the parts you need.

This repo itself is a fully configured harness project. You can clone it to see the full setup, or use the CLI to install individual modules into your own project.

Auriga's harness design is inspired by several open-source skill and agent-workflow projects:

• obra/superpowers skills
• addyosmani/agent-skills
• mattpocock/skills

What's Included

Module	Description
Workflow	AGENTS.md auriga workflow: requirement clarification -> TDD -> Review, Harness principles, Subagent usage guide
Skills	External development process skills — planning and playwright (systematic-debugging, TDD, spec authoring, architecture design, and completion-evidence discipline ship inside the workflow or auriga-workflow plugin)
Recommended Skills	Optional utility skills (e.g. codex-agent, claude-code-agent) you can add on top of the workflow skills
Plugins	Recommended Claude Code and Codex plugins — skill-creator, claude-md-management, playground, codex, auriga-workflow, auriga-notify, session-instructions-loader

Quick Start

Install

There are two recommended ways to install:

1. Run the installer yourself:

npx -y auriga-cli

2. In an interactive Agent session, ask the Agent:

Run npx -y auriga-cli guide, read the guide, then install the Auriga harness into this repository by following the steps it prints.

The guide command is intentionally non-interactive so an Agent can read the prerequisite checks, catalog inspection commands, install commands, reload step, and verification checklist in one place.

The leading -y belongs to npx (it auto-confirms package installation), not to auriga-cli.

Non-interactive install commands:

npx -y auriga-cli install --preset           # curated workflow core: AGENTS.md/CLAUDE.md
                                             #   + workflow skills + auriga-workflow plugin
                                             #   (defaults: scope user, agent both, lang zh-CN)
npx -y auriga-cli install --preset-plugins-skills
                                             # skip AGENTS.md/CLAUDE.md; install preset skills + auriga-workflow plugin
                                             #   (defaults: scope user, agent both)
npx -y auriga-cli install --all              # everything: workflow + skills + recommended + plugins
npx -y auriga-cli install recommended        # just the opt-in utility skills
npx -y auriga-cli install plugins --agent codex --plugin session-instructions-loader
npx -y auriga-cli install <type> [--flags]   # one of: workflow | skills | recommended | plugins
npx -y auriga-cli --help                     # full catalog + flags

--preset is atomic — it cannot be combined with a <type> or any filter flag, but it accepts --scope, --agent, and --lang (preset defaults: user / both / zh-CN, which differ from the per-category defaults). If the project already has its own AGENTS.md / CLAUDE.md, use --preset-plugins-skills to install the same preset skills and auriga-workflow plugin without touching workflow docs.

Exit codes: 0 success, 1 fatal (precheck / parse / fetch), 2 partial success — stderr lists per-category [OK]/[FAIL] and a Retry: hint. After install, reload the Agent session so the new AGENTS.md / skills / plugins / hook-plugin registrations are picked up.

Web UI (opt-in)

For a browser-based view of what's installed and one-click apply, run:

npx auriga-cli web-ui

This boots a local server on 127.0.0.1, opens your default browser, and serves a dashboard that scans the current project, shows each module's status (installed / not-installed / partial-install), and applies install / uninstall in a queue with live SSE progress. Re-running install is the update path — every installer is idempotent and overwrites in place. The server shuts down on its own ~15 s after the browser closes.

The UI is opt-in — npx auriga-cli still launches the TTY menu below.

Interactive menu

npx auriga-cli

Interactive menu — select what to install:

? Select what to install:
  ◉ Recommended preset — AGENTS.md/CLAUDE.md + workflow skills + auriga-workflow plugin
  ◯ Optional skills — opt-in utility skills (claude-code-agent, codex-agent...)
  ◯ Other plugins — everything except auriga-workflow (auriga-notify, skill-creator, codex...)