Reporails CLI (v0.6.3)

AI Instruction Diagnostics for coding agents. Validates the entire agentic instruction system against 120+ rules across six rule packs (core + per-agent). Supports Antigravity, Claude, Codex, Copilot, and Cursor.

Beta phase - moving fast, feedback welcome.

Quick Start

npx @reporails/cli check
# or
uvx --from reporails-cli ails check

No install, no account. The headline is a single Quality score (the analysis service's verdict on how well-formed your instructions are); fix the findings that move it, run again, watch it climb:

Reporails — Diagnostics

  ┌─ Main (1)  6 directive / 1 constraint · 30% prose
  │ CLAUDE.md  6 dir / 1 con · 30% prose
  │   ✗       Unresolved imports: docs/setup.md  CORE:S:0024
  │   ⚠       Missing directory layout — show the project structure with a tre…  CORE:C:0035
  │     ... and 19 more
  │     6 vague · 7 brief · 1 weak
  │     ⊕ 2 Pro diagnostics — topic overlap, unbalanced topics
  │
  └─ 35 findings

  ┌─ Rules (1)  4 directive · 20% prose
  │ testing  4 dir · 20% prose
  │   ⚠       No frontmatter block found  CLAUDE:S:0012
  │   ⚠       Missing frontmatter block — start with --- delimited YAML frontm…  CORE:S:0006
  │     ... and 1 more
  │     4 vague · 4 brief
  │     ⊕ 1 Pro diagnostics — topic overlap
  │
  └─ 11 findings

  ── Cross-file ────────────────────────────────────────

  ⚠  .claude/rules/testing.md ↔ CLAUDE.md — 3 overlaps
  ⚠  .claude/rules/testing.md ↔ CLAUDE.md — 1 repetition

  Line-level detail → sign in with ails login, then upgrade to Pro

  ── Summary ─────────────────────────────────────────

  Quality   1.0 / 10  ▓▓░░░░░░░░░░░░░░░░░░  (1.0s)
  Fix now   1 error. Start with CORE:S:0024.
  Findings  46 total · -v to list every one
  Agent: Claude
  Level: L3 Scoped

  Scope:
    instructions: 10 directive / 4 prose (27%)
                  1 constraint

  Main (1):  ▓▓░░░░░░░░░░░░░   1.0  35 findings · 1 error
  Rules (1): ▓▓░░░░░░░░░░░░░   1.0  11 findings

  Top rules (by finding count):
    CORE:E:0004   x11  warn  Instruction Elaboration
    CORE:C:0042   x10  warn  Specificity Gap
    CLAUDE:S:0012 x2   warn  Path Scope Declared
    CORE:C:0005   x1   warn  Testing Framework Documented

  + 3 Pro diagnostics (3 warnings)
  1 cross-file repetition
  1 element pair overlaps in topic — keep each topic in one file

  Pro adds the remedies and the order to apply them.
  → sign in with ails login, then upgrade to Pro

Install permanently

npx @reporails/cli install
# or
uvx --from reporails-cli ails install

Puts ails on your PATH, installs the reporails plugin into Claude Code and Codex when they are on your machine, and prints the install steps for the other supported agents (also listed in Agent Support). ails install --project installs the plugin for the current repository only, shared with collaborators through its Claude Code settings; Codex installs for your user. ails update upgrades ails and refreshes the plugin in each agent that has it. With Pro, the step after install is /reporails:ails heal in Claude Code, which rewrites your instruction files.

Free vs Pro