@devarings/fabric-cli

The fabric / dvs-fabric CLI — 60+ verbs that drive the Fabric typed knowledge graph for software projects. Read, navigate, create, mutate the lifecycle, validate, and enforce — without ever hand-editing frontmatter.

Install

# Global install (binaries: `fabric` and `dvs-fabric`)
npm install -g @devarings/fabric-cli
# or
pnpm add -g @devarings/fabric-cli

# Or per-project
pnpm add -D @devarings/fabric-cli

Once installed, fabric is the canonical entrypoint ; dvs-fabric is a longer-named alias retained for global-namespace collisions.

Quick reference (top-10 verbs)

| Verb | Intent | |------|--------| | fabric status | Session-start aggregator — active cycle, parking lot, recent learns, health snapshot | | fabric init [--template] | Bootstrap a new fabric in the current directory | | fabric check [path] | Run L1 + L2 + L3 + compile + replay — score /100, exits non-zero on errors | | fabric create <type> -d <domain> -t <topic> | Scaffold a new atom from a type template (spec, decision, feature, cycle, …) | | fabric show <atom-id> | Read one atom : frontmatter + sections + body (with --json) | | fabric query [filters] | Graph queries — --type, --refs, --impact, --search, --deferrals-ready | | fabric focus --intent <i> --target <t> | Intent-based retrieval — minimal context pack under a token budget | | fabric doctor | Aggregate parity checks across independent observers (lint↔status, check↔status, parking lot, …) | | fabric session brief-validate <file> | Validate a session-start brief against drift heuristics | | fabric session recap audit-bulk --since <ref> | Audit recent session recaps for structure and fact integrity |

Every verb supports --json for machine consumption. Full inventory : fabric --help.

Pointers

• Root README & adopter entrance : github.com/devarings/fabric
• Dog-food repository (this CLI validates its own knowledge graph) : the fabric repo itself
• Intent → verb cheatsheet : CONV-llm-native-cli convention in the dog-food repo
• Session-start protocol : run fabric status first ; consult CLAUDE.md only when status surfaces something unfamiliar

License

MIT — see the root LICENSE file.