@leftoff/cli 0.0.0-stage → 0.6.2

package/hooks/README.md

@@ -0,0 +1,22 @@
+# Settings-hook fallback
+
+Use this when mods can't run, for example under an org policy like `allowManagedModsOnly`, or when you just don't want the mod.
+These are classic Claude Code settings hooks of type `command`. Each one runs `leftoff hook <Event>`, which works like this:
+
+- it reads the hook's JSON from stdin and POSTs it to `http://127.0.0.1:7429/v1/hooks/<Event>`
+- if the daemon is down, it spools the event to `~/checkpoints/.spool/<machine>/<session-id>/` so nothing is lost
+- it always exits 0 and prints nothing, so it never blocks or changes Claude Code
+
+Two hooks (0.4.4) are for Needs you:
+
+- `PermissionRequest` (timeout 600 s) opens a request on the board and waits. If you answer on the board, it prints that decision; if you answer in the terminal, press Esc, or nobody answers, it prints nothing and Claude Code's own dialog decides. It never allows anything by itself.
+- `PostToolUse` runs in the background (`async`) and tells the board when the terminal answered first, so the item clears.
+
+There is no reply box in hooks-only mode: a settings hook can't type into a session, so the board offers Go instead.
+
+Install them with `leftoff init --hooks` (`leftoff upgrade` refreshes them, which adds the two 0.4.4 hooks). That backs up `~/.claude/settings.json` and adds the hooks with absolute paths.
+To add them by hand, copy `settings-hooks.example.json` into your settings (with `leftoff` on your PATH). `leftoff uninstall` removes only these hooks.
+
+Hooks installed before 0.4.5 run `bin/checkpoints.js` and carry `--tag=checkpoints-hook`. They keep working (that file is now an alias of `bin/leftoff.js`), and `leftoff upgrade` replaces them with `--tag=leftoff-hook` ones, without duplicates.
+
+Without the mod you get no heartbeat, no `/cp` or `/cp-name`, and no pane. The daemon infers idle time from the last event and makes checkpoints itself. Use the web UI's "Checkpoint now" button for a manual one.

package/hooks/settings-hooks.example.json

@@ -0,0 +1,82 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook SessionStart",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook UserPromptSubmit",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook Stop",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook Notification",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook SessionEnd",
+            "timeout": 2
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook PermissionRequest",
+            "timeout": 600
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "leftoff hook PostToolUse",
+            "timeout": 5,
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}

package/mod/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "leftoff",
+  "version": "0.6.2",
+  "description": "Leftoff (formerly Checkpoints): WTF was I working on? Tracks every Claude Code session on this machine, writes a 3-line checkpoint when one goes quiet, and adds /cp (checkpoint now), /cp-name and a /leftoff pane. Talks to the local Leftoff daemon on 127.0.0.1:7429 and falls back to writing markdown in ~/checkpoints.",
+  "author": {
+    "name": "Joel"
+  },
+  "keywords": [
+    "sessions",
+    "checkpoints",
+    "status",
+    "digest",
+    "leftoff"
+  ]
+}