pi-discord-remote

Control your Pi coding-agent session from Discord — each session gets its own auto-created channel

Packages

Package details

extension

Install pi-discord-remote from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-discord-remote
Package
pi-discord-remote
Version
0.1.4
Published
May 9, 2026
Downloads
not available
Author
t2o2
License
MIT
Types
extension
Size
23.9 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-discord-remote

Control your Pi coding-agent session from Discord.

pi-discord-remote demo

Each time you run /pi-discord-remote start, the extension automatically creates a new Discord text channel named after your current project + date (e.g. kaleidoscope-may09). Messages sent in that channel are injected into Pi as user prompts; Pi's responses are posted back. When you stop, the channel is deleted — keeping your server clean within Discord's channel limit.

Install

pi install npm:pi-discord-remote

Bot setup

  1. Create a bot at discord.com/developers/applications
  2. Under Bot → Privileged Gateway Intents, enable Message Content
  3. Invite the bot to your server with these permissions:
    • Read Messages / View Channels
    • Send Messages
    • Add Reactions
    • Manage Channels ← required for auto-create/delete

Usage

/pi-discord-remote setup        — configure token, server ID, optional category
/pi-discord-remote start        — create channel + connect
/pi-discord-remote stop         — delete channel + disconnect
/pi-discord-remote status       — show connection state
/pi-discord-remote open-config  — edit config JSON in Pi's editor

Setup prompts

Field Where to find it
Bot token Discord Developer Portal → Bot → Token
Guild (Server) ID Right-click server → Copy Server ID (needs Developer Mode)
Category ID Right-click a category → Copy Category ID (optional — channels go to server root otherwise)
Allowed user IDs Right-click a user → Copy User ID (leave empty to allow everyone)

Config is stored at ~/.pi/agent/pi-discord-remote/config.json.

How it works

  • /pi-discord-remote start — bot logs in, creates a text channel named <project>-<mon><dd>, and starts listening there only
  • Incoming message — injected as a user prompt into the active Pi session; bot reacts ⏳ while Pi works, then posts the full response back
  • /pi-discord-remote stop (or Pi exit) — channel is deleted, bot disconnects

License

MIT