Cheatsheet
Every command, every flag, every config key, and every tracker value. One screen, for a human eye.
| Group | Item | Meaning |
|---|---|---|
| Agent commands | wayfinder | print the wayfinder skill — the same bytes as wayfinder skill wayfinder |
| wayfinder skill <id> | print one rendered skill as markdown | |
| wayfinder skills | list every served id, with its description and children | |
| Setup commands | wayfinder init | write the harness stub; idempotent, and reports a diff on a repair |
| wayfinder tracker show | the effective tracker value, its doc, and the scope that won | |
| wayfinder tracker set <value> | record this repo's issue tracker; the value is freeform | |
| wayfinder ticket-skill add <name> | register a harness skill; --when is required | |
| wayfinder ticket-skill edit <name> | change a when sentence; --when is required | |
| wayfinder ticket-skill remove <name> | delete the registration in that scope, or tombstone an inherited one | |
| wayfinder ticket-skill list | every effective registration, with the scope that supplied it | |
| wayfinder doctor | unresolvable skill names and doc paths; exits 1 on any finding | |
| Flags | --harness claude,agents | init: the install targets, comma-separated |
| --tracker "<value>" | init: record the tracker in project scope in the same pass | |
| --doc <path> | tracker set: attach your own operations prose by path | |
| --user | tracker set: write user scope instead of project | |
| --when "<sentence>" | ticket-skill add and edit: the required relevance condition | |
| --scope local|project|user | ticket-skill: which config file to write; default project | |
| --json | JSON instead of TOON, on every list and status command | |
| --version, -V | print the version | |
| --help, -h | print the full setup page | |
| Config keys | tracker.value | the freeform tracker value, for example "github cli" |
| tracker.doc | path to your own operations doc, resolved from its own config file | |
| ticketSkills.<name>.when | the required relevance sentence for one registration | |
| ticketSkills.<name>: null | a tombstone — hides a registration inherited from a broader scope | |
| Config scopes | ~/.config/wayfinder/config.json | user — not committed; follows $XDG_CONFIG_HOME when it is set |
| .wayfinder/config.json | project — committed, and the default for every write | |
| .wayfinder/local.json | local — ignored by git, and it wins | |
| tracker | resolves wholesale — the nearest scope supplies value and doc together | |
| ticketSkills | resolves as a union of every scope, keyed by name | |
| Tracker values | github cli | ships operations prose — the reference doc |
| gitlab | ships operations prose | |
| local | ships operations prose — markdown files in the repo | |
| github mcp | planned; no prose ships yet, so it behaves as a custom value | |
| gitlab cli | planned; no prose ships yet | |
| jira mcp | planned; no prose ships yet | |
| linear mcp | planned; no prose ships yet | |
| anything else | custom — the render names it and leaves the operations to your agent | |
| --doc <path> | attach your own prose to any value; it replaces a shipped doc | |
| Skill ids | wayfinder | chart a map, then work its tickets — no children |
| grilling | the decision-conversation protocol — no children | |
| domain-modeling | children: domain-modeling/adr-format, domain-modeling/context-format | |
| grill-with-docs | children: domain-modeling/adr-format, domain-modeling/context-format | |
| research | read primary sources, capture the findings — no children | |
| prototype | children: prototype/logic, prototype/ui | |
| to-spec | a closed map becomes a spec — no children | |
| to-tickets | a spec becomes implementation tickets — no children | |
| tracker | the tracker block alone, in whichever of its three states applies | |
| Ticket labels | wayfinder:map | the map issue itself |
| wayfinder:grilling | a decision conversation | |
| wayfinder:research | a fact outside the working directory that a decision waits on | |
| wayfinder:prototype | a rough artifact raises the fidelity of the discussion | |
| wayfinder:task | manual work that unblocks a decision | |
| ready-for-agent | zero human input needed (AFK) | |
| ready-for-human | human oversight needed (HITL) |