{"id":48843082,"url":"https://github.com/nnemirovsky/ticktock","last_synced_at":"2026-04-15T03:04:18.026Z","repository":{"id":343384459,"uuid":"1177485112","full_name":"nnemirovsky/ticktock","owner":"nnemirovsky","description":"Time awareness plugin for Claude Code — injects timestamps and elapsed time into context via hooks","archived":false,"fork":false,"pushed_at":"2026-04-05T06:08:14.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T08:15:37.977Z","etag":null,"topics":["bash","claude-code","claude-code-plugin","hooks","time-awareness","timestamp"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nnemirovsky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-10T04:18:18.000Z","updated_at":"2026-04-05T06:08:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nnemirovsky/ticktock","commit_stats":null,"previous_names":["nnemirovsky/ticktock"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nnemirovsky/ticktock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nnemirovsky%2Fticktock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nnemirovsky%2Fticktock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nnemirovsky%2Fticktock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nnemirovsky%2Fticktock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nnemirovsky","download_url":"https://codeload.github.com/nnemirovsky/ticktock/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nnemirovsky%2Fticktock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31824118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","claude-code","claude-code-plugin","hooks","time-awareness","timestamp"],"created_at":"2026-04-15T03:04:16.661Z","updated_at":"2026-04-15T03:04:18.005Z","avatar_url":"https://github.com/nnemirovsky.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ticktock\n\nTime awareness for Claude Code.\n\n## What it does\n\nticktock is a Claude Code plugin that injects timestamps into Claude's context via hooks, so Claude always knows the current time and how long has passed between interactions. Smart filtering only shows elapsed time when the gap exceeds a configurable threshold (default 30 seconds), keeping token usage minimal during rapid back-and-forth exchanges.\n\n## Output examples\n\nBelow threshold (rapid interaction):\n```\n[14:32:15 UTC-7]\n```\n\nAbove threshold (gap exceeded 30s):\n```\n[14:32:15 UTC-7 | +3m25s]\n```\n\nSession start:\n```\n[Session started: 2026-04-05 14:30:00 UTC-7]\n```\n\nWith timezone display disabled (`/ticktock tz off`):\n```\n[14:32:15]\n```\n\n## Installation\n\nFrom the CLI:\n```bash\nclaude plugin marketplace add nnemirovsky/ticktock\nclaude plugin install ticktock\n```\n\nOr interactively inside Claude Code:\n```\n/plugin marketplace add nnemirovsky/ticktock\n/plugin install ticktock\n```\n\n## Configuration\n\nticktock stores its configuration at `~/.claude/ticktock.json`. A default config is created automatically on first run:\n\n```json\n{\n  \"enabled\": true,\n  \"hooks\": {\n    \"SessionStart\": true,\n    \"UserPromptSubmit\": true,\n    \"PreToolUse\": true,\n    \"PostToolUse\": true\n  },\n  \"thresholdSeconds\": 30,\n  \"showTimezone\": true,\n  \"timezone\": \"auto\"\n}\n```\n\n- `showTimezone`: whether to append timezone offset to timestamps (default: `true`)\n- `timezone`: timezone to use. `\"auto\"` detects from system. Also accepts IANA names (`America/New_York`) or UTC offsets (`UTC+3`, `UTC-5:30`). Case-insensitive.\n\n### Slash commands\n\n| Command | Description |\n|---|---|\n| `/ticktock` | Show current configuration |\n| `/ticktock on` | Enable ticktock |\n| `/ticktock off` | Disable ticktock |\n| `/ticktock threshold \u003cseconds\u003e` | Set elapsed time threshold |\n| `/ticktock hook \u003cname\u003e on\\|off` | Toggle an individual hook |\n| `/ticktock tz` | Show current timezone setting |\n| `/ticktock tz \u003ctimezone\u003e` | Set timezone (IANA name or UTC offset) |\n| `/ticktock tz auto` | Revert to system timezone auto-detection |\n| `/ticktock tz on\\|off` | Show/hide timezone in timestamps |\n\nValid hook names: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`.\n\n## Hooks\n\n| Hook | Fires when | What it reveals |\n|---|---|---|\n| `SessionStart` | Session starts, resumes, or is cleared/compacted | Full date and time of session start |\n| `UserPromptSubmit` | User submits a prompt | Current time; elapsed time since last interaction |\n| `PreToolUse` | Before a tool is invoked | Current time; how long since the previous action |\n| `PostToolUse` | After a tool completes | Current time; how long the tool execution took |\n\n## Dependencies\n\n- bash (4.0+)\n- jq (`brew install jq` on macOS)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnnemirovsky%2Fticktock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnnemirovsky%2Fticktock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnnemirovsky%2Fticktock/lists"}