list

list

Display a quick summary table of all captured jot notes.

Purpose

Provide a fast, read-only overview of notes without entering a full triage session (/jot:review). Supports optional filtering by project or status.

Path Resolution

The plugin root is the directory containing skills/, docs/, and .claude-plugin/. All file paths below are relative to the plugin root.

• Notes catalog: docs/notes.md

Input Format

/jot:list
/jot:list [project]
/jot:list [status]
/jot:list [project] [status]

• No arguments: show all notes
• Project filter: show only notes matching that project (e.g., aqimo, maximus-loop)
• Status filter: pending, resolved, wontfix, or all (default: all)
• Both: filter by project AND status

Workflow

Step 1: Read Catalog

Read docs/notes.md and parse all note entries.

Step 2: Apply Filters

If the user provided arguments, determine if they are a project name or status keyword:

• Status keywords: pending, resolved, wontfix, all
• Anything else is treated as a project filter

Apply matching filters. If no arguments, show all notes.

Step 3: Display Summary

Present results as a markdown table:

**Jot Notes** — [N] total ([X] pending, [Y] resolved)

| # | Project | Category | Status | Summary |
|---|---------|----------|--------|---------|
| 001 | aqimo | bug | pending | Brief summary of the raw note |
| 002 | devcoffee | feature | pending | Brief summary of the raw note |

• Summary column: First ~60 characters of the Raw field, truncated with ... if longer
• If filters are active, show: Filtered by: [project] [status]
• If no notes match the filter, say: No notes found matching "[filter]".

Step 4: Return

After displaying the table, stop. Do not ask follow-up questions or suggest actions.

Important Constraints

• Read-only — Never modify the catalog
• Fast — Read once, display once, done
• No follow-ups — Display the table and stop
• Smart argument parsing — Distinguish project names from status keywords automatically