Install steps
- Copy files from
AI-toolkit/session-commands/into.claude/commands/ - Create folder
.claude/sessions/(if missing) - Create empty file
.claude/sessions/.current-session - Optionally add
.claude/sessions/to.gitignorefor local-only logs
Command files provided
session-start.md– defines/project:session-start, opening a new log with goals and context.session-update.md– implements/project:session-updatefor adding progress, git status, TODOs, and blockers.session-end.md– implements/project:session-endto summarise outcomes and record follow-ups.session-current.md– backs/project:session-current, printing the active session’s key details.session-list.md– enables/project:session-listto list prior sessions with timestamps.session-help.md– exposes/project:session-help, showing installation notes and command usage.README.md– quick setup reminder and troubleshooting tips.
Command catalog
| Command | Description | Suggested cadence |
|---|---|---|
/project:session-start [name] | Open a new log file with goals | At the start of every work block |
/project:session-update [note] | Append progress, git status, TODOs | After any meaningful change |
/project:session-end | Close the log with summary and next steps | Before ending your day |
/project:session-current | Show active session details | When resuming work |
/project:session-list | List all past sessions | During retros or audits |
/project:session-help | Display help text | Onboard new teammates |
Use logs across tools
| Tool | How the log helps | Action |
|---|---|---|
| Gemini | Feed the latest log snippet for context | Run gemini prompt --file session-summary.md |
| Codex | Paste session updates before asking for code help | Use codex ask -f .claude/sessions/<file> |
| OpenCode | Drop the session file into the chat | Ask for review or next steps |
| Cursor | Upload session log to the assistant side panel | Type /share ./claude/sessions/<file> |
Always mention the session name in every tool so everyone references the same history.