Summarize this Claude Code session, create a dedicated session note in Obsidian, and link it from today's daily note.
Instructions
- Review the full conversation history for this session.
- Come up with a short summary title (2-6 words, no date) describing the overall theme.
- Write a detailed session note in markdown. The note MUST begin with YAML frontmatter and then use the sections described below. Skip any sections that don't make sense. The only non-negotiable is the frontmatter, which must always be present. Use this template:
---
created: YYYY-MM-DD
project: <working directory name or repo name>
harness: <who you are ('claude-code', or 'codex', or 'pi', etc)>
tags:
- note/agent-session
---
# <summary title>
## Summary
<1-3 sentence overview of the session>
## What was done
- <bullet list of key actions, changes, and outcomes>
## Decisions made
- <bullet list of decisions and the reasoning behind them>
- <include trade-offs considered, alternatives rejected, and why>
## Relevant code snippets
<relevant new commands that were created, code snippets that were mentioned, etc>
## File changes
- `path/to/file` -- <what changed and why>
- <list every file that was created, modified, or deleted>
## Deferred / Postponed
- <anything discussed but intentionally left for later>
- <known issues discovered but not addressed>
- <if nothing was deferred, write "None">
## Notes
- <any additional context, gotchas, or follow-up items>
- <if $ARGUMENTS was provided, incorporate that context here or in the relevant section above>
Be thorough -- err on the side of detail. The goal is a complete record of the session.
4. Get today's date in YYYY-MM-DD format and construct the note path:
Reference/Agent Sessions/YYYY-MM-DD <summary title>
5. Find the full path to the Obsidian vault by running obsidian vault - the path will be listed.
5. Create the session note file at <path>/Reference/Agent Sessions/YYYY-MM-DD <summary title>.md
6. Append a link to the session note in today's daily note by running:
obsidian daily:append content="- [[YYYY-MM-DD <summary title>]]" silent
Formatting rules
- Frontmatter is required -- every note must start with the YAML frontmatter block
- Always include the
agent-sessiontag - Be detailed and verbose in the body -- capture the full picture of the session
- Use plain markdown (no HTML)
- Escape any double quotes in the content so the shell command works
- Focus on outcomes but include reasoning and context behind decisions
- List every file changed, not just the "key" ones
- The daily note entry should be just a link:
- [[YYYY-MM-DD <summary title>]] - For the harness frontmatter property, choose one of 'claude-code', 'codex', 'pi', etc.
Known issues
- Obsidian CLI multi-byte character bug: The
obsidianCLI fails to create notes when the content or path contains multi-byte characters (e.g., emoji, non-ASCII Unicode). Avoid using emoji or non-ASCII characters in note titles and content. Stick to plain ASCII text.