lets Manual

Every verb, flag, exit code and JSON shape, one page per command. Each page is also plain markdown at the same address with .md on the end.

Install

Verbs

lets show .md

Read files, line ranges, symbols and regex-anchored context — several targets per call, with a bounded window and an honest footer.

lets find .md

Search files or directories and print hits as path:line, capped at 50 hits, reporting instead of flooding.

lets edit .md

Content-addressed, exactly-once text replacement, with the post-state and a syntax check returned in the same call.

lets transform .md

Structured edits for JSON, YAML, TOML and markdown frontmatter — a dotted path in, the changed value back, comments and order preserved.

lets write .md

Create a file from stdin, checked on creation, refusing a silent overwrite or a silent empty file.

Setup

Install and update .md

The install.sh one-liner and its flags, the dist installer, and lets update / lets version.

lets hooks and lets hook classify .md

How lets reaches an agent without asking it to remember a prose rule — installing the integration, and what the PreToolUse classifier blocks.

lets guide .md

The one-screen cheat sheet lets guide prints — verbs, targets and exit codes, meant to be read once per session.

lets stats .md

Aggregate session-transcript counts for the hook and the lets calls it drove — what each field counts, --dir, --since and --json.

Reference

Target grammar .md

The one grammar show, edit and transform speak for a path, a line, a range, a regex anchor or a symbol.

Exit codes .md

The full table of exit codes and slugs every verb can return, and the rule for branching on the slug instead of the message text.

--json and --jsonl .md

The structured output shape every reporting verb carries — one object for --json, one object per item plus a trailing stats record for --jsonl.