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 /Reference/Agent Sessions/YYYY-MM-DD .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-session tag
- 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
obsidian CLI 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.
1---2name: done3description: Summarize the current agent session, create an Obsidian note for it, and link it from today's daily note. Use when the user is finished with a session and wants to log what was accomplished.4---56Summarize this Claude Code session, create a dedicated session note in Obsidian, and link it from today's daily note.78## Instructions9101. Review the full conversation history for this session.112. Come up with a short summary title (2-6 words, no date) describing the overall theme.123. 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:1314```15---16created: YYYY-MM-DD17project: <working directory name or repo name>18harness: <who you are ('claude-code', or 'codex', or 'pi', etc)>19tags:20 - note/agent-session21---2223# <summary title>2425## Summary2627<1-3 sentence overview of the session>2829## What was done3031- <bullet list of key actions, changes, and outcomes>3233## Decisions made3435- <bullet list of decisions and the reasoning behind them>36- <include trade-offs considered, alternatives rejected, and why>3738## Relevant code snippets3940<relevant new commands that were created, code snippets that were mentioned, etc>4142## File changes4344- `path/to/file` -- <what changed and why>45- <list every file that was created, modified, or deleted>4647## Deferred / Postponed4849- <anything discussed but intentionally left for later>50- <known issues discovered but not addressed>51- <if nothing was deferred, write "None">5253## Notes5455- <any additional context, gotchas, or follow-up items>56- <if $ARGUMENTS was provided, incorporate that context here or in the relevant section above>57```5859 Be thorough -- err on the side of detail. The goal is a complete record of the session.604. Get today's date in YYYY-MM-DD format and construct the note path:61 `Reference/Agent Sessions/YYYY-MM-DD <summary title>`625. Find the full path to the Obsidian vault by running `obsidian vault` - the path will be listed.635. Create the session note file at <path>/Reference/Agent Sessions/YYYY-MM-DD <summary title>.md646. Append a link to the session note in today's daily note by running:6566```67obsidian daily:append content="- [[YYYY-MM-DD <summary title>]]" silent68```6970## Formatting rules7172- **Frontmatter is required** -- every note must start with the YAML frontmatter block73- Always include the `agent-session` tag74- Be detailed and verbose in the body -- capture the full picture of the session75- Use plain markdown (no HTML)76- Escape any double quotes in the content so the shell command works77- Focus on outcomes but include reasoning and context behind decisions78- List every file changed, not just the "key" ones79- The daily note entry should be just a link: `- [[YYYY-MM-DD <summary title>]]`80- For the harness frontmatter property, choose one of 'claude-code', 'codex', 'pi', etc.8182## Known issues8384- **Obsidian CLI multi-byte character bug**: The `obsidian` CLI 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.85