source-command-cli

Routes user requests to the unified livespec CLI subcommands with correct flags and exit codes.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/julien-m/livespec --skill source-command-cli-julien-m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: source-command-cli
Source: https://github.com/julien-m/livespec/tree/main/.agent-sync/skills/source-command-cli
Command: npx skills add https://github.com/julien-m/livespec --skill source-command-cli-julien-m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working with the LiveSpec framework need to remember which CLI subcommand, flags, and exit codes apply to tasks like running tests, checking coverage, or validating the preflight manifest. This Skill acts as an interactive picker that routes requests to the correct livespec subcommand without memorizing the CLI surface. ## Core Features & Use Cases - Subcommand routing: Forwards arguments verbatim to livespec test, coverage, drivers, mutation, or preflight, or asks one clarifying question when invoked with no arguments. - Auto-detection: Resolves project root via .specs/, picks the primary driver, detects the base branch, and reads the coverage threshold from .conventions/index.md without manual flags. - Structured output and exit-code guidance: Surfaces the LIVESPEC <subcommand> summary line and maps non-zero exit codes (1-5) to concrete next steps from docs/cli-reference.md. - Use Case: A developer wants to check patch coverage against the develop branch; invoking the picker with coverage --base develop runs livespec coverage --base develop and reports the summary line and exit code. ## Quick Start Ask the assistant to run the livespec CLI, for example by saying "run livespec coverage against the develop branch and show me the summary line and exit code".

Frequently Asked Questions about source-command-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run livespec CLI subcommands like test or coverage?

Invoke the picker with arguments such as `/cli test --mutation` or `/cli coverage --base develop`, and they are forwarded verbatim to `livespec` from the project root. With no arguments, it asks one question to pick a subcommand and then runs with defaults.

What subcommands does the livespec CLI support?

The unified surface includes `test`, `coverage`, `drivers`, `mutation`, and `preflight`. Each supports specific flags like `--base`, `--threshold`, `--json`, and `--fix`, plus a shared `--debug` flag for full Python stacktraces.

How does the CLI detect the project root and base branch?

The project root is the first ancestor of the working directory containing `.specs/`. The base branch is auto-resolved from the first match among origin/main, origin/master, develop, dev, main, and master, so flags are only needed to override wrong guesses.

What do livespec CLI exit codes 1 through 5 mean?

Exit 0 is success, 1 is failure or threshold not met, 2 is a usage or precondition error, 3 is a coverage gate failure, 4 is a mutation gate failure, and 5 means the preflight manifest is invalid. Exit 5 is resolved by running `livespec preflight --fix`.

What are the limitations of the livespec CLI picker?

It does not support watch mode, IDE or LSP integration, network reporting to services like Codecov, or multi-step TUI prompts. For deeper workflows such as AC coverage audits or baseline regeneration, use `/spec.test` instead.