Skip to content

docs: correct CLAUDE.md and README.md against actual CLI#13

Merged
lewisnsmith merged 1 commit intomainfrom
claude/epic-bell-a2d8d2
Apr 25, 2026
Merged

docs: correct CLAUDE.md and README.md against actual CLI#13
lewisnsmith merged 1 commit intomainfrom
claude/epic-bell-a2d8d2

Conversation

@lewisnsmith
Copy link
Copy Markdown
Owner

Summary

Accuracy pass — compared CLAUDE.md and README.md against the live CLI source and removed every statement that contradicts the code.

CLAUDE.md

  • Project structure: collector.tsingest.ts (actual filename); removed experiments.ts (file doesn't exist)
  • CLI subcommand list on cli.ts line: was listing run, show, logs — corrected to status, proxy, serve, setup, sprites, session, annotate, log, claude, hook
  • CLI Structure block: removed non-existent flight run, flight show, flight logs (top-level alias), and the entire flight experiment block
  • All flight logsflight log (the registered command is singular; flight logs errors out)
  • Added replay-call to the log subcommand list (was missing; replay and replay-call are two different commands)
  • Added user-prompt-submit to hook registrations in both the CLI block and the Hooks section
  • Removed false "renamed to flight logs in 1.5.0" note (code never changed)
  • Slash commands: removed /flight-review, /flight-compare, /flight-annotate (not installed); fixed flight logsflight log in the two that are installed
  • Removed experiment-registry bullet from Key Patterns (feature not implemented)

README.md

  • All flight logsflight log
  • flight log replay <call-id>flight log replay-call <call-id> (wrong command name)
  • Removed "Happy-path commands" block (flight run, flight show, flight logs as alias)
  • Removed entire Experiment Registry section (CLI commands and workflow; feature not in the codebase)

Pre-Landing Review

Docs-only change. No application code modified.

Test plan

  • flight log --help shows replay and replay-call as distinct subcommands
  • flight hook --help shows all four hooks including user-prompt-submit
  • flight logs (plural) correctly fails; flight log (singular) works

🤖 Generated with Claude Code

- Fix project structure: collector.ts → ingest.ts, remove experiments.ts
- Fix CLI subcommand list (was wrong: run/show/logs/experiment never existed)
- Replace 'flight logs' (plural) with 'flight log' (actual command name)
- Add replay-call to log subcommand list alongside replay
- Add user-prompt-submit to hook registrations (was missing everywhere)
- Remove stale 'renamed to flight logs in 1.5.0' note (code never changed)
- Remove non-existent flight run/show/experiment commands from README
- Remove Experiment Registry section (feature not implemented)
- Fix slash command list: only /flight and /flight-log are installed
@lewisnsmith lewisnsmith merged commit ef00df0 into main Apr 25, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant