outfitter-dev Waymark CLI Skill
Prerequisite
Load the using-waymarks skill first for grammar and syntax fundamentals. This skill focuses on CLI commands and workflows, assuming familiarity with waymark syntax.
Load first:
using-waymarkscovers grammar, markers, TLDRs, and ripgrep patterns.
When to Use This Skill
- Find existing waymarks and summarize project status.
- Add new TODOs, TLDRs, or notes while implementing changes.
- Edit signals (flagged/starred) or content in place.
- Remove completed waymarks with audit history.
- Format or lint waymarks for consistency in CI.
Command Overview
| Command | Purpose | Example |
|---|---|---|
| find | Scan and filter | wm find src/ --type todo --json |
| add | Insert waymarks | wm add src/auth.ts:42 todo "add retry" |
| edit | Modify waymarks | wm edit src/auth.ts:42 --flagged |
| rm | Remove waymarks | wm rm src/auth.ts:42 --write |
| fmt | Format waymarks | wm fmt src/ --write |
| lint | Validate structure | wm lint src/ --json |
| init | Write config | wm init --format toml |
| config | Print config | wm config --print --json |
| skill | Show skill docs | wm skill show add |
| update | Update CLI | wm update --yes |
| doctor | Diagnose config | wm doctor --json |
| help | Show CLI help | wm help add |
Quick Start Patterns
- Find open work:
wm find src/ --type todo --json - Add a tldr for a new file:
wm add src/new.ts:1 tldr "summary" - Flag a waymark during a refactor:
wm edit src/auth.ts:42 --flagged --write - Remove completed work safely:
wm rm src/auth.ts:42 --write
Output Formats
- Default: human-readable text
--json: JSON array (best for parsing)--jsonl: JSON lines (streaming)
Safety Model
- Most commands preview by default.
- Use
--writeto apply changes. --no-inputfails fast in CI if prompts are required.
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Waymark error |
| 2 | Usage error |
| 3 | Configuration error |
| 4 | I/O error |
Getting More Help
- Command docs:
wm skill show <command> - References:
wm skill show schemasorwm skill show exit-codes - Skill format:
wm skill show skill-format - Project-specific skills:
wm skill show project-skills - Examples:
wm skill show workflows - CLI help:
wm <command> --help
Related Skills
using-waymarks- Grammar, syntax, markers, TLDRs, and ripgrep patterns (load first)