Repository navigation
Forge v0.4.0 adds an experimental Telegram entry point for the Forge native engine.
Highlights
- Submit repository tasks in a private Telegram chat, retain conversation history,
inspect status and cancel work from the same chat. - Require one-time approval for remote non-read actions. Restrict access to one
explicitly configured owner and one workspace. - Persist ingress and outgoing replies, retry failed deliveries without rerunning
completed tasks, and invalidate pending approvals after cancellation or restart. - Coordinate native and Codex workspace execution using host-local leases.
- Add bilingual Telegram onboarding and Windows gateway CI, including simulated
connection failures, timeout errors, HTTP 503 and 429 recovery.
Install
Node.js 24 or later is required.
npm install --global @jslee124/forge@0.4.0
forge --version
forge gateway --helpFollow the Telegram setup guide
or 中文教程.
The gateway runs on your computer and needs a bot token, native model credentials,
explicit owner ID, workspace binding and a running foreground process.
Verification
The implementation passed macOS live Telegram tests for conversation, approval,
denial, cancellation, stale approvals and session memory after restart. Linux
full-suite and Windows gateway CI passed on the implementation commit. The tag
publication workflow additionally validates the release source, full tests,
deterministic evaluations and a clean package installation before publishing.
See verification scope.
Telegram remains experimental. Full live acceptance with a second unauthorized
account and real network disconnection is incomplete. Network fault tests use
injected transport errors; Windows coverage is automated, not a live Telegram
trial. A model incorrectly described an earlier successful write during the smoke;
verify files and execution records rather than relying on model narration alone.
Groups, attachments, voice, Codex engine through Telegram, background installation
and Desktop gateway settings are not supported. This release does not publish new
Desktop installers. Other chat platforms are not included.
Full Changelog: v0.3.4...v0.4.0