# Events

> use when writing background scripts that need to notify you on completion or failure, or when you need to wake yourself up immediately from an external trigger. triggers include "background task", "script finished", "notify on complete", "wake me when done", "event hook", "callback", "on error", "on success", and similar.

- Skill: `iannuttall/events` (Agent Skill)
- Install (CLI): `npx skillmds@latest add iannuttall/events`
- Raw SKILL.md: https://api.skillmd.com/api/skills/iannuttall/events/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: iannuttall (https://skillmd.com/u/iannuttall)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/iannuttall/events

---


# events

use events to wake yourself up from background scripts or external triggers.

## emit an event
always include `--chat-id <id>` using the chat_id from your current session.

`bun bob event --chat-id <id> "task_done" '{"result": "..."}'` - signal success
`bun bob event --chat-id <id> "task_failed" '{"error": "..."}'` - signal failure
`bun bob event --chat-id <id> "custom_event" '{"data": "..."}'` - any custom event

## in scripts
when writing scripts, hardcode the chat_id so it knows where to send the event.

```typescript
const CHAT_ID = 123456; // from current session

try {
  const result = await doSomething();
  await $`bun bob event --chat-id ${CHAT_ID} "task_done" '{"result": "${result}"}'`;
} catch (err) {
  await $`bun bob event --chat-id ${CHAT_ID} "task_failed" '{"error": "${err.message}"}'`;
}
```

## list pending events
`bun bob events list` - see unprocessed events