Add README

1 files changed, 59 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..7d9c3ac
--- /dev/null
+++ b/README
@@ -0,0 +1,59 @@
+claudemon is a simple monitor for claude code sessions.
+
+The idea is to list all current claude code sessions and for each
+show their state, idle, prompt or busy.
+
+idle: Waiting for user input (60s delay)
+busy: Thinking ...
+prompt: Waiting for permission prompt (no delay)
+
+It does this by using claude code hooks.
+
+So to use it add claudemon to your claude code hooks:
+
+In ~/.claude/settings.json:
+
+  ...
+  "hooks": {
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/usr/bin/claudemon --notification"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/usr/bin/claudemon --notification"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/usr/bin/claudemon --notification"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/usr/bin/claudemon --notification"
+          }
+        ]
+      }
+    ]
+  },
+  ...