What is kklaw?

kklaw is a lightweight, self-hosted Telegram bot that connects the Pi AI agent CLI to your phone. Pi is a command-line AI agent harness, kklaw acts as a personal gateway so you can chat with your Pi agent from Telegram, switch between sessions, run shell commands, and feed automated prompts to the agent, all without leaving your phone. The design philosophy is deliberately minimal: one user, one chat, one Pi instance. There is no multi-user support and no built-in scheduler. Instead, kklaw watches an inject directory on the filesystem. Any script, a cron job, a webhook, a monitoring alert, can drop a text file into that directory, and kklaw picks it up and fires its contents as a prompt into the active Pi session. The response streams back to Telegram. This makes it a general-purpose automation hook: you can schedule morning briefings, forward email notifications, or chain multiple kklaw instances together. You can switch between named Pi sessions from within Telegram using slash commands like /new, /resume, and /delete, keeping separate contexts for different tasks. Files sent as photos are passed directly to the Pi agent, files sent as documents are saved to a configurable upload directory instead. The runtime is TypeScript built with Bun. To use it, you install Pi and Bun, clone the repository, set a Telegram bot token and your Telegram user ID in a .env file, and run the bot. It can also be compiled into a standalone binary. The full README is longer than what was provided.