Session Start

Begin a documented coding session — create a per-session log so progress is tracked and later wrap-up (/session-end) has something to append to. Use at the start of a work session. Triggers on `/session-start`, "start a coding session", "begin a session".

iamneilroberts Updated

File contents

Start Coding Session

Begin a documented coding session so progress is tracked and context survives a /clear.

Create a session record with:

  • Timestamp: current date/time
  • Git state: current branch and commit
  • Session goals: what the session aims to accomplish
SESSION_DIR=".claude-sessions"
mkdir -p "$SESSION_DIR"
SESSION_FILE="$SESSION_DIR/session_$(date +%Y%m%d_%H%M%S).log"

echo "=== Claude Coding Session ===" > "$SESSION_FILE"
echo "Started: $(date)" >> "$SESSION_FILE"
echo "Branch: $(git branch --show-current 2>/dev/null || echo 'no git')" >> "$SESSION_FILE"
echo "Commit: $(git rev-parse --short HEAD 2>/dev/null || echo 'no git')" >> "$SESSION_FILE"
echo "" >> "$SESSION_FILE"
echo "Goals:" >> "$SESSION_FILE"

Ask the user:

  1. What are we working on today?
  2. What specific goals should this session accomplish?
  3. Any context worth knowing up front?

Record those goals in the session file and track progress against them through the session.

iamneilroberts/claude-skills/tree/main/skills/session-start commit 96dcc13aa2

Frequently asked questions

npx skillmds@latest add iamneilroberts/session-start