@atharva-again/pi-tg - npm
npm
Search<br>Sign UpSign In
@atharva-again/pi-tg
0.1.3 • Public • Published 6 hours ago<br>Readme<br>Code Beta<br>1 Dependency<br>0 Dependents<br>4 Versions<br>pi Telegram
Experimental Telegram client for pi, published as @atharva-again/pi-tg with the pi-tg binary.
Quick start
Install the package:
npm install -g @atharva-again/pi-tg
Create a Telegram bot with @BotFather.
Find your Telegram numeric user ID with @userinfobot.
Run setup:
pi-tg setup<br>pi-tg doctor<br>pi-tg
Setup writes ~/.pi/agent/telegram/config.json with 0600 permissions. Flags and<br>PI_TELEGRAM_* environment variables still work and override the saved config.
The bot uses the same pi provider configuration and credentials as the CLI.<br>Authorized Telegram users inherit the filesystem and shell permissions of the<br>user running pi-tg.
Non-interactive start
PI_TELEGRAM_BOT_TOKEN=123:abc \<br>PI_TELEGRAM_ALLOWED_USERS=123456789 \<br>pi-tg
Telegram UX
A normal DM is one pi session by default.
Telegram registers Pi's 22 built-in slash commands plus Telegram-native /start and /help.
Workspace extension, prompt, and skill commands are added to the per-chat slash menu when a Pi runtime is available.
/scoped_models is the Telegram-safe alias for Pi's /scoped-models command.
Menu-like commands use inline buttons, confirmations, document upload/download, and per-chat pending prompts.
Workspace changes are available from /settings and /session buttons without adding an extra slash command.
Normal messages are sent to pi with full tool access as the user running pi-tg.
Commands
Telegram-native commands:
/start - start the Telegram client and show help
/help - show help and command list
Pi commands:
/settings - button menu for model, thinking, scoped models, workspace, session, auth, trust, and reload actions
/model - provider/model picker followed by thinking-level buttons; also accepts /model provider/model [thinking]
/scoped_models - session-scoped model checklist for Pi model cycling
/export - choose HTML or JSONL and receive the export as a Telegram document
/import - import a local JSONL path or upload a .jsonl Telegram document
/share - confirm and create a Pi share link through the local gh CLI
/copy - send the last assistant response as copyable Telegram text
/name - show or set the session name; no-arg flow prompts for a new name
/session - session dashboard with action buttons
/changelog - paginated changelog viewer
/hotkeys - explain Telegram equivalents for TUI hotkeys
/fork - pick a prior user message with buttons or pass an entry id
/clone - confirmation flow for cloning the current session
/tree - compact tree view with buttons to navigate branches
/trust - show Telegram/process trust state and local trust guidance
/login - local-login guidance; credentials are not collected in chat
/logout - local-logout guidance for destructive credential removal
/new - confirmation flow for a new session
/compact - compact now or prompt for custom instructions
/resume - recent-session picker or /resume
/reload - reload keybindings, extensions, skills, prompts, and themes
/quit - private-chat confirmation to stop pi-tg
Readme<br>Keywords<br>pi<br>telegram<br>bot<br>agent
Package Sidebar<br>Install<br>npm i @atharva-again/pi-tg
Repository<br>Gitgithub.com/atharva-again/pi
Homepage<br>github.com/atharva-again/pi#readme
Version<br>0.1.3
License<br>MIT
Last publish<br>6 hours ago
Collaborators
atharva-again
Analyze security with SocketCheck bundle size View package health Explore dependencies<br>Report malware