cli-notifier 0.6.0

Push notifikasi ke HP via Telegram saat AI agent selesai task

CLI Notifier

Push notifikasi ke HP via Telegram saat AI agent selesai task.

AI Agent → notify → Telegram Bot API → HP

Quick Install

pipx install cli-notifier
notify --init        # Setup AI agent global (CommandCode, Claude, Copilot)
notify --setup       # Setup Telegram @radjaCLInotifierBOT

Selesai. Setiap AI agent di project mana pun bakal kirim notifikasi ke HP.

Cara Kerja

notify adalah zero-dependency Python script (stdlib aja — urllib, subprocess). Kirim notifikasi langsung ke Telegram Bot API — gak perlu backend/server sendiri.

Fitur	Status
Telegram bot bawaan — gak perlu bikin sendiri	✅
Zero dependency (stdlib only)	✅
Cross-platform (macOS, Linux, Windows)	✅
Auto-detect chat ID via getUpdates	✅
Env var override: CLI_NOTIFIER_TOKEN	✅
Global AI agent config via --init	✅
Clean uninstall via --uninstall	✅
Expo backend support (opsional)	✅

Usage

Wrap command (jalanin + notify pas selesai):

notify "sleep 5 && echo selesai"

Direct dari AI agent:

notify --agent "CommandCode" --message "Berhasil setup database"
notify --agent "Claude Code" --message "Gagal deploy" --status failed

Semua Command

Perintah	Fungsi
notify <command>	Jalankan command + notify
--message, -m	Kirim notifikasi langsung
--status, -s	success (default) / failed
--agent, -a	Nama AI agent
--setup	Setup ulang Telegram/Expo
--init	Setup AI agent global config
--uninstall	Hapus semua config
--version	Tampilkan versi

Setup Kustom

Lewati bot bawaan dan pake bot sendiri:

export CLI_NOTIFIER_TOKEN="token_dari_bot_father"
notify --setup

Atau install dari source:

git clone https://github.com/dinarradja/cli-notifier
cd cli-notifier
pipx install .
notify --init
notify --setup

Expo (Opsional)

Kalau prefer Expo instead of Telegram:

make server
notify --setup   # Pilih Expo

Development

git clone https://github.com/dinarradja/cli-notifier
cd cli-notifier
python -m venv venv && source venv/bin/activate
pip install build twine
python -m unittest tests/test_notify.py -v

Build + Publish

python -m build
python -m twine upload dist/*

Struktur Proyek

cli-notifier/
├── notify_cli.py           ← Main script (stdlib only)
├── tests/test_notify.py    ← 20 unit tests
├── backend/main.py         ← FastAPI server (opsional, untuk Expo)
├── App.js                  ← Expo app (opsional)
├── Makefile                ← Helper commands
└── .github/workflows/ci.yml ← CI pipeline