# idle-timing

Injects invisible timing metadata into Claude Code prompts and adds an elapsed idle timer to your terminal statusline.

- plugin · `type=plugin` · Claude Code · ★ 5
- Author: clankercode
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/clankercode/claude-inject-idle-time
- Updated: 2026-06-11
- HTML: https://affpapa.org/en/nevibecode/plugins/idle-timing

## What it does

The plugin hooks into session events to give the assistant temporal context. Each user submission receives a hidden `[timing]` block recording the local timestamp, idle seconds since the last assistant turn, and prior turn runtime. A brief terminal notice shows up whenever your gap between replies passes 10 seconds.

All per-session timing state and NDJSON logs live inside the directory set by `CLAUDE_PLUGIN_DATA`. During conversation compaction, the `PreCompact` hook resets the timer so it counts from the compaction event. You can check diagnostics via `/idle-time-status` or reconfigure statusline integration with `/idle-time-setup`.

Two statusline helper scripts come in the box. The POSIX shell version updates in under 10 ms per tick by parsing the cached session file without launching a Node runtime. Without a valid `session_id` piped via standard input, the statusline fragment produces no text.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install idle-timing@claude-community
```

## When to use it
- supply local time and turn durations directly into assistant prompts
- display idle pauses between turns in the statusline
- reset session timers accurately when context compaction triggers
- log hook execution errors to NDJSON session files

## Example prompts
- /idle-time-setup
- /idle-time-status
- /idle-time-reset

## Similar
- [timing-mastery](https://affpapa.org/en/nevibecode/skills/timing-mastery.md) — skill · 554 installs
- [timing-principle-mastery](https://affpapa.org/en/nevibecode/skills/timing-principle-mastery.md) — skill · 510 installs
- [statusbar](https://affpapa.org/en/nevibecode/plugins/statusbar.md) — plugin · ★ 13
- [claude-telemetry](https://affpapa.org/en/nevibecode/plugins/claude-telemetry.md) — plugin · ★ 5
- [statusline](https://affpapa.org/en/nevibecode/skills/statusline.md) — skill · ★ 20119
- [godot-genre-idle-clicker](https://affpapa.org/en/nevibecode/skills/godot-genre-idle-clicker.md) — skill · 338 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md