pleasedodisturb/chronoclaude

README preview

# ChronoClaude

**Time awareness for Claude Code.** Give Claude — and yourself — a sense of wall-clock time: a visible `[HH:MM:SS]` on every message, a hidden timing block Claude can reason about, idle-gap notes, an MCP time server, and a retrospective `/timestamps` timeline. Every surface is independently toggleable.

> **This plugin is a merge of three community plugins.** Claude Code has no native sense of time, so several people built complementary pieces of the answer. Rather than run three half-overlapping installs, this plugin stands on their shoulders and brings them together into one coherent, toggleable whole — with full attribution (see [`THIRD-PARTY-LICENSES.md`](./THIRD-PARTY-LICENSES.md)):
>
> - **[clankercode/claude-inject-idle-time](https://github.com/clankercode/claude-inject-idle-time)** — the hidden `[timing]` block, the `Stop`/`PreCompact` lifecycle, the statusline fragment, and the MCP time server.
> - **[s-a-s-k-i-a/claude-code-timestamps](https://github.com/s-a-s-k-i-a/claude-code-timestamps)** (MIT) — the retrospective `/timestamps` transcript timeline.
> - **[zoharbabin/claude-code-message-timestamps](https://github.com/zoharbabin/claude-code-message-timestamps)** (MIT) — the visible per-message `[HH:MM:SS]` marker via the `MessageDisplay` hook.

**Every surface at a glance** — one real session, with each chronoclaude surface marked:

![Annotated ChronoClaude session: a terminal showing the message timestamp, idle note, hidden timing block, tool timeline, MCP time tools, /timestamps and statusline, each marked with a numbered badge](docs/screenshots/features-overview.png)

| | Surface | What you see | Flag |
|---|---|---|---|
| 🔵 **1** | Message timestamp | `[HH:MM:SS]` on every assistant reply | `CLAUDE_TIMING_MESSAGE_DISPLAY` |
| 🟣 **2** | Idle note | `[after 5m 2s]` when you return after >10s | `CLAUDE_TIMING_IDLE_NOTE` |
| 🟡 **3** | Passive timing block | hidden `[timing]` context Claude reads each prompt | `CLAUDE_TIMING_PASSIVE` |
| 🟢 **4** | Tool timeline | auto-logs tool calls to a per-session JSONL | `CLAUDE_TIMING_TIMELINE` |

View full repository on GitHub →