Telegram — Naseem docs, the Mac-native AI agent

Your Mac's agent, from your phone. Message Naseem on Telegram and it works on your Mac: in your projects, with your files and tools, asking your OK the same way it does in the app. Naseem Pro.

Set it up once (about two minutes)

You need two things from Telegram: a bot for Naseem to answer as, and your user ID, so the bot answers only you.

1. Create the bot. In Telegram, open @BotFather, send /newbot, and pick a name and a username (it must end in bot). BotFather replies with a token, a long line like 123456789:AA…. Copy it.

2. Find your user ID. Open @userinfobot and send it any message. It replies with your numeric Id. Copy the number.

3. Connect Naseem. On the Mac, open Settings → Integrations → Telegram. Paste the token and press Save, paste your user ID into Allowed user ID, and turn on Enable Telegram gateway.

4. Say hello. Open your new bot in Telegram and send hi. The status in Settings shows Connected, and Naseem answers.

Only the allowed user ID can talk to the bot; messages from anyone else are ignored. Naseem must be running on your Mac, and the Mac awake, for the bot to answer.

Pick a project and a chat

Everything is chosen from the chat itself, with buttons.

1. Send /projects. Your projects appear, most recently used first, plus No project.

2. Tap a project. You're now in it. Your next message starts a new chat in that project — or tap one of its existing chats listed below to continue it.

3. Send your message. The first answer starts with a line that says where you are: 📁 quackely · Fix the sidebar.

A chat you use from the phone is an ordinary chat: it uses the project's folder, notes and roadmap, and it shows in the sidebar on the Mac under its project. You can carry on there, at your desk, at any time.

Commands

/projects — pick a project.
/chats — the recent chats in the project you're in, plus ➕ New chat.
/new — a new chat in the project you're in. Outside a project, a fresh Telegram chat.
/where — the project, chat and model you're on, and whether Naseem is working.
/stop — stop the current run.
/status — the model, whether it's running or waiting for your OK, and where you are.
/help — this list.

While it works

A run that takes more than a few seconds gets one message that keeps you posted — ⏳ Working · step 4 · run_shell — and it disappears when the answer arrives. Quick answers come on their own.
The answer is a new message, so your phone notifies you. Bold, code and links show as formatting.
Files and images Naseem makes in the run are sent to you as attachments (up to 50 MB each).
Messages you send while it's working wait their turn and run next, in order. /stop gets through at once.

Approvals

Anything that needs your OK — a command, deleting something, a commit — arrives as its own message with Approve and Deny. Nothing happens until you tap. The same request shows in the app on the Mac too; whichever you answer first wins. Answered on the Mac, the phone's message says answered in the app. A request you don't answer within five minutes is denied.

From the Mac to the phone

In any chat on the Mac, open the model menu (chip icon) → Continue on Telegram, or type /telegram. Naseem sends that chat's name to your phone, and your next message there continues it — same history, same project.

That chat is now linked to Telegram, and it stays in step both ways. What you type in it on the Mac shows on your phone as 💻 On Mac: …, followed by the progress line and the reply, so you can walk away mid-task and keep following it. Requests for your OK reach the phone too. Files Naseem makes stay on the Mac; the reply says how many there are. Only the linked chat is mirrored: your other chats on the Mac stay off Telegram. To stop mirroring, turn off Mirror the linked chat to Telegram in Settings → Integrations.

A run you start from the phone is answered on the phone: the Mac doesn't read it aloud or post a notification.

Good to know

Rules can also report to Telegram: a rule's result, and a weekly heartbeat for quiet rules (see Beta Features).
If a chat you were using is deleted, your next message goes to the Telegram chat, and the reply says so.
Your messages and Naseem's answers travel through Telegram's servers, the way any Telegram chat does. Your files, keys and the work itself stay on your Mac.
To stop, turn off Enable Telegram gateway. To revoke the bot entirely, send /revoke to @BotFather.