Notify CLI

A CLI app to receive notifications when AFK.

Installation

``bash


Install globally

npm install -g notify-cli

Or run locally with npm

npm run dev
`

Usage

$3

Configure notification providers:

`bash
notify setup
`

This will prompt you to select a provider and enter the required credentials.

$3

Send notifications via Telegram:

`bash


Send to default recipient (must be configured during setup)

notify telegram "Your message here"

Send to a specific recipient

notify telegram 123456789 "Your message here"
`

$3

View notification history:

`bash


View all notifications

notify log

Filter by provider

notify log telegram
`

Providers

$3

Required credentials:
- Bot Token: Get one from @BotFather on Telegram
- Default Recipient (optional): Chat ID of the default recipient

Development

`bash


Install dependencies

npm install

Run in development mode

npm run dev

Build

npm run build

Run tests

npm test

Type check

npm run typecheck
`

Project Structure

`
src/
├── commands/ # CLI commands (setup, telegram, log)
├── providers/ # Notification provider implementations
├── services/ # Core services (provider config, logging)
├── utils/ # Utility functions
├── schemas.ts # Effect Schema definitions
└── index.ts # CLI entry point

tests/ # Test files
plan/ # PRD and planning files
``

License

ISC