Opsyra — DevOps skill for Claude Code

Opsyra

An autonomous AI coding agent orchestrator and workspace manager for Telegram, built on top of [mtcute](https://mtcute.dev) (Telegram MTProto client).

Opsyra integrates CLI coding agents (Claude Code, OpenAI Codex, Antigravity) directly into Telegram topics and direct messages, providing real-time token streaming drafts, tool call tracking, reasoning blocks, and sandboxed workspace execution.

**Note**: This project is in active development. Some features may be incomplete or contain bugs, which will be addressed in upcoming releases. The documentation and inline codebase comments were generated by Gemini.

---

Features

• MTProto Streaming Drafts: Real-time token streaming using Telegram's native typing draft actions with dynamic thinking indicators and expandable reasoning blocks.
• Agent Flow Management: Run persistent, multi-turn AI agent sessions inside dedicated Telegram forum topics or DMs.
• Multi-Environment Workspaces:
  • Host Workspace: Run agent commands directly on the host machine.
  • Branch Isolation: Sandboxed Linux OS users for individual branches or projects.
  • Remote SSH: Connect and orchestrate agents on remote Linux servers via SSH.
• Live Tool Tracking: Real-time inspection cards for running bash commands, file modifications, and web fetches.
• Access Control: Role-based permissions (Admin, Superuser, Privileged, User) with message gating.
• Storage: External MongoDB support with automatic fallback to an embedded MongoDB instance.

---

Quick Start

Prerequisites

• Node.js: 20.x or 22.x+
• Telegram API Credentials: API_ID and API_HASH from my.telegram.org/apps
• Telegram Bot Token: Created via @BotFather
• MongoDB: Optional (embedded persistent storage will be used if external MongoDB is unavailable)

Setup

1. Clone the repository:

   git clone https://github.com/playeon/opsyra.gi