@dreamorosi/agent-timekeeper-claude-code 0.0.0-stage → 0.2.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "agent-timekeeper",
+  "version": "0.2.0",
+  "description": "Claude Code plugin for Agent Timekeeper: records Sessions, Runs, tool calls and Interactions as Signals, and uploads them to your own endpoint",
+  "author": {
+    "name": "Andrea Amorosi"
+  },
+  "license": "Apache-2.0"
+}

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @dreamorosi/agent-timekeeper-claude-code
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A [Claude Code](https://code.claude.com) plugin for Agent Timekeeper. It records how you and your coding agents spend time in Claude Code: Sessions, Runs, model steps with their tokens and cost, tool calls, skills, subagents, and your Interactions (prompts and aborts). It uploads them to an ingestion endpoint you run yourself.
+
+It never records prompt or answer text, tool output, or more than the first two words of a shell command.
+
+## Install
+
+```sh
+claude plugin install agent-timekeeper --marketplace dreamorosi/agent-timekeeper
+```
+
+Install it at user scope, so it loads in every session. The marketplace is this repository, so the Machine needs read access to it, the same as `git clone` would. To update after a release:
+
+```sh
+claude plugin update agent-timekeeper
+```
+
+It needs Claude Code 2.1.287 or later. Plugins don't load under `--safe-mode`, `--bare`, `disableAllHooks` or organization policies that block them.
+
+## Configure
+
+The plugin shares its config with the OpenCode plugin. Create `~/.config/agent-timekeeper/config.json`, readable by you only:
+
+```sh
+mkdir -p ~/.config/agent-timekeeper
+cat > ~/.config/agent-timekeeper/config.json <<'EOF'
+{
+  "endpoint": "https://timekeeper.example.com/v1/signals",
+  "token": "<the endpoint's bearer token>"
+}
+EOF
+chmod 600 ~/.config/agent-timekeeper/config.json
+```
+
+The Machine is named after its hostname. Add `"machineId": "laptop"` to name it yourself.
+
+Until the config exists, Signals wait in `~/.local/state/agent-timekeeper/spool/`, and nothing is lost. The token is never read from a file other users can read.
+
+## Uploads
+
+The plugin uploads while a Claude Code session is open, about once a minute, and once more when the session ends. Whatever is left waits for the next session. On a Machine that also runs the OpenCode plugin, both drain the same spool, and no Signal is sent twice.
+
+Headless sessions (`claude -p`, the Agent SDK) are recorded too, marked as not interactive.
+
+## Status
+
+The plugin is silent while everything works. If the config is missing, the token is rejected, nothing has uploaded for a day, or the endpoint rejected some Signals, a toast says what's wrong and how to fix it, at most once a day. Run `/timekeeper` for the current status. It never shows the token.

package/hooks/hooks.json

@@ -0,0 +1,6 @@
+{
+  "description": "Records Sessions, Runs, steps, tool calls and Interactions as Signals, and uploads them",
+  "modules": [
+    "./register.js"
+  ]
+}