Skip to main content

---

title: "Configuration" component_type: hook version: "1.0.0" audience: contributor status: stable summary: " Session Start Context Hook - Auto-Display Recent Activity" keywords: ['context', 'database', 'review', 'session', 'start'] tokens: ~1500 created: 2025-12-22 updated: 2025-12-22​

Session Start Context Hook - Auto-Display Recent Activity

Automatically displays recent CODITECT activity when a new session starts. This hook runs on PreToolUse and provides quick context orientation.

Hook Type: PreToolUse (runs before first tool call) Trigger: First interaction in a session

Usage in settings.json: { "hooks": { "PreToolUse": [ { "command": "python3 hooks/session-start-context.py", "timeout": 10000 } ] } }

Environment Variables:

  • CODITECT_SESSION_CONTEXT: Set to "false" to disable
  • CODITECT_CONTEXT_LEVEL: "minimal", "standard" (default), "full"

File: session-start-context.py

Functions​

get_state()​

Get or create session state.

save_state(state)​

Save session state.

should_display()​

Determine if context should be displayed.

get_db()​

Get database connection.

get_recent_activity(conn, limit)​

Get recent messages.

get_recent_decisions(conn, limit)​

Get recent decisions.

get_stats(conn)​

Get knowledge base stats.

format_minimal_context(stats)​

Format minimal context display.

format_standard_context(stats, decisions)​

Format standard context display.

format_full_context(stats, decisions, activity)​

Format full context display.

main()​

Main hook entry point.

Usage​

python session-start-context.py