🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Session Closeout
πŸ¦€ ClawHub

Session Closeout

by @jkfaris94

Run a structured end-of-session closeout that checks repo hygiene, refreshes a master task list, appends a closeout block to daily memory, and verifies autom...

Versionv1.0.0
Downloads487
Stars⭐ 1
#clawhub
TERMINAL
clawhub install session-closeout

πŸ“– About This Skill

name: session-closeout description: Run a structured end-of-session closeout that checks repo hygiene, refreshes a master task list, appends a closeout block to daily memory, and verifies automation health. Use when the user asks to end a session, run closeout, wrap up, or requests /closeout. Also useful as a periodic hygiene check between work blocks.

Session Closeout

Non-destructive end-of-session checklist. Catches loose ends before context resets.

Quick Start

Run the closeout script from the workspace root:

bash "$(dirname "$0")/../scripts/session-closeout.sh"

Or with overrides (pipe-delimited):

CLOSEOUT_OUTCOMES="Shipped feature X|Fixed bug Y" \
CLOSEOUT_BLOCKERS="Waiting on API key" \
bash scripts/session-closeout.sh

What It Checks

1. Repo hygiene β€” Scans for dirty git repos (uncommitted changes). Reports but never auto-commits. 2. Task hygiene β€” Refreshes MASTER_TODO.md from project backlogs if scripts/build-master-todo.py exists. Skipped gracefully if not. 3. Memory hygiene β€” Appends a timestamped closeout block to memory/YYYY-MM-DD.md with outcomes, blockers, and next-start items. 4. Automation hygiene β€” Flags that cron/automation health should be manually verified.

Configuration

The script auto-detects the workspace root (defaults to $OPENCLAW_WORKSPACE or the current working directory). Key paths:

| Item | Default | Override | |------|---------|----------| | Workspace root | $OPENCLAW_WORKSPACE or cwd | Set env var | | Daily memory dir | $ROOT/memory/ | β€” | | Master TODO | $ROOT/MASTER_TODO.md | β€” | | TODO builder | $ROOT/scripts/build-master-todo.py | Skip if missing |

Output

The script prints structured key=value pairs. Report a concise summary to the user:

  • CLOSEOUT_STATUS β€” ok, warning, or error
  • DIRTY_REPO_COUNT β€” number of repos with uncommitted changes
  • MASTER_TODO_REFRESH β€” whether the task list was refreshed
  • EXCEPTION_COUNT β€” total issues found

    • If dirty repos are found, list them but do not auto-commit or discard. Let the user decide.

    Customization

  • To add project-specific checks (e.g., pushing status to a dashboard), extend the script or add a scripts/closeout-hooks.sh that the main script sources if present.
  • Override closeout bullets via environment variables: CLOSEOUT_OUTCOMES, CLOSEOUT_BLOCKERS, CLOSEOUT_NEXT (pipe-delimited).

    • πŸ’‘ Examples

    Run the closeout script from the workspace root:

    bash "$(dirname "$0")/../scripts/session-closeout.sh"

    Or with overrides (pipe-delimited):

    CLOSEOUT_OUTCOMES="Shipped feature X|Fixed bug Y" \
CLOSEOUT_BLOCKERS="Waiting on API key" \
bash scripts/session-closeout.sh

    βš™οΈ Configuration

    The script auto-detects the workspace root (defaults to $OPENCLAW_WORKSPACE or the current working directory). Key paths:

    | Item | Default | Override | |------|---------|----------| | Workspace root | $OPENCLAW_WORKSPACE or cwd | Set env var | | Daily memory dir | $ROOT/memory/ | β€” | | Master TODO | $ROOT/MASTER_TODO.md | β€” | | TODO builder | $ROOT/scripts/build-master-todo.py | Skip if missing |