Skip to content
Back to search

ai-forge

MarketplaceWorks with Claude CodeGitHub

AI Forge: Claude Code sessions in Discord and Telegram

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dzotyara/ai-forge with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dzotyara/ai-forge'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dzotyara--ai-forge/badge.svg)](/listings/dzotyara--ai-forge)

HTML

<a href="/listings/dzotyara--ai-forge"><img src="/api/listings/dzotyara--ai-forge/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need Claude Code and Node.js 22+. Presence detection (whether you're at your computer) works on macOS; on other systems you're treated as away.

claude plugin marketplace add dzotyara/ai-forge
claude plugin install ai-forge@ai-forge

Open the settings panel:

node "$(ls -d ~/.claude/plugins/cache/ai-forge/ai-forge/*/ | tail -1)configure.mjs" --ui

The panel is local: it listens on `127.0.0.1` with a random key, never shows full tokens and never sends them anywhere. Pick **English** or **Русский** there.

Start a new session afterwards, or run `/reload-plugins` in an open one.

Discord

1. Create an application in the [Discord Developer Portal](https://discord.com/developers/applications). On the **Bot** tab turn on **Message Content Intent** and press **Save Changes**. 2. Invite the bot to your server with **Manage Channels**, **View Channel**, **Send Messages**, **Read Message History** and **Add Reactions**. Add **Manage Server** if you want the bot to set the server icon. 3. In the panel, **Discord** section: the bot token and your user ID (right-click yourself → Copy User ID; needs Developer Mode). The server ID is only needed if the bot is on several servers. Press **Connect Discord**. 4. In **Notifications → Where to send**, pick **Discord** or **Telegram and Discord**, save, and press **Test message**.

The bot creates an `AI Forge` category with a `🔥・general` channel and makes a channel for each session on its own. Only you and the bot see them (server owners keep access through Discord permissions). The bot takes commands and button presses from you only.

If the bot has no avatar and the server has no icon, the bot sets the anvil picture. It never replaces pictures you chose. It also switches the server's default notifications to "Only @mentions".

Telegram

1. Create a bot with [@BotFather](https://t.me/BotFather). 2. Create a group, turn on **Topics**, add the bot and make it an admin with "Manage topics". 3. Enter the token in the panel and press **Find groups**, or run the wizard: `node <plugin>/configure.mjs`.

A private chat with the bot works too: turn on Threaded Mode for the bot in @BotFather so sessions get their own topics.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "ai-forge",
  3. "description": "AI Forge: Claude Code sessions in Discord and Telegram",
  4. "owner": {
  5. "name": "dzotyara"
  6. },
  7. "plugins": [
  8. {
  9. "name": "ai-forge",
  10. "source": "./plugins/ai-forge",
  11. "description": "Claude Code sessions in Discord and Telegram: a channel per session, approval and question buttons, replies from your phone."
  12. }
  13. ]
  14. }
README.md · README · 188 lines
  1. <p align="center">
  2. <img src="docs/banner.png" alt="AI Forge" width="100%">
  3. </p>
  4. <p align="center">
  5. <b>Claude Code sessions in Discord and Telegram</b><br>
  6. Approve, answer and reply from your phone while your agents keep working on your Mac
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/dzotyara/ai-forge/stargazers"><img src="https://img.shields.io/github/stars/dzotyara/ai-forge?style=flat&color=f97316" alt="Stars"></a>
  10. <a href="https://github.com/dzotyara/ai-forge/actions/workflows/test.yml"><img src="https://github.com/dzotyara/ai-forge/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
  11. <img src="https://img.shields.io/badge/Claude%20Code-plugin-d97757" alt="Claude Code plugin">
  12. <img src="https://img.shields.io/badge/node-%E2%89%A522-3c873a" alt="Node 22+">
  13. </p>
  14. <p align="center">
  15. <b>English</b> · <a href="README.ru.md">Русский</a>
  16. </p>
  17. > ⭐ If AI Forge saves you a trip to your laptop, please star the repo. It helps other people find it and tells me it's worth building further.
  18. ## What it is
  19. AI Forge is a Claude Code plugin. Every session gets its own Discord channel (or Telegram topic), and anything that needs a human shows up there with buttons:
  20. - a permission request for a command or an edit: **Allow** / **Deny**
  21. - a multiple-choice question (`AskUserQuestion`): one button per option
  22. - "I need you" turns (`ACTION_REQUIRED`) and the next-step question at the end of a turn
  23. - a summary of every finished turn, posted silently
  24. Reply with plain text in the channel and the session wakes up and keeps going. No need to walk back to your laptop.
  25. <p align="center">
  26. <img src="docs/discord-session.png" alt="A session in Discord: a finished turn, a permission request, a question with options, and a reply" width="90%">
  27. </p>
  28. ## Features
  29. | | Discord | Telegram |
  30. |---|---|---|
  31. | A channel or topic per session | ✅ private `🤖・<name>` channel | ✅ forum topic |
  32. | Buttons for permissions and questions | ✅ | ✅ |
  33. | A text reply or a reply-to wakes the session | ✅ | ✅ |
  34. | Allow once what auto mode blocked | ✅ | ✅ |
  35. | A Boss session in the main channel, background sessions on demand | ✅ `🔥・general` | ✅ General |
  36. | `/status` `/away` `/here` `/mute` | ✅ slash commands | ✅ |
  37. | Quiet by default, a ping only when you're needed | ✅ | ✅ smart delivery |
  38. | "Playing AI Forge" on the bot and on your profile | ✅ | — |
  39. | English and Russian interface | ✅ | ✅ |
  40. Use Discord, Telegram, or both. With both, a request shows up in both places and the first answer wins.
  41. ## Screenshots
  42. | | |
  43. |---|---|
  44. | ![Approved in Discord](docs/discord-answered.png) | ![Background session request in the main channel](docs/discord-spawn.png) |
  45. | A permission and a question answered from Discord; only you see the confirmation | The Boss asks before starting a background session |
  46. | ![Your Discord profile while sessions work](docs/discord-rich-presence.png) | ![Settings panel](docs/settings-panel.png) |
  47. | Your Discord profile shows how many agents are working | The local settings panel, with an English / Русский switch |
  48. | ![A session topic in Telegram](docs/telegram-session.png) | ![Answered from Telegram](docs/telegram-answered.png) |
  49. | The same session in a Telegram topic | Allowed and answered from Telegram, then a reply |
  50. ## Install
  51. You need Claude Code and Node.js 22+. Presence detection (whether you're at your computer) works on macOS; on other systems you're treated as away.
  52. ```bash
  53. claude plugin marketplace add dzotyara/ai-forge
  54. claude plugin install ai-forge@ai-forge
  55. ```
  56. Open the settings panel:
  57. ```bash
  58. node "$(ls -d ~/.claude/plugins/cache/ai-forge/ai-forge/*/ | tail -1)configure.mjs" --ui
  59. ```
  60. The panel is local: it listens on `127.0.0.1` with a random key, never shows full tokens and never sends them anywhere. Pick **English** or **Русский** there.
  61. Start a new session afterwards, or run `/reload-plugins` in an open one.
  62. ### Discord
  63. 1. Create an application in the [Discord Developer Portal](https://discord.com/developers/applications). On the **Bot** tab turn on **Message Content Intent** and press **Save Changes**.
  64. 2. Invite the bot to your server with **Manage Channels**, **View Channel**, **Send Messages**, **Read Message History** and **Add Reactions**. Add **Manage Server** if you want the bot to set the server icon.
  65. 3. In the panel, **Discord** section: the bot token and your user ID (right-click yourself → Copy User ID; needs Developer Mode). The server ID is only needed if the bot is on several servers. Press **Connect Discord**.
  66. 4. In **Notifications → Where to send**, pick **Discord** or **Telegram and Discord**, save, and press **Test message**.
  67. The bot creates an `AI Forge` category with a `🔥・general` channel and makes a channel for each session on its own. Only you and the bot see them (server owners keep access through Discord permissions). The bot takes commands and button presses from you only.
  68. If the bot has no avatar and the server has no icon, the bot sets the anvil picture. It never replaces pictures you chose. It also switches the server's default notifications to "Only @mentions".
  69. ### Telegram
  70. 1. Create a bot with [@BotFather](https://t.me/BotFather).
  71. 2. Create a group, turn on **Topics**, add the bot and make it an admin with "Manage topics".
  72. 3. Enter the token in the panel and press **Find groups**, or run the wizard: `node <plugin>/configure.mjs`.
  73. A private chat with the bot works too: turn on Threaded Mode for the bot in @BotFather so sessions get their own topics.
  74. ## How to use it
  75. **Reply to a session.** Write in its channel. The bot reacts with 👀, the session wakes up and gets your text. Replying to a specific message works too. A session listens for 12 hours after its last turn.
  76. **Permissions.** Every permission request comes with buttons. The prompt in the app works at the same time: whichever answers first wins, and the other message is marked "Decided in the app".
  77. **Auto mode.** When the auto-mode classifier blocks an action, the channel gets what was blocked and why. **Allow once** allows exactly that call in that session for 30 minutes, and the session retries it.
  78. **The Boss.** Name any session "Boss" and it takes the main channel (`🔥・general`, or General in Telegram). Drop a task there; the Boss splits it across project sessions and starts background ones (`claude -p`) after you press **▶️ Start**. If the app closed the Boss, a message in the main channel wakes it up in the background.
  79. **Commands** (yours only):
  80. | Command | What it does |
  81. |---|---|
  82. | `/status` | mode, presence and the list of sessions |
  83. | `/away` | send everything right away for 12 hours, or until `/here` |
  84. | `/here` | smart mode |
  85. | `/mute 30m`, `/mute 2h`, `/mute off` | pause |
  86. ### When you get notified
  87. By default AI Forge stays quiet while you're at your computer and pings you only when it needs you:
  88. | Event | You're away | You're at your Mac |
  89. |---|---|---|
  90. | Permission request or question | right away, with a ping | after 90 s, if you haven't answered in the app |
  91. | The agent needs you | right away, with a ping | after 180 s, if you haven't answered |
  92. | A turn finished | silently | not sent |
  93. In Discord every message is silent, and only the ones that need you mention you. During quiet hours (`quietHours`) the mention stays but makes no sound. Once you answer in the app, the bot removes the mention from that message.
  94. ### Discord status
  95. While the background service runs, the bot shows "Playing AI Forge · working: N", where N counts every agent working right now: sessions in the middle of a turn or writing to their transcript in the last 90 seconds, child sessions, background sessions, and each running subagent. If Discord is open on the same Mac, your own profile shows it too: how many agents are working, for how long, and a button to this repo for people who look at your profile (Discord hides your own buttons from you). This needs **Settings → Activity Privacy → Share my activity** in Discord.
  96. ## Settings
  97. Everything is in the panel or in `~/.codex/telegram-action-notifier/config.json`. A missing key means the default.
  98. | Key | Default | What it does |
  99. |---|---|---|
  100. | `language` | `en` | `ru` for the Russian interface |
  101. | `notificationTarget` | `telegram` | `discord` or `both` |
  102. | `deliveryMode` | `smart` | `always`: send right away; `never`: send nothing |
  103. | `notify` | `all` | `action`: skip ordinary turns |
  104. | `approvalWaitSec` | `42900` (almost 12 h) | how long buttons wait; `0`: no buttons |
  105. | `presenceIdleSec` / `approvalGraceSec` / `actionGraceSec` | `120` / `90` / `180` | smart delivery thresholds |
  106. | `quietHours` | none | `{"from":"23:00","to":"08:00"}`: no sound |
  107. | `chatReplies` | `true` | `false`: ignore replies |
  108. | `telegramDenials` | `true` | `false`: don't send auto-mode blocks |
  109. | `bossRevive` | `true` | `false`: don't wake a stopped Boss |
  110. | `spawnConfirm` | `telegram` | `never`: start background sessions without asking |
  111. | `workerPermissions` | `telegram` | `auto`: background sessions run in `auto` mode |
  112. | `workerDefaults` | Sonnet 5.5, medium, `acceptEdits` | model, effort and mode for background sessions |
  113. | `discordActivity` | `AI Forge` | the bot's status; `""` hides it |
  114. | `discordRichPresence` | `true` | `false`: no status on your profile |
  115. ## Security
  116. - Tokens and chat IDs are stored locally only (`0600`), never in the repo or logs; secrets are cut out of messages.
  117. - The bot listens to its owner only: other people's messages and presses are silently ignored.
  118. - Background sessions can't use `bypassPermissions`. They ask with buttons for risky commands unless you chose `workerPermissions: "auto"`.
  119. - The profile status goes through Discord's local socket, with no token.
  120. ## Codex
  121. In Codex, AI Forge only sends: permission requests and "I need you" turns arrive in Discord or Telegram, and you answer in Codex.
  122. ```bash
  123. codex plugin marketplace add dzotyara/ai-forge --ref main
  124. codex plugin add ai-forge@ai-forge
  125. ```
  126. ## Development
  127. ```bash
  128. node --test plugins/ai-forge/tests/*.test.mjs
  129. ```
  130. Tests never touch the network: Telegram, Discord and Discord's socket are stubbed. The suite runs in Russian (`tests/lang-ru.mjs`); English checks import `tests/lang-en.mjs` first. Bump the version in both manifests: `plugins/ai-forge/plugin.json` and `plugins/ai-forge/.claude-plugin/plugin.json`.
  131. ---
  132. <p align="center">
  133. Like it? <a href="https://github.com/dzotyara/ai-forge">⭐ Star the repo</a>. It's the best thank-you.
  134. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.