outfitter-dev/waymark/waymark-cli

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-waymarks covers 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

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 --write to apply changes.
• --no-input fails fast in CI if prompts are required.

Exit Codes

Getting More Help

• Command docs: wm skill show <command>
• References: wm skill show schemas or wm 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)