Skip to content
Developer preview
Developer preview

Your desk, in your pocket.

stolik connects the Claude Code sessions on your own machine to a private Telegram group or Discord server. One topic or channel per project: read answers, allow or deny tool calls, and start or resume sessions from your phone.

npm install -g stolik && stolik setup

Linux · Node 22.13+ · tmux · Claude Code. Free and Apache-2.0 licensed.

stolik mascot, a blue blob carrying a terminal
oaorbit-apiClaude Code session

Demo · your PC

orbit-api · waiting for permission: Bash(npm test)

Demo

01 / quickstart

From zero to "hi from the bus" in five minutes.

One command asks for your bot token and prints the rest. You need a Telegram bot from @BotFather or a Discord bot from the Developer Portal first.

Developer preview
terminal
npm install -g stolik
stolik setup
STOLIK_PLUGIN=1 tg-claude   # claude, plus the dev-channels flag
  1. Run setup. It asks for the bot token (hidden), pairs the bot with your account, writes the config, and offers the optional voice models.
  2. Make the group. Create a private group, turn Topics on, add your bot as admin, send /bind. The bot answers only you.
  3. Start the router and add the plugin. stolik service install --start, then two /plugin lines inside Claude Code. Setup prints both.
  4. Start a session. Run STOLIK_PLUGIN=1 tg-claude in a project. A topic with the folder's name appears. Say hi from the phone.

tg-claude is claude plus --dangerously-load-development-channels. stolik is not on Anthropic's channel list, and it needs the flag until that changes. Why the flag?

Using Discord? Run stolik setup --chat discord after the install. Full install guide →

02 / features

Approve npm test from the bus stop.

Six things you can do without walking back to the desk.

One topic per project

A private Telegram group or Discord server, with a topic or channel for each project folder. Every answer names its session, so two sessions in one folder never blur.

  • orbit-api14:02All 214 tests pass.2
  • paper-kite14:01Layout tests pass.
  • tide-cli13:58Session resumed

Allow or deny, from anywhere

While you're away, permission prompts, questions and plan approvals land in the topic with buttons. Ignore one and it waits at your terminal.

  1. Bash: rm -rf node_modules
    14:02

Talk instead of typing

Send a voice note. Whisper transcribes it on your own machine and the session reads it as text. Optional addon.

  1. 0:07Rerun the migration, then show me the diff.14:03

Resume what you closed

/resume lists ended sessions. Pick one and it reopens in tmux on your PC with its history, back in its topic.

  1. /resume14:02
  2. Ended sessions14:02
  3. Session resumed

Quick, read, web

Ask without opening a session. quick: answers with no tools, read: looks at your files read-only, web: searches. Each answer shows its cost.

  1. quick: what does SIGTERM 143 mean?14:02
  2. 128 + 15. The process got SIGTERM and exited.14:02
  3. $0.002 · 3 s

Quiet at your desk

stolik sees when you're at the keyboard and stays silent. Lock the screen or walk off and answers follow you. /silent mutes one topic.

  1. You are away: pings on
  2. Done. 3 files changed.14:02
  3. /silent 2h14:02
  4. 🔕 Muted until 16:05.14:02

03 / how it works

Three parts, all on your machine.

stolik has no server and no account, and it opens no port. The router asks Telegram or Discord for new messages, so nothing calls in.

stolik

talk to all my Claude Code sessions from Telegram or Discord

One bot, two chats, many sessions. Two-way, and it pings me only when needed.

Architecture

one router, many sessions

Telegram

one group, a topic per folder

Discord

one private channel per folder

systemd --user service

Router

  • Telegram + Discord
  • Session registry
  • Presence detection
  • Voice transcription

[cat-garden]

Claude Code session

+ channel MCP server

[my-api]

Claude Code session

+ channel MCP server

[stolik]

Claude Code session

+ channel MCP server

Telegram / Discord ⇄ Router ⇄ sessionsHooks → router: Stop · Notification · UserPromptSubmit

Talking to a session

Swipe-reply

Goes to the session that sent it.

to <project>: …

Names the session in General. Works by voice too.

NEW

Plain message

In a folder topic, it goes to that folder's last session. In General, the one active in the last 30 minutes, or buttons.

When does it message me?

Only when I'm away

Away = 5 min idle, screen locked, or /away

Turn finished

Final message forwarded.

Permission prompt

Allow or deny from the phone.

Waiting for input

A nudge, so nothing stalls.

Judgment calls

Milestones, surprises, and decisions I might veto.

Phone superpowers

Voice notes

Transcribed on your PC. Speech never leaves it.

Photos & files

Land directly in the session.

Start work from the phone

New sessions in trusted folders, from anywhere.

Safety rails

  • Only the paired account
  • Secrets redacted before sending
  • Credential files can't be sent
  • Forwarded messages = untrusted data
  • No remote Allow if input was redacted
  • Phone-started sessions: trusted folders only, normal permissions
  • /lock kill switch, unlock only at the desk
  • Chat log on your PC

Built with Claude Code

Node + Telegram + Discord · runs locally

architecture
your phone ── Telegram or Discord ──▶ router (your PC, user service)
                             ├─ Claude Code session · orbit-api   (tmux)
                             ├─ Claude Code session · paper-kite  (your terminal)
                             └─ addons: voice · notes · modes · digest
  1. A router. One Node process in your login session. It talks to the Telegram or Discord bot API and keeps sessions and topics in a local SQLite file. It checks every message and tap against your user id.
  2. A Claude Code plugin. A channel and a few hooks. Each session you start with tg-claude registers with the router and gets its folder's topic.
  3. tmux, for sessions started from the phone. new orbit-api: fix the flaky test opens Claude Code in a tmux session on your PC. It is an ordinary session, so you can attach to it later at the desk.

04 / addons

The core is small. Addons do the rest.

Voice, notes, modes and digest.

Voice, notes, quick questions and the digest are addons: separate programs that get only the access their manifest declares. All of them are off until you say so. Write your own in any language that can read and write JSON lines.

05 / local-first

What runs where.

stolik is a program on your PC and a bot that you own.

No stolik server.
There is no stolik cloud, account or telemetry. The router runs on your machine and talks to Telegram or Discord with your own bot token.
Only you.
The router checks every message and every button tap against your user id. It ignores anyone else who finds the bot.
Telegram or Discord sees the chat.
What you send and what the session answers pass through the chat app, like any bot chat. They are not end-to-end encrypted. Don't have the agent post secrets.
Speech stays local.
A Whisper model on your machine transcribes voice notes. There is no hosted fallback.
Plain files.
State is one SQLite file. The chat log is JSONL, plus a readable Markdown file per day. The bot token sits in a file only your user can read.

Addons are not sandboxed. They run as you, so install only ones you have read. Claude Code talks to Anthropic as it always does, and stolik does not change that.

06 / faq

Fair questions.

Is stolik free?
Yes. It is open source under the Apache-2.0 licence and there is no paid tier or account. You pay for what you already pay for: your Claude plan. The quick, read and web modes use your Claude usage like any other run, and each answer shows what it cost.
Does my code leave my machine?
stolik has no server, and the router runs on your PC. Two things do travel. The messages in your chat (what you write and what the session answers) pass through Telegram or Discord. Claude Code talks to Anthropic exactly as it does without stolik. A model on your machine transcribes voice notes.
Why the flag?
Claude Code loads a channel plugin only if it is on Anthropic's list, and stolik is not on that list. It needs the flag until that changes. So sessions start with --dangerously-load-development-channels, which tg-claude adds for you. The flag loads one plugin, stolik's, and nothing else. The long answer.
Does stolik press Enter for me?
Yes, in one place. Claude Code shows a warning screen every time a session starts with the flag. For sessions that stolik starts from your phone, the router presses Enter on that screen through tmux, because nobody is at the keyboard. Sessions you start yourself show the warning and wait for you.
Who can talk to my bot?
Only you. Setup stores your user id, and the router checks every message and button tap against it, in the group or server and in the bot's private chat. /lock goes further: the bot ignores everything until you unlock it at the desk.
Which platforms work?
Linux, with a systemd user session. The macOS code exists, but nobody ran it on a Mac yet. WSL2 has install notes and no test run. stolik does not support native Windows.
Do I need a GPU?
No. Topics, approvals, resume, notes and the modes need no local models. Voice notes and the digest use an optional local model worker, which runs on the CPU if there is no CUDA. It needs uv, a C++ compiler and CMake to build.
Does it work with other agents or chat apps?
Today it works with Claude Code, and with Telegram or Discord. One install uses one chat app.

07 / install

Leave the desk. Keep the session.

Free, Apache-2.0 licensed, and it runs on the machine you already have.

npm install -g stolik && stolik setup