149 lines
3.3 KiB
Markdown
149 lines
3.3 KiB
Markdown
# 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
|