What is kdashboard?

Kindle Planner Dashboard is a monochrome planner screen built to run on a jailbroken Kindle, with a Telegram bot as the way you update it. Instead of typing on a tiny screen, you send a chat message like add milk to grocery and the dashboard updates itself. To use it you need a jailbroken Kindle with KUAL installed, Node.js 20 or newer for the setup scripts, an InsForge account to host the database and backend functions, and a Telegram bot token from BotFather. An OpenAI API key is optional: if you provide one, the bot can understand natural language messages, and if not, it falls back to a built in command parser with hardcoded rules for words like grocery, workout, meal, and todo. There is also an optional iOS companion app that reads step count, calories, protein, carbs, and fat from Apple Health and sends daily summaries to the backend, plus an optional Kindle cross compiler if you want to rebuild the native package yourself. Each person who sets this up runs their own copy of the backend, bot, and Kindle package rather than connecting to the original author's live system, so the project is meant to be a bring your own backend kit. The repository includes native C++ code for the Kindle e-ink renderer, InsForge edge functions for reading dashboard data, toggling tasks, live events, and handling Telegram and Health Sync uploads, Postgres migration files for chores, groceries, recipes, meal plans, health summaries, and challenge logs, and a Swift based iOS app for the health syncing feature. When a Telegram message arrives, the backend first checks a secret header and an allowed chat ID before doing anything, then tries a fast rule based parser, then OpenAI if a key is present, then falls back to the rule based parser again, always validating the result before writing to the database. The README includes setup guides for both human users and coding assistants, plus scripts for InsForge bootstrapping, Telegram webhook configuration, and Kindle install and proof checks.