pygmy 0.3.0

Ping me — notifications from AI agents (Telegram, Discord)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

use crate::version_check;

pub async fn run() {
    let version = version_check::current_version();
    let config_dir = crate::config::config_dir_display();
    let cache_dir = crate::config::cache_dir_display();

    print!(
        "\
pygmy {version} — notifications from AI agents

USAGE
  pygmy --topic <TOPIC> <MESSAGE>           Send to all enabled backends
  pygmy --topic <TOPIC> --stdin             Read message from stdin
  echo \"...\" | pygmy --topic <TOPIC>        Pipe message from stdin
  pygmy init telegram                       Set up Telegram bot + group
  pygmy init discord-webhook                Set up Discord webhook
  pygmy init ntfy                           Set up ntfy push notifications
  pygmy enable <BACKEND>                    Enable a configured backend
  pygmy disable <BACKEND>                   Disable a configured backend
  pygmy status                              Show configured backends
  pygmy self update                         Update to latest version
  pygmy self update --check                 Check for updates without installing
  pygmy usage                               Show this reference

OPTIONS
  --topic <NAME>   Topic name (Telegram forum topic / Discord message prefix / ntfy title)

BACKENDS
  telegram         Telegram Bot API with forum topics (requires bot + group)
  discord-webhook  Discord webhook (just a URL, messages prefixed with [topic])
  ntfy             ntfy push notifications (topic + optional token, title = pygmy topic)

MESSAGES
  Messages are parsed as Markdown.
  Telegram: converted to HTML (bold, italic, code, links, blockquotes, lists).
  Discord: sent as-is (Discord renders Markdown natively).
  ntfy: sent as Markdown (rendered in web app; mobile shows raw text).
  Long messages are automatically split (4096 for Telegram/ntfy, 2000 for Discord).

CONFIG
  {config_dir}/config.toml       Backend credentials and enabled/disabled state
  {cache_dir}/topics.toml        Telegram topic name → thread ID cache (auto-managed)

SETUP
  Run `pygmy init telegram`, `pygmy init discord-webhook`, or `pygmy init ntfy` for guided setup.
  You can configure multiple — messages are sent to all enabled backends.
"
    );

    // Show update hint if cached version is newer.
    if !version_check::is_dev_build()
        && let Some(latest) = version_check::get_cached_version()
        && version_check::is_newer(version, &latest)
    {
        println!("Update available: {version} → {latest}");
        println!("Run `pygmy self update` to upgrade.");
    }
}