@directive-run/cli 1.14.0 → 1.15.0

package/README.md

@@ -1,6 +1,16 @@
 # @directive-run/cli
 
-CLI for [Directive](https://directive.run) – project scaffolding, system introspection, AI coding rules, and more.
+CLI for [Directive](https://directive.run) – project scaffolding, system introspection, **AI coding rules for every assistant**, and more.
+
+## Quick: install AI rules for your assistant
+
+If you found this package looking for "how do I get Directive knowledge into my AI assistant?" — one command:
+
+```bash
+npx directive ai-rules init
+```
+
+Generates `.cursorrules` / `.clinerules` / `copilot-instructions.md` / `windsurf.md` / OpenAI Codex `AGENTS.md` / Claude Code `CLAUDE.md`, each tuned to that assistant's ingestion budget and conventions. The CLI auto-detects which assistants you have configured. See [IDE Integration](https://directive.run/docs/ide-integration) for the full decision tree.
 
 ## Installation
 
@@ -172,7 +182,7 @@ The `--system <path>` file must export a started Directive system as either a de
 
 ### `directive bisect <timeline.json>`
 
-Binary-search a recorded timeline for the first frame whose inclusion flips a user-supplied assertion from passing to failing — git-bisect, but over `ObservationEvent` frames.
+Binary-search a recorded timeline for the first frame whose inclusion flips a user-supplied assertion from passing to failing – git-bisect, but over `ObservationEvent` frames.
 
 ```bash
 directive bisect bug-1234.json \
@@ -181,7 +191,7 @@ directive bisect bug-1234.json \
 # ✓ bisect complete: first failing frame is #47 (fact.change)
 ```
 
-The `--system <path>` file must export a **factory** (not a started instance — bisect calls the factory once per midpoint to keep each replay hermetic). Looks for `createSystem` / `systemFactory` / `default` exports, in that order. The factory must return a started system:
+The `--system <path>` file must export a **factory** (not a started instance – bisect calls the factory once per midpoint to keep each replay hermetic). Looks for `createSystem` / `systemFactory` / `default` exports, in that order. The factory must return a started system:
 
 ```ts
 // test/bisect-system.ts
@@ -202,7 +212,7 @@ Exit codes: `0` (no failure to bisect / fails-on-empty), `2` (bisect found a fra
 
 ### `directive timeline diff <a.json> <b.json>`
 
-Semantic causal-graph diff between two serialized timelines. Not a textual JSON diff — per-category deltas (frame counts, constraint fires, mutation kinds, resolver runs, new errors).
+Semantic causal-graph diff between two serialized timelines. Not a textual JSON diff – per-category deltas (frame counts, constraint fires, mutation kinds, resolver runs, new errors).
 
 ```bash
 directive timeline diff baseline.json regression.json
@@ -248,6 +258,11 @@ const inspection = system.inspect();
 const tools = detectTools("./my-project");
 ```
 
+## Composes with
+
+- [`@directive-run/knowledge`](../knowledge) — the source-of-truth knowledge package the CLI reads from. Every rules-file generator pulls from here, so a knowledge update reaches every assistant on the next `ai-rules update`.
+- [`@directive-run/claude-plugin`](../claude-plugin) — the Claude Code plugin built from the same knowledge. Use the plugin for Claude Code; use `directive ai-rules init` for everything else.
+
 ## Contributing
 
 See [CONTRIBUTING.md](../../CONTRIBUTING.md) for development setup and contribution guidelines.