pygmy-0.2.2 is not a library.

pygmy

/ˈpɪŋ.miː/

pygmy lets AI coding agents (Claude Code, etc.) send you notifications when they finish a task, hit a blocker, or need your attention. You get a ping on your phone/desktop and come back when you're ready.

Supports Telegram (forum topics) and Discord (webhooks). Configure one or both — messages are sent to all enabled backends.

Notification is unidirectional — the agent can't read your replies, so it's just a simple "ping" to draw you back to the agent's interface.

Install

curl -fsSL https://raw.githubusercontent.com/flipbit03/pygmy/main/install.sh | sh

Or with Cargo:

cargo install pygmy

Setup

Run pygmy init <backend> and follow the instructions:

pygmy init telegram          # Telegram bot + forum group
pygmy init discord-webhook   # Discord webhook (simplest)

You can set up both. After setup, copy the config file (~/.config/pygmy/config.toml) to any machine where you run agents.

Managing backends

pygmy status                   # Show what's configured and enabled
pygmy disable telegram         # Temporarily disable a backend
pygmy enable telegram          # Re-enable it

Usage

# Send a notification to a topic
pygmy --topic "CAD-1234 auth refactor" "Done. PR #47 ready for review."

# Pipe from stdin
echo "Build failed" | pygmy --topic "deploy"

# Multiline with heredoc
pygmy --topic "investigation" --stdin <<'EOF'
**Found 3 issues:**
- Missing index on `users.email`
- N+1 in the dashboard query
- Stale cache in Redis
EOF

Messages are Markdown. Telegram messages are converted to HTML; Discord messages are sent as-is (Discord renders Markdown natively). Topics are created on first use — no manual setup needed.

What it looks like

Telegram — each topic is a separate forum thread:

📂 Pygmy Notifications (Telegram Group)
  ├─ 💬 CAD-1234 auth refactor
  │    "Done. PR #47 ready for review."
  │
  ├─ 💬 deploy
  │    "Build failed"
  │
  └─ 💬 investigation
       "Found 3 issues: ..."

Discord — messages are prefixed with the topic name:

#pygmy-notifications (Discord Channel)
  ┊ **[CAD-1234 auth refactor]**
  ┊ Done. PR #47 ready for review.
  ┊
  ┊ **[deploy]**
  ┊ Build failed

Agent integration

After setup, add this to your CLAUDE.md (or equivalent agent instructions file). pygmy init prints this snippet for you.

## Notifications (pygmy)

Use `pygmy` to notify me. Messages are Markdown, sent to all configured backends (Telegram, Discord, etc.).

**When to use:**
- When I say "ping me", "notify me", or "let me know when done"
- When completing a long-running task while I might be away
- When you hit a blocker that requires my input

**Usage:**
```bash
pygmy --topic "<topic>" "<message>"
pygmy --topic "<topic>" --stdin <<'EOF'
<long message>
EOF
```

Pick a short, descriptive topic name at the start of the session and reuse it for all messages.
Don't notify for every small step — only meaningful milestones or blockers (or when asked to).

Self-update

pygmy self update          # update to latest
pygmy self update --check  # just check

License

MIT

pygmy 0.2.2