Claude Tab Tracking

claude-tab-tracking

中文文档
Know what every Claude Code session is doing — at a glance.

Live task tracking for Claude Code. Shows what each session is working on — updated automatically as the conversation progresses.

If you run multiple Claude Code sessions simultaneously, this tells you at a glance what each one is doing.

What it looks like

Status badges:
- [---] — session just started, showing directory and git branch
- [WIP] — task in progress, auto-updated each turn
- [DONE] — task completed (detected automatically)
- [SET] — task manually set with /tabtrack:task

When you finish one task and start another, the previous tasks stay visible as dimmed [DONE] lines beneath the current task (up to 2 previous tasks displayed, 3 stored).

How it works

Five Claude Code hooks work together:

Completion is detected from the conversation itself (the summarizer marks a task [完成]/done), not from Claude Code's TaskCompleted event, which fires for individual background tasks rather than the session.

The statusline script reads the task file for the current session and renders the display.

Summarization backends

The plugin picks the best available backend automatically:

No setup needed — it works out of the box with any of the above.

Choosing a backend

Set the CLAUDE_TAB_BACKEND environment variable to pick a specific backend:

When set to a specific backend, no fallback is attempted — if that backend fails, the task description is not updated. When set to auto (or unset), all backends are tried in order.

Token Budget

Control how much context /tabtrack:recall injects and how memo entries are deduplicated.

Add to ~/.claude/memos/config.yaml:

Recall loading modes:
- Full: file fits within budget → loaded as-is
- Summary: file exceeds budget → only headers + conclusions…