Skip to content

Agent Sessions

Session ID setup, agent directories, the uv-managed Python environment, and uv dependency management

Details

WORK_BUDDY_SESSION_ID is set automatically by a SessionStart hook (.claude/hooks/session-init.sh). On Claude Code Desktop, the hook outputs it as context.

Agent directories live under data/agents//. Created automatically when wb_init is called. Contains: manifest.json, consent.db (SQLite), activity ledger (JSONL), context bundles, logs, and workflow DAG state.

To run Python, use uv (it manages the project .venv for you): uv run python # e.g. uv run python -m work_buddy.

NEVER use pip install. Use uv: - Production deps: uv add - Temporary deps: uv add --group dev - Remove: uv remove