kim — keep in mind 🧠¶

Lightweight cross-platform reminder daemon for developers.
No UI. Config-driven. Runs in the background.

Features¶

Cross-platform: Linux, macOS, Windows
Pure Python stdlib — no pip installs
Low memory: All reminders run on a single heapq scheduler thread (~0.02 MB flat)
Config-driven: JSON configuration file
Notifications: System notifications via native APIs
Sound: Custom sound files or system default
Slack integration: Webhook or bot token
One-shot reminders: kim remind "standup" in 10m — persisted to disk, survives reboots
Remove by index: kim remove 2 or kim remove 1 -o — no need to type full names
Interactive mode: TUI for managing reminders
Self-update: Automatic updates from GitHub releases

Quick Start¶

Install¶

pip (all platforms) —

pip install kim-reminder

Linux / macOS (binary + autostart)

curl -fsSL https://raw.githubusercontent.com/pratikwayal01/kim/main/install.sh | bash

Windows (PowerShell as Admin, binary + autostart)

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/pratikwayal01/kim/main/install.ps1 | iex"

That's it. kim starts automatically on login.

Basic Usage¶

kim start          # Start the daemon
kim stop           # Stop the daemon
kim status         # Show running reminders
kim list           # List all reminders from config
kim add -I 30m --title "Break" --message "Stand up" eye-break
kim remind "standup call" in 10m

Documentation¶

Home — Overview and quick start
Installation — Detailed installation instructions
Configuration — Config file reference, one-shot storage
Commands — All CLI commands
Sound — Sound configuration
Slack — Slack integration
Development — Building from source, contributing
Changelog — Version history

Links¶

Start small. Keep it in mind.