Поставьте задачу Claude Code, Codex, Gemini CLI или Antigravity CLI с телефона и занимайтесь своими делами. Агент работает на вашем компьютере, а ход работы, запросы на подтверждение и готовый результат приходят в чат.Поставте завдання Claude Code, Codex, Gemini CLI або Antigravity CLI з телефона й займайтеся своїми справами. Агент працює на вашому комп’ютері, а хід роботи, запити на підтвердження й готовий результат надходять у чат.Give a task to Claude Code, Codex, Gemini CLI or Antigravity CLI from your phone and get on with your day. The agent runs on your computer; its progress, approval requests and the finished result arrive in the chat.
Кодинг-агенты работают в терминале и ждут вас у монитора. AcpGram переносит общение с ними в Telegram.Кодинг-агенти працюють у терміналі й чекають на вас біля монітора. AcpGram переносить спілкування з ними в Telegram.Coding agents live in a terminal and wait for you at your desk. AcpGram moves the conversation to Telegram.
Долгий рефакторинг, тесты или разбор данных идут без вас. Когда агент закончит, результат придёт в Telegram.Довгий рефакторинг, тести чи аналіз даних ідуть без вас. Коли агент закінчить, результат прийде в Telegram.A long refactor, test run or data analysis carries on without you. When the agent finishes, the result lands in Telegram.
Агенту нужно разрешение на команду? Он спросит в чате, вы нажмёте «Разрешить» — и работа не простаивает, пока вас нет за столом.Агенту потрібен дозвіл на команду? Він запитає в чаті, ви натиснете «Дозволити» — і робота не простоює, поки вас немає за столом.Agent needs permission to run a command? It asks in the chat, you tap “Allow”, and work doesn’t stall while you’re away from your desk.
Напишите боту из метро или кафе. Агент начнёт работать в нужном проекте на вашем компьютере или сервере.Напишіть боту з метро чи кафе. Агент почне працювати в потрібному проєкті на вашому комп’ютері чи сервері.Message the bot from the subway or a café. The agent starts working in the right project on your computer or server.
Обычным сообщением, как коллеге.Звичайним повідомленням, як колезі.As a plain message, like to a colleague.
Агент спрашивает разрешение — вы нажимаете кнопку.Агент просить дозвіл — ви натискаєте кнопку.The agent asks for permission — you tap a button.
Каждый шаг агента появляется в чате.Кожен крок агента з’являється в чаті.Every agent step shows up in the chat.
Ответ и готовые файлы — прямо в Telegram.Відповідь і готові файли — просто в Telegram.The answer and finished files, right in Telegram.
Хотите увидеть всё целиком — от установки до первой задачи?Хочете побачити все повністю — від встановлення до першого завдання?Want to see the whole thing — from install to the first task? Смотрите видео на 3 минуты ↓Дивіться відео на 3 хвилини ↓Watch the 3-minute video ↓
Короткое видео, в котором весь путь показан целиком: от установки и настройки до первой задачи агенту из Telegram.Коротке відео, у якому весь шлях показано повністю: від встановлення й налаштування до першого завдання агенту з Telegram.A short video showing the whole journey: from installation and setup to the first task you send an agent from Telegram.
AcpGram сам подключается к Telegram, поэтому не нужны ни публичный IP, ни открытые порты, ни облачный посредник. С агентом он общается по открытому протоколу Agent Client Protocol (ACP).AcpGram сам підключається до Telegram, тому не потрібні ні публічна IP, ні відкриті порти, ні хмарний посередник. З агентом він спілкується за відкритим протоколом Agent Client Protocol (ACP).AcpGram connects to Telegram on its own, so you need no public IP, no open ports and no cloud middleman. It talks to the agent over the open Agent Client Protocol (ACP).
Шаги агента — чтение файлов, команды, правки — появляются в чате в реальном времени. В конце — ответ и журнал всех действий.Кроки агента — читання файлів, команди, правки — з’являються в чаті в реальному часі. Наприкінці — відповідь і журнал усіх дій.Agent steps — reading files, running commands, editing — appear in the chat live. At the end: the answer plus a log of every action.
Запросы приходят кнопками «Разрешить», «Разрешить на сессию», «Отклонить». Любую задачу можно остановить командой /stop.Запити надходять кнопками «Дозволити», «Дозволити на сесію», «Відхилити». Будь-яке завдання можна зупинити командою /stop.Requests arrive as “Allow”, “Allow for session” and “Reject” buttons. Stop any task with /stop.
Включите темы — и каждая тема чата станет отдельным диалогом со своим проектом, агентом и историей.Увімкніть теми — і кожна тема чату стане окремим діалогом зі своїм проєктом, агентом та історією.Turn on topics and every chat topic becomes its own dialog with its own project, agent and history.
Переключайте агента и модель прямо в чате. Прошлые сессии продолжаются с того же места, даже после перезапуска.Перемикайте агента й модель просто в чаті. Попередні сесії продовжуються з того ж місця, навіть після перезапуску.Switch agent and model right in the chat. Past sessions resume where they left off, even after a restart.
Отправьте агенту скриншот ошибки, PDF, таблицу или архив. Готовые файлы он пришлёт вам в чат.Надішліть агенту скриншот помилки, PDF, таблицю чи архів. Готові файли він надішле вам у чат.Send the agent a screenshot of an error, a PDF, a spreadsheet or an archive. It sends finished files back to the chat.
Пригласите коллег, задайте каждому права, доступных агентов и модели. Все действия записываются в локальный журнал.Запросіть колег, задайте кожному права, доступних агентів і моделі. Усі дії записуються в локальний журнал.Invite teammates and set each one’s rights, agents and models. Every action is recorded in a local audit log.
Нужно:Потрібно:Needs:
Claude Code + мост claude-agent-acpClaude Code + міст claude-agent-acpClaude Code + claude-agent-acp bridge
Вход в аккаунт или API-ключВхід в акаунт або API-ключAccount login or API key
Нужно:Потрібно:Needs:
Codex CLI + мост codex-acpCodex CLI + міст codex-acpCodex CLI + codex-acp bridge
Вход в аккаунт или API-ключВхід в акаунт або API-ключAccount login or API key
Нужно:Потрібно:Needs:
Только Gemini CLIЛише Gemini CLIJust Gemini CLI
Вход в аккаунт или API-ключВхід в акаунт або API-ключAccount login or API key
Нужно:Потрібно:Needs:
Только Antigravity CLI 1.5+Лише Antigravity CLI 1.5+Just Antigravity CLI 1.5+
Вход через GoogleВхід через GoogleGoogle sign-in
Достаточно одного агента. Остальные можно подключить позже — AcpGram сам найдёт установленные.Достатньо одного агента. Інших можна підключити пізніше — AcpGram сам знайде встановлені.One agent is enough. Add others later — AcpGram finds installed ones on its own.
Обычно это занимает несколько минут. Если агент у вас уже работает, понадобятся две-три команды.Зазвичай це займає кілька хвилин. Якщо агент у вас уже працює, знадобляться дві-три команди.Usually takes a few minutes. If your agent already works, you need just two or three commands.
Выберите агента, которым пользуетесь. Достаточно одного, остальные можно добавить позже.Виберіть агента, яким користуєтеся. Достатньо одного, інших можна додати пізніше.Pick the agent you use. One is enough; you can add others later.
Уже работаете в Claude Code? Тогда достаточно поставить мост, через который AcpGram с ним общается:Уже працюєте в Claude Code? Тоді достатньо встановити міст, через який AcpGram із ним спілкується:Already using Claude Code? Then you only need the bridge AcpGram uses to talk to it:
npm install -g @agentclientprotocol/claude-agent-acpnpm install -g @anthropic-ai/claude-code@latestЗатем запустите claude и войдите в аккаунт. Вместо входа можно указать ключ ANTHROPIC_API_KEY в мастере AcpGram. На Windows пригодится Git for Windows.Потім запустіть claude і увійдіть в акаунт. Замість входу можна вказати ключ ANTHROPIC_API_KEY у майстрі AcpGram. На Windows знадобиться Git for Windows.Then run claude and sign in. Instead of signing in you can enter an ANTHROPIC_API_KEY in the AcpGram wizard. On Windows, install Git for Windows.
claudeДля npm-команд нужен Node.js 24 с npm.Для npm-команд потрібен Node.js 24 з npm.npm commands need Node.js 24 with npm.
Node.js ↗Документация Claude CodeДокументація Claude CodeClaude Code docs ↗Уже работаете в Codex CLI? Поставьте мост, через который AcpGram с ним общается:Уже працюєте в Codex CLI? Встановіть міст, через який AcpGram із ним спілкується:Already using Codex CLI? Install the bridge AcpGram uses to talk to it:
npm install -g @agentclientprotocol/codex-acpnpm install -g @openai/codexcodex loginВместо входа можно указать ключ OPENAI_API_KEY в мастере AcpGram. На Windows режимам read-only и workspace-write нужен работающий sandbox Codex.Замість входу можна вказати ключ OPENAI_API_KEY у майстрі AcpGram. На Windows режимам read-only і workspace-write потрібен робочий sandbox Codex.Instead of signing in you can enter an OPENAI_API_KEY in the AcpGram wizard. On Windows, read-only and workspace-write modes need a working Codex sandbox.
Для npm-команд нужен Node.js 24 с npm.Для npm-команд потрібен Node.js 24 з npm.npm commands need Node.js 24 with npm.
Node.js ↗Документация Codex CLIДокументація Codex CLICodex CLI docs ↗Уже работаете в Gemini CLI? Ничего ставить не нужно: AcpGram подключается к нему напрямую. Переходите к шагу 2.Уже працюєте в Gemini CLI? Нічого встановлювати не потрібно: AcpGram підключається до нього напряму. Переходьте до кроку 2.Already using Gemini CLI? Nothing to install: AcpGram connects to it directly. Go to step 2.
npm install -g @google/gemini-cliЗатем запустите gemini и авторизуйтесь или укажите ключ GEMINI_API_KEY в мастере AcpGram.Потім запустіть gemini й авторизуйтеся або вкажіть ключ GEMINI_API_KEY у майстрі AcpGram.Then run gemini and sign in, or enter a GEMINI_API_KEY in the AcpGram wizard.
geminiДля npm-команд нужен Node.js 24 с npm.Для npm-команд потрібен Node.js 24 з npm.npm commands need Node.js 24 with npm.
Node.js ↗Документация Gemini CLIДокументація Gemini CLIGemini CLI docs ↗Нужна версия 1.5 или новее. Мост не нужен — достаточно один раз войти через Google:Потрібна версія 1.5 або новіша. Міст не потрібен — достатньо один раз увійти через Google:Version 1.5 or newer is required. No bridge needed — just sign in with Google once:
agy acp --loginirm https://antigravity.google/cli/install.ps1 | iexcurl -fsSL https://antigravity.google/cli/install.sh | bashОткройте новый терминал и проверьте версию:Відкрийте новий термінал і перевірте версію:Open a new terminal and check the version:
agy --versionОткройте @BotFather, отправьте /newbot, придумайте имя — и скопируйте токен, который он пришлёт. Это займёт минуту.Відкрийте @BotFather, надішліть /newbot, придумайте ім’я — і скопіюйте токен, який він надішле. Це займе хвилину.Open @BotFather, send /newbot, pick a name and copy the token it sends you. Takes a minute.
Открыть @BotFatherВідкрити @BotFatherOpen @BotFather ↗Выполните в PowerShell:Виконайте в PowerShell:Run in PowerShell:
irm https://raw.githubusercontent.com/selesnow/acpgram/main/install.ps1 | iexУстановщик скачает AcpGram, при необходимости сам поставит Node.js 24 (без прав администратора) и сразу запустит мастер настройки.Інсталятор завантажить AcpGram, за потреби сам встановить Node.js 24 (без прав адміністратора) і одразу запустить майстер налаштування.The installer downloads AcpGram, installs Node.js 24 if needed (no admin rights) and launches the setup wizard right away.
Выполните в терминале:Виконайте в терміналі:Run in a terminal:
curl -fsSL https://raw.githubusercontent.com/selesnow/acpgram/main/install.sh | bashУстановщик скачает AcpGram, при необходимости сам поставит Node.js 24 (без прав администратора) и сразу запустит мастер настройки.Інсталятор завантажить AcpGram, за потреби сам встановить Node.js 24 (без прав адміністратора) і одразу запустить майстер налаштування.The installer downloads AcpGram, installs Node.js 24 if needed (no admin rights) and launches the setup wizard right away.
В Telegram: /start → выберите папку проекта через /project → напишите, что сделать. Готово.У Telegram: /start → виберіть папку проєкту через /project → напишіть, що зробити. Готово.In Telegram: /start → pick the project folder with /project → write what to do. Done.
Нужен Node.js 22.13+ с npm. После установки запустите мастер.Потрібен Node.js 22.13+ з npm. Після встановлення запустіть майстер.Requires Node.js 22.13+ with npm. Run the wizard after installing.
npm install -g acpgramacpgram setupНастройки и база хранятся в ~/.acpgram (или ACPGRAM_HOME) и не теряются при обновлении.Налаштування й база зберігаються в ~/.acpgram (або ACPGRAM_HOME) і не губляться під час оновлення.Settings and the database live in ~/.acpgram (or ACPGRAM_HOME) and survive updates.
Нужны Git и Node.js 24+. Зависимости npm самому AcpGram не нужны.Потрібні Git і Node.js 24+. Залежності npm самому AcpGram не потрібні.Requires Git and Node.js 24+. AcpGram itself has no npm dependencies.
git clone https://github.com/selesnow/acpgram.git
cd acpgram
npm run setupЕсли отказались от сервиса, бот запускается командой:Якщо відмовилися від сервісу, бот запускається командою:If you skipped the service, start the bot with:
npm startНужны Git и Docker с Docker Compose. Все четыре агента и мосты уже внутри образа — на хост ничего ставить не нужно, мастер тоже не нужен.Потрібні Git і Docker із Docker Compose. Усі чотири агенти й мости вже всередині образу — на хост нічого встановлювати не потрібно, майстер теж не потрібен.Requires Git and Docker with Docker Compose. All four agents and bridges ship in the image — nothing to install on the host, no wizard needed.
git clone https://github.com/selesnow/acpgram.git
cd acpgram
cp .env.example .envЗаполните в .env токен бота, свой Telegram ID, ключ агента и папку с проектами. Например, для Gemini CLI:Заповніть у .env токен бота, свій Telegram ID, ключ агента й папку з проєктами. Наприклад, для Gemini CLI:Fill in .env with the bot token, your Telegram ID, the agent key and the projects folder. For example, for Gemini CLI:
TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN
ALLOWED_USER_ID=YOUR_TELEGRAM_ID
DEFAULT_ENGINE=gemini
GEMINI_API_KEY=YOUR_API_KEY
PROJECTS_DIR=./projectsdocker compose up -d --buildДля Claude Code — ANTHROPIC_API_KEY, для Codex — OPENAI_API_KEY. Antigravity CLI: после запуска один раз выполните docker compose exec -it bot agy acp --login. В контейнере агент видит только папку проектов. На Windows вместо cp используйте Copy-Item.Для Claude Code — ANTHROPIC_API_KEY, для Codex — OPENAI_API_KEY. Antigravity CLI: після запуску один раз виконайте docker compose exec -it bot agy acp --login. У контейнері агент бачить лише папку проєктів. На Windows замість cp використовуйте Copy-Item.Claude Code uses ANTHROPIC_API_KEY, Codex uses OPENAI_API_KEY. Antigravity CLI: after start, run docker compose exec -it bot agy acp --login once. Inside the container the agent sees only the projects folder. On Windows use Copy-Item instead of cp.
Обычно сервис ставит мастер. Управлять им можно так:Зазвичай сервіс встановлює майстер. Керувати ним можна так:The wizard normally installs the service. To manage it:
acpgram service install
acpgram service status
acpgram service restart
acpgram service uninstallWindows: сервис ставится через NSSM из терминала администратора и просит пароль вашей учётной записи (для аккаунта Microsoft — его пароль, не PIN). Linux: systemd --user; чтобы бот работал без входа в систему, выполните sudo loginctl enable-linger $USER. macOS: LaunchAgent.Windows: сервіс встановлюється через NSSM із термінала адміністратора й просить пароль вашого облікового запису (для акаунта Microsoft — його пароль, не PIN). Linux: systemd --user; щоб бот працював без входу в систему, виконайте sudo loginctl enable-linger $USER. macOS: LaunchAgent.Windows: the service is installed via NSSM from an administrator terminal and asks for your account password (for a Microsoft account, its password, not the PIN). Linux: systemd --user; to keep it running without a login session, run sudo loginctl enable-linger $USER. macOS: LaunchAgent.
Установили одной командой — обновляйтесь так, затем перезапустите сервис:Встановили однією командою — оновлюйтеся так, потім перезапустіть сервіс:Installed with the one-line installer? Update like this, then restart the service:
acpgram update
acpgram service restartУстановили через npm:Встановили через npm:Installed with npm:
npm install -g acpgram@latest
acpgram service restartНастройки и история сохраняются.Налаштування та історія зберігаються.Settings and history are kept.
Других пользователей добавляете вы сами и задаёте им уровень доступа: только чтение, работа с подтверждениями или полный доступ.Інших користувачів додаєте ви самі й задаєте їм рівень доступу: лише читання, робота з підтвердженнями або повний доступ.You add other users yourself and set their access level: read-only, work with approvals, or full access.
Код, настройки и история сессий остаются на компьютере с ботом. Сторонних серверов AcpGram нет.Код, налаштування й історія сесій залишаються на комп’ютері з ботом. Сторонніх серверів AcpGram немає.Code, settings and session history stay on the bot’s machine. AcpGram has no servers of its own.
Лицензия MIT: можно проверить, как устроены доступ и хранение данных, и доработать под себя.Ліцензія MIT: можна перевірити, як влаштовані доступ і зберігання даних, і доопрацювати під себе.MIT license: check how access and storage work and adapt it to your needs.
Совет: агент работает с правами пользователя, под которым запущен бот, — папка проекта не изолирует остальные файлы. Запускайте бота под отдельной учётной записью и выдавайте полный доступ (без подтверждений) только тем, кому доверяете.Порада: агент працює з правами користувача, під яким запущено бота, — папка проєкту не ізолює решту файлів. Запускайте бота під окремим обліковим записом і надавайте повний доступ (без підтверджень) лише тим, кому довіряєте.Tip: the agent runs with the rights of the account the bot runs under — the project folder does not isolate other files. Run the bot under a dedicated account and grant full access (no approvals) only to people you trust.
Обновлено: Оновлено: Updated: 2026-11-14T13:00:42+00:00 · Загрузки включают обновления, CI и автоматические скачивания, поэтому это не число пользователей.Завантаження включають оновлення, CI та автоматичні завантаження, тому це не кількість користувачів.Downloads include updates, CI and automated fetches, so they are not a user count.
Нет, это бесплатный проект с открытым кодом (лицензия MIT). Вы платите только за самого агента — подписку или API вашего провайдера, как и при работе в терминале.Ні, це безкоштовний проєкт із відкритим кодом (ліцензія MIT). Ви платите лише за самого агента — підписку або API вашого провайдера, як і під час роботи в терміналі.No. It is free and open source (MIT license). You only pay for the agent itself — your provider’s subscription or API — just as in the terminal.
Нет. Бот сам обращается к Telegram, поэтому подойдёт обычный домашний компьютер или ноутбук с интернетом. Сервер (VPS) удобен, если агент должен быть доступен круглосуточно.Ні. Бот сам звертається до Telegram, тож підійде звичайний домашній комп’ютер або ноутбук з інтернетом. Сервер (VPS) зручний, якщо агент має бути доступний цілодобово.No. The bot connects to Telegram itself, so a regular home computer or laptop with internet access is enough. A server (VPS) is handy if you want the agent available around the clock.
Да. Агент работает на той машине, где установлен AcpGram, — пока она выключена или спит, бот не ответит. После перезагрузки сервис запустит бота сам.Так. Агент працює на тій машині, де встановлено AcpGram, — поки вона вимкнена або спить, бот не відповість. Після перезавантаження сервіс запустить бота сам.Yes. The agent runs on the machine where AcpGram is installed; while it is off or asleep, the bot will not reply. After a reboot the service starts the bot again.
Да. Claude Code, Codex и Gemini CLI работают и со входом в аккаунт, и с API-ключом — как вы уже настроили агента. Antigravity CLI использует вход через Google.Так. Claude Code, Codex і Gemini CLI працюють і з входом в акаунт, і з API-ключем — як ви вже налаштували агента. Antigravity CLI використовує вхід через Google.Yes. Claude Code, Codex and Gemini CLI work with either an account login or an API key — whichever you already use. Antigravity CLI uses Google sign-in.
Только вы. Других людей вы добавляете сами — по ссылке-приглашению или одобрив запрос — и задаёте им уровень доступа: только чтение, работа с подтверждениями или полный доступ.Лише ви. Інших людей ви додаєте самі — за посиланням-запрошенням або схваливши запит — і задаєте їм рівень доступу: лише читання, робота з підтвердженнями або повний доступ.Only you. You add other people yourself — via an invite link or by approving a request — and set their access level: read-only, work with approvals, or full access.
Настройки и история сессий — в локальной базе SQLite на вашей машине. Сообщения проходят через Telegram, а сами запросы обрабатывает провайдер выбранного агента.Налаштування й історія сесій — у локальній базі SQLite на вашій машині. Повідомлення проходять через Telegram, а самі запити обробляє провайдер вибраного агента.Settings and session history live in a local SQLite database on your machine. Messages go through Telegram, and the requests themselves are processed by your agent’s provider.
Да: создайте отдельного бота для каждой машины и установите AcpGram на каждой со своим токеном. У каждого бота будет свой чат с агентами этой машины.Так: створіть окремого бота для кожної машини й встановіть AcpGram на кожній зі своїм токеном. У кожного бота буде свій чат з агентами цієї машини.Yes: create a separate bot for each machine and install AcpGram on each with its own token. Each bot gets its own chat with that machine’s agents.
На русском, украинском или английском — по языку вашего Telegram. Сменить можно командой /language.Українською, російською або англійською — за мовою вашого Telegram. Змінити можна командою /language.English, Ukrainian or Russian — matching your Telegram language. Change it with /language.
AcpGram объединяет четыре агента в одном боте, поддерживает темы Telegram как отдельные диалоги, командный доступ и журнал действий, и работает на чистом Node.js без зависимостей. У каждого проекта свои сильные стороны — сравните README и выберите подходящий.AcpGram об’єднує чотири агенти в одному боті, підтримує теми Telegram як окремі діалоги, командний доступ і журнал дій, і працює на чистому Node.js без залежностей. Кожен проєкт має свої сильні сторони — порівняйте README й виберіть відповідний.AcpGram combines four agents in one bot, supports Telegram topics as separate dialogs, team access and an audit log, and runs on plain Node.js with no dependencies. Each project has its strengths — compare the READMEs and pick what suits you.
Создайте issue на GitHub: укажите ОС, версию AcpGram, агента и шаги воспроизведения. Токены и API-ключи не прикладывайте.Створіть issue на GitHub: вкажіть ОС, версію AcpGram, агента й кроки відтворення. Токени та API-ключі не додавайте.Open an issue on GitHub with your OS, AcpGram version, agent and steps to reproduce. Never attach tokens or API keys.
Руководитель отдела аналитики Netpeak Group, автор open source R-пакетов и проекта R4marketing. Создаю инструменты для аналитики и автоматизации.Керівник відділу аналітики Netpeak Group, автор open source R-пакетів і проєкту R4marketing. Створюю інструменти для аналітики й автоматизації.Head of Analytics at Netpeak Group, author of open-source R packages and the R4marketing project. I build tools for analytics and automation.
Установка займёт несколько минут. Если AcpGram пригодился, поставьте проекту звезду на GitHub — это помогает его развивать.Встановлення займе кілька хвилин. Якщо AcpGram став у пригоді, поставте проєкту зірку на GitHub — це допомагає його розвивати.Installation takes a few minutes. If AcpGram helps you, star it on GitHub — it helps the project grow.