init commit

README.md

@@ -0,0 +1,148 @@
+# iamwaiting
+
+Send Discord notifications when Claude Code is waiting for your input.
+
+## What is this?
+
+`iamwaiting` is a lightweight CLI tool that integrates with Claude Code's hook system to send you Discord notifications when Claude needs your attention. Perfect for long-running tasks where you step away from your terminal.
+
+## Quick Start
+
+### 1. Install Dependencies
+
+Requires [Babashka](https://babashka.org/):
+
+```bash
+# macOS
+brew install borkdude/brew/babashka
+
+# Linux
+bash <(curl -s https://raw.githubusercontent.com/babashka/babashka/master/install)
+```
+
+### 2. Set Up Discord Webhook
+
+```bash
+./iamwaiting setup
+```
+
+Follow the prompts to enter your Discord webhook URL. Get a webhook URL from:
+Discord Server → Server Settings → Integrations → Webhooks → New Webhook
+
+### 3. Test It
+
+```bash
+./iamwaiting test
+```
+
+You should see a test message in your Discord channel!
+
+### 4. Configure Claude Code Hook
+
+Add to `~/.claude/hooks.edn`:
+
+```clojure
+{:agent-waiting-for-user {:command ["/full/path/to/iamwaiting/iamwaiting"]}}
+```
+
+Or if `iamwaiting` is in your PATH:
+
+```clojure
+{:agent-waiting-for-user {:command ["iamwaiting"]}}
+```
+
+## Usage
+
+### Manual Testing
+
+```bash
+# Send a test notification
+./iamwaiting test
+
+# Send a waiting notification
+./iamwaiting
+
+# Send notification with custom data
+./iamwaiting '{"cwd": "/path/to/project"}'
+```
+
+### Babashka Tasks
+
+```bash
+bb setup  # Run setup wizard
+bb test   # Send test message
+bb run    # Send waiting notification
+```
+
+## Configuration
+
+Configuration is stored in `~/.iamwaiting/config.edn`:
+
+```clojure
+{:webhook-url "https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN"}
+```
+
+You can also set the webhook URL via environment variable:
+
+```bash
+export IAMWAITING_WEBHOOK_URL="https://discord.com/api/webhooks/..."
+```
+
+## How It Works
+
+When Claude Code is waiting for user input, the `agent-waiting-for-user` hook is triggered, which:
+
+1. Runs the `iamwaiting` command
+2. Reads the Discord webhook URL from config
+3. Formats a message with project context (name, path, timestamp)
+4. Sends an HTTP POST to Discord's webhook API
+5. Returns success/failure status
+
+The notification appears in your Discord channel with:
+- ⏳ Waiting indicator
+- 📁 Project name and path
+- 🕐 Timestamp
+
+## Example Notification
+
+```
+⏳ **Claude is waiting** in `my-project`
+📁 Path: `/home/user/repos/my-project`
+🕐 Time: 14:23:45
+```
+
+## Troubleshooting
+
+**"No webhook URL configured"**
+- Run `./iamwaiting setup` to configure your webhook
+
+**"Failed to send message"**
+- Check your webhook URL is correct
+- Verify the webhook hasn't been deleted in Discord
+- Check your internet connection
+
+**Hook not triggering**
+- Verify `hooks.edn` syntax is correct
+- Use full absolute path to the script
+- Check Claude Code hooks documentation
+
+## Security
+
+- Keep your webhook URL secret (treat it like a password)
+- Config file has standard Unix permissions (readable only by you)
+- Only directory paths are sent in notifications (no code or sensitive data)
+
+## Requirements
+
+- Babashka (bb command)
+- Discord webhook URL
+- Internet connection
+
+## License
+
+Part of the ajet-industries monorepo.
+
+## Related Tools
+
+- [commitly](../commitly) - Multi-repo commit and push tool
+- [service-manager](../service-manager) - Microservice orchestration platform