Save Claude Notes

Save Claude Notes

Save the most recent substantive user question and assistant answer as Markdown.

Default behavior

Prefer --latest; it reads the latest Q&A from the Claude Code transcript so long answers are not repeated in tool input.

--latest discovers transcripts from ~/.claude/projects using the current working directory. If discovery fails or captures the wrong turn, retry with SAVE_NOTE_CWD="PROJECT_PATH" or --transcript PATH before falling back to explicit content input.

Three supported user commands

1. Save to configured daily note

User says:

/save-claude-notes

Run:

~/.claude/skills/save-claude-notes/scripts/save-claude-notes.sh --latest

This appends to /YYYY-MM-DD.md, where notesDir comes from ~/.claude/save-claude-notes/config.json or defaults to ~/claude-notes.

2. Save to an exact .md file

User says a target ending in .md, for example:

/save-claude-notes 保存到 D:\xiao\WuKong\空.md

Run:

~/.claude/skills/save-claude-notes/scripts/save-claude-notes.sh --latest --output-file "D:/xiao/WuKong/空.md"

Treat .md paths as exact files; do not ask whether it is a directory. The script currently accepts any non-empty path, but prefer .md / .markdown files to avoid writing notes into non-note files.

3. Save to a folder directory

User says a target directory, for example:

/save-claude-notes 保存到 D:\xiao\WuKong\

Run:

~/.claude/skills/save-claude-notes/scripts/save-claude-notes.sh --latest --notes-dir "D:/xiao/WuKong"

This appends to D:/xiao/WuKong/YYYY-MM-DD.md and does not change the default config.

Fallback order

Use only one Q&A source mode per save; do not combine --latest with explicit question/answer inputs.

If --latest fails or selects the wrong Q&A, try in this order:

1. SAVE_NOTE_CWD="PROJECT_PATH" ... --latest
2. --latest --transcript PATH
3. --question-file PATH --answer-file PATH for long content
4. stdin JSON only for short content

stdin JSON repeats the full Q&A in tool input, so it costs more tokens for long answers.

Configure default notes directory

Only when the user asks to change the default directory, write this JSON to ~/.claude/save-claude-notes/config.json:

{"notesDir":"TARGET_DIRECTORY"}

Do not modify the config for one-off saves.

Safety

• Preserve Markdown formatting.
• Multi-line user questions are preserved after the generated title; redact sensitive context before saving.
• If the script refuses suspected secrets, ask the user to redact or explicitly confirm SAVE_NOTE_ALLOW_SECRETS=1.
• This skill is manual; automatic capture requires a separate hook/wrapper.
• Detailed docs live in README.md; avoid loading them unless needed.