guide

name	guide
description	Show a quick-reference guide for all Token Pilot tools — when to use each one
command	guide
user_invocable	true
effort	low
disallowed-tools	["Bash","Edit","MultiEdit","Write","Task"]

Display the following Token Pilot tool reference to the user. Show it exactly as formatted below.

---

Token Pilot — Tool Reference

Reading code

Goal	Tool
Explore a file's structure	smart_read(path)
Read one function or class	read_symbol(path, symbol="ClassName.method")
Read a specific line range	read_range(path, start, end)
Get edit-ready exact text	read_for_edit(path, symbol="name")
Read many files at once	smart_read_many([paths])

Exploring a codebase

Goal	Tool
First look at a new project	project_overview()
All symbols in a file	outline(path)
Deep dive on one area	explore_area(path)
Related files (imports, tests)	related_files(path)
Module deps + public API	module_info(module_path)

Finding things

Goal	Tool
Where a symbol is used	find_usages(symbol)
Symbols with no references	find_unused(path)

After editing

Goal	Tool
Verify your edit is correct	read_diff(path)

Git & tests

Goal	Tool
Understand recent commits	smart_log()
Review a diff structurally	smart_diff(base, head)
Parse test output	test_summary(command)

Code quality

Goal	Tool
Find TODOs, deprecated, patterns	code_audit(path)

Session

Goal	Tool
Token savings this session	session_analytics()

---

Workflow: project_overview → explore_area → smart_read → read_symbol → read_for_edit → edit → read_diff

Tip: smart_read on a file you've already read returns a compact reminder (dedup) — no wasted tokens.