Claude Code is a terminal program: it waits for you at the keyboard. mila-companion brings it into Telegram. You write from your phone, and she replies in direct messages and in team chats, all day.
Setup takes a day — teaching her takes months.
$ mila status receiver running sender running bridge cursor 268968 / 268968 journal 1633 events outbox empty
The channel is alive: not a single message was lost.
In plain words
mila-companion is a kit that turns a Claude Code subscription into an assistant you can talk to. We built it from our Milas’ work on real businesses. Every rule inside was once learned the hard way.
How it works
The diagram runs by itself. Tap a node — it stops and tells you about it.
What’s inside
Client chat, promises and tasks, two-step emails, inbox triage, polite refusals, study cards, video reviews, Russian writing style.
skills/ →The mila command: start, channel check, inbox, promises, spending, backup, “why is the bot silent.”
One for all Milas. Ten laws: a person’s secrets, facts from tools, money and anything irreversible — only on the owner’s word.
CONSTITUTION.md →A fork of the official Telegram plugin for Claude Code. Added: a receiver that never loses messages, groups with one button, voice, quotes, buttons.
mila-telegram →A script installs everything on a clean server. First comes a dry run: it changes nothing and prints every step.
deploy/ →Measures a page at four widths: nothing overflows, the heading doesn’t spill, focus and fonts are in place.
design-gates →Who it’s for
Install it, see how it works, improve it, and propose a change. All the code is open.
Your own Mila on your own server and subscription. Your subscription, your server, your data.
See what Mila is built on and never get locked in. The code is open — we pass the craft from hand to hand.
The kit installs in a day. But for an assistant to know your business — your clients, your tone, your rules — takes time. Don’t want to install it yourself? Message me — I’ll tell you how to get your own Mila.
How to try it
You need a Claude subscription, Claude Code installed, and Bun for the plugin. Full instructions are in the README on GitHub.
Get a Claude subscription in your own name. Create a bot with @BotFather in Telegram.
First a dry run: it shows what will change. Overwritten files are saved as a copy.
git clone https://github.com/shakhruz/mila-companion
cd mila-companion
./install/install.sh --dry-run
./install/install.shInside a Claude Code session:
/plugin marketplace add shakhruz/mila-telegram
/plugin install mila-telegram@mila
/telegram:configure <token from @BotFather>Restart with the mila command, message the bot, and confirm the code. The last line matters: strangers will stop getting codes.
/telegram:access pair <code from the bot>
/telegram:access policy allowlistOne subscription — one person. You can’t share it between people: that breaks the provider’s rules and puts every account at risk.
How to help the project
We need core developers, skill creators, designers, writers, Mila operators, and testers. The first tasks are in an open list on GitHub.
License
You can install, change, and use it, including in your own business.
A fork of the official Anthropic plugin. The list of changes is in the NOTICE file.
Questions
The code is open and free, under the MIT license. You pay only for your own Claude subscription and, if needed, a server.
mila-telegram is the channel: it connects Telegram and Claude Code. mila-companion is everything else: skills, tools, rules, setup. You need both.
Messages are outside input: anyone in the chat can try to give Mila a command. So in a group she only replies by default when someone calls her. Permissions are granted with a button in the owner’s direct messages.
On your machine or your server. Backups go wherever you choose. Secrets never go into the archive.
Message Mila in Telegram. I’ll tell you how to get your own Mila without installing anything.
See what every Mila is built on. Or message her — she’ll tell you what she can do.
github.com/shakhruz/mila-companion · github.com/shakhruz/mila-telegram