From trueline-mcp
Guides efficient file workflows with trueline MCP tools (read, edit, search, outline, verify, changes) — hash-verified edits, ref-based reuse, and search-then-edit patterns that cut context tokens 60-90%.
How this skill is triggered — by the user, by Claude, or both
Slash command
/trueline-mcp:trueline-workflowThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Trueline MCP tools replace built-in `Read`/`Edit`/`Grep` with hash-verified, streaming, ref-based equivalents. Catches hallucinated edits, cuts tokens. Use in right order.
Trueline MCP tools replace built-in Read/Edit/Grep with hash-verified, streaming, ref-based equivalents. Catches hallucinated edits, cuts tokens. Use in right order.
The same six tools are also available as a standalone trueline shell binary (at bin/trueline in the repo), useful for shell scripts, CI pipelines, and git hooks where no MCP-aware agent is running. The same hash-verification guarantees apply.
trueline outline <paths...>
trueline read <paths...> [--ranges 10-20]
trueline search <pattern> <paths...> [-i] [-r] [--multiline] [-C N]
trueline edit <path> --edits @file|-|<flat flags>
trueline verify <path> --refs ...
trueline changes [paths...] # alias: diff
Every subcommand accepts --help/-h. Pass --json on any subcommand for {ok, result} machine-readable output. Exit codes: 0 ok, 1 search no match, 2 tool error, 3 usage error.
Use MCP tools (this skill) for in-agent file work. Use the CLI for anything outside an agent context.
| Tool | Use when | Why |
|---|---|---|
trueline_outline | First look, any file | ~10-20 lines vs hundreds |
trueline_search | Know target string/symbol | Lines with hash prefixes + refs, one call |
trueline_read | Need exact edit context | Per-line hashes + checksums; globs and path:range |
trueline_edit | All edits | Hash-verified, atomic; built-in Edit blocked by hook |
trueline_verify | Refs held across turns | Checks staleness without re-read |
trueline_changes | Review vs git | Symbol-level semantic diff |
Pick one matching what you know.
trueline_search(file_paths, pattern) -> trueline_edit
No read step. trueline_search returns lines with hash prefixes plus ref. Feed straight into trueline_edit. Fastest. Use for renames, string swaps, bugfixes on named function.
trueline_outline -> trueline_read (targeted ranges) -> trueline_edit
Outline gives structure. Read only ranges you need. trueline_read accepts path:startLine-endLine inline for multiple slices in one call.
trueline_verify(refs) -> re-read only stale ranges -> trueline_edit
Nothing changed -> edit straight away. Stale -> re-read just that range. Never re-read whole file on spec.
trueline_search output:
->ab10 old line one
cd11 old line two
ref: ab10-cd11/efghij
Replace both:
trueline_edit(
file_path=…,
edits=[{ range: "ab10-cd11", ref: "ab10-cd11/efghij", content: "new line one\nnew line two" }]
)
range uses hashLine identifiers verbatim from output.ref is the full range checksum (e.g. ab10-cd11/efghij) — copy verbatim, never guess.-> are matches; lines without -> are context. Both carry hashLine identifiers usable in range.Non-negotiable. Violations -> verification errors or silent data loss.
ab10-cd11/efghij) directly from output. Made-up ref fails verification.ab10) required. Not decoration — verify content at that line.action="insert_after" to add lines. Without it, range is replaced and content lost. To add next to existing lines, pass action: "insert_after".hashLine from prior search/read, go straight to trueline_edit.Editing many files? Use Grep to find files, then pass all paths to one trueline_search call. Refs for every match in one round-trip.
If trueline schemas deferred, load in one batch:
ToolSearch("+trueline read edit")
Loads all six schemas together. One call, not six.
trueline_outline.trueline_search -> trueline_edit.trueline_changes.trueline_verify.npx claudepluginhub rjkaes/trueline-mcp --plugin trueline-mcpEdits code via hash-anchored tilth MCP edits, replacing sed/awk/perl/patch and shell redirects. Supports surgical edits and ast-grep structural codemods spanning many files.
Provides complete reference to Claude Code's built-in file tools (Read, Write, Edit, Glob, Grep) and shell tool (Bash), including parameters, capabilities, and rules. Useful for recalling tool usage details.
Provides file and directory operations using Claude Code's native Read, Write, Edit, Grep, Glob, and Bash tools, replacing the Filesystem MCP server. Useful for reading, writing, editing, searching, and navigating files.