kim — keep in mind
Skip to content
Initializing search
pratikwayal01/kim
Documentation
Links
Installation
Configuration
Commands
Sound
Slack
Development
Changelog
Documentation
Links
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) —<br>pip install kim-reminder
Linux / macOS (binary + autostart)<br>curl -fsSL https://raw.githubusercontent.com/pratikwayal01/kim/main/install.sh | bash
Windows (PowerShell as Admin, binary + autostart)<br>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<br>kim stop # Stop the daemon<br>kim status # Show running reminders<br>kim list # List all reminders from config<br>kim add -I 30m --title "Break" --message "Stand up" eye-break<br>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¶
GitHub Repository
PyPI Package
Issue Tracker
Wiki
Start small. Keep it in mind.
Back to top