102 lines
2.1 KiB
Markdown
102 lines
2.1 KiB
Markdown
|
# feat(hooks): SessionStart context injection
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
|
||
|
|
Add SessionStart hooks that inject relevant project context at the start of each session.
|
||
|
|
|
||
|
|
## Problem
|
||
|
|
|
||
|
|
Claude starts each session without knowing:
|
||
|
|
- Recent git changes
|
||
|
|
- Open issues assigned to the user
|
||
|
|
- CI status
|
||
|
|
- Current branch and uncommitted work
|
||
|
|
|
||
|
|
This leads to repeated context-gathering at the start of every session.
|
||
|
|
|
||
|
|
## Solution
|
||
|
|
|
||
|
|
SessionStart hook that runs `core` commands to gather context and inject it.
|
||
|
|
|
||
|
|
## Hook Configuration
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"hooks": {
|
||
|
|
"SessionStart": [
|
||
|
|
{
|
||
|
|
"matcher": "startup|resume",
|
||
|
|
"hooks": [
|
||
|
|
{
|
||
|
|
"type": "command",
|
||
|
|
"command": "core ai session-context",
|
||
|
|
"timeout": 30
|
||
|
|
}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
]
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Context to Gather
|
||
|
|
|
||
|
|
`core ai session-context` should collect:
|
||
|
|
|
||
|
|
1. **Git status:**
|
||
|
|
```bash
|
||
|
|
BRANCH=$(git branch --show-current)
|
||
|
|
CHANGES=$(git status --short | head -10)
|
||
|
|
```
|
||
|
|
|
||
|
|
2. **Recent activity:**
|
||
|
|
```bash
|
||
|
|
COMMITS=$(git log --oneline -5)
|
||
|
|
```
|
||
|
|
|
||
|
|
3. **Open issues (if gh available):**
|
||
|
|
```bash
|
||
|
|
ISSUES=$(core dev issues --assignee @me --limit 5)
|
||
|
|
```
|
||
|
|
|
||
|
|
4. **CI status:**
|
||
|
|
```bash
|
||
|
|
CI=$(core qa health --brief)
|
||
|
|
```
|
||
|
|
|
||
|
|
5. **Restored session state:**
|
||
|
|
```bash
|
||
|
|
if [ -f ~/.claude/sessions/scratchpad.md ]; then
|
||
|
|
# Include previous session context
|
||
|
|
fi
|
||
|
|
```
|
||
|
|
|
||
|
|
## Output Format
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"hookSpecificOutput": {
|
||
|
|
"hookEventName": "SessionStart",
|
||
|
|
"additionalContext": "## Session Context\n\n**Branch:** feature/foo\n**Uncommitted:** 3 files\n\n**Recent commits:**\n- abc123 fix: resolve test flake\n- def456 feat: add new endpoint\n\n**Your issues:**\n- #42 Bug in login flow\n- #38 Add caching\n\n**CI:** All green ✓"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Environment Variables
|
||
|
|
|
||
|
|
Also set useful env vars via `CLAUDE_ENV_FILE`:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
if [ -n "$CLAUDE_ENV_FILE" ]; then
|
||
|
|
echo "export PROJECT_ROOT=\"$(pwd)\"" >> "$CLAUDE_ENV_FILE"
|
||
|
|
echo "export GIT_BRANCH=\"$BRANCH\"" >> "$CLAUDE_ENV_FILE"
|
||
|
|
fi
|
||
|
|
```
|
||
|
|
|
||
|
|
## Conditional Context
|
||
|
|
|
||
|
|
Only inject what's relevant:
|
||
|
|
- Skip CI status if not in a repo with workflows
|
||
|
|
- Skip issues if gh not authenticated
|
||
|
|
- Skip session restore if >3 hours old
|