Quiet Clock is a local-only timing helper for Codex. It has no network client and no background service.
During normal use, Quiet Clock may read:
- Codex hook input passed on stdin.
- Local Codex transcript/session files when a timeline tool needs chronology.
- The local Codex session index in read-only SQLite mode.
The now tool reads no transcript data.
During normal hook and MCP operation, Quiet Clock writes nothing.
The plugin package is only a distribution wrapper around the same local hook and MCP server. It does not change what Quiet Clock reads or writes during normal operation.
The install scripts intentionally update local Codex configuration:
scripts/install_hook.shadds a marked hook block to~/.codex/config.toml.scripts/uninstall_hook.shremoves only that marked hook block.scripts/install_mcp.shregisters the localquiet_clockMCP server with Codex.
Quiet Clock does not:
- Send transcript content over the network.
- Run a daemon, watcher, cron job, launch agent, or HTTP server.
- Write memory or mutate Codex transcript files.
- Contact third parties.
- Push to GitHub.
Timeline tools default to the current thread when the caller passes the hook-injected session/thread id. They do not silently fall back to the latest local thread unless allow_latest=true is passed explicitly.
Quiet Clock refuses arbitrary transcript paths. Transcript reads are limited to Codex rollout JSONL files under the configured Codex sessions root.
Timeline outputs support:
include_snippets=falseto suppress message snippets.snippet_charsto cap snippet length.debug_paths=trueto include raw local transcript paths only when debugging.