digest

/digest

Process raw transcript logs and extract insights directly into artifact files.

Output Files

All in notes/digest/:

| File | What to extract | |------|-----------------| | opportunities.md | Optimization ideas - "could improve", friction points, repeated manual work, better approaches mentioned | | loose-ends.md | Open items - TODOs not done, questions unanswered, "need to" without resolution | | research-backlog.md | Future directions - "interesting", "worth exploring", novel techniques | | blog-grist.md | Significant work completed, problems solved, patterns discovered | | things-learned.md | Preferences, environment facts, workflow learnings |

Instructions

1. Find unprocessed transcripts

uv run --project ~/.claude/skills/digest digest list

If output is "Nothing new to process", stop here.

Use --path <dir> to specify a different base directory (defaults to cwd):

uv run --project ~/.claude/skills/digest digest --path /other/project list

2. Extract and analyze

For each session with new content:

uv run --project ~/.claude/skills/digest digest extract <session_id>

This outputs cleaned message text (user/assistant only, no metadata).

What to look for (include source ref [session_id:line] for each item):

Opportunities (opportunities.md):

• "could improve", "should optimize", "better way"
• Friction, repeated steps, workarounds
• Failed approaches that revealed a gap

Loose ends (loose-ends.md):

• TODOs not completed in the session
• Questions raised but not answered
• "Need to" / "should" without resolution

Research backlog (research-backlog.md):

• "Interesting", "worth exploring"
• Techniques mentioned but not tried
• Links/references saved for later

Blog grist (blog-grist.md):

• Significant work completed
• Problems solved in interesting ways
• Patterns or insights that emerged

Memories (things-learned.md):

• User preferences ("I prefer...", "don't like...")
• Environment facts (paths, configs, tools)
• Workflow patterns to remember

3. Add notes

Use the note command to add entries. It handles timestamp and formatting automatically:

uv run --project ~/.claude/skills/digest digest note notes/digest/opportunities.md --project "project-name" "- Insight here [session_id:line]"

Or pipe multiple lines:

echo "- First insight [abc123:42]
- Second insight [abc123:55]" | uv run --project ~/.claude/skills/digest digest note notes/digest/opportunities.md --project "myproject"

The CLI prepends entries with a timestamp from date '+%Y-%m-%d %H:%M'.

4. Mark processed

After extracting insights from a session:

uv run --project ~/.claude/skills/digest digest mark <session_id>

5. Report

Brief summary:

• Sessions processed: N (X new lines)
• Items added: Y opportunities, Z loose ends, etc.

Keep it short. The artifacts speak for themselves.