Session Tracker

A project-agnostic desktop checklist and AI session tracker. Works with any AI tool (Claude, Codex, Ollama, or any custom command).

Files

• desktop_checklist.py: desktop UI
• checklist_store.py: shared store and session model
• register_ai_session.py: CLI for tracked sessions
• run_tracker.sh: launcher script
• session-tracker.md: usage notes

Launch

Double-click run_tracker.sh or run:

cd ~/Desktop/DBD-Session-Tracker
python3 desktop_checklist.py

Use It From The UI

Inside the sidebar, use the Launch buttons:

• Launch Codex
• Launch Claude
• Launch Ollama
• Launch Custom

Those buttons start tracked sessions directly from the UI.

Track Real AI Sessions

Claude:

python3 register_ai_session.py wrap \
  --title "Claude work" \
  --provider Claude \
  --model Sonnet \
  --terminal claude \
  -- claude

Codex:

python3 register_ai_session.py wrap \
  --title "Codex work" \
  --provider Codex \
  --model GPT-5 \
  --terminal codex \
  -- codex

Ollama:

python3 register_ai_session.py wrap \
  --title "Local planning" \
  --provider Ollama \
  --model mistral \
  --terminal "ollama run mistral" \
  -- ollama run mistral

Any custom tool:

python3 register_ai_session.py wrap \
  --title "My tool session" \
  --provider MyTool \
  --model custom \
  --terminal mytool \
  -- mytool --flag

Storage

The tracker store persists at:

~/.session_tracker.json