untether-architecture

Explain the Untether Telegram bridge architecture, event model, and configuration system.

62|7|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/littlebearapps/untether --skill untether-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: untether-architecture
Source: https://github.com/littlebearapps/untether/tree/main/.claude/skills/untether-architecture
Command: npx skills add https://github.com/littlebearapps/untether --skill untether-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive understanding of Untether's internal workings, enabling developers to effectively contribute to or modify its core infrastructure.

Core Features & Use Cases

  • Architecture Overview: Details the overall system design, including event models and data flow.
  • Configuration System: Explains how Untether is configured via TOML files and environment variables.
  • Engine Integration: Describes the process of registering and managing different AI coding agent backends.
  • Use Case: A new developer joining the Untether project can use this Skill to quickly grasp how user messages are processed, how agent tasks are executed, and how progress is reported back to Telegram.

Quick Start

Review the Untether architecture documentation to understand the data flow from the Telegram bot to the agent runner.

Frequently Asked Questions about untether-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the Untether Telegram bridge handle data flow for AI coding agents?

The Untether Telegram bridge processes user messages and routes them to an agent runner, which executes tasks and reports progress back. Events flow through the core system using the UntetherEvent abstraction to track status and send approval notifications.

How is the Untether bot configured via TOML and environment variables?

Untether is configured using TOML files and environment variables to define system settings and engine backends. This configuration system manages how different AI coding agents are registered and integrated into the bridge infrastructure.

How do I register a new AI coding agent backend in Untether?

You register a new AI coding agent backend by integrating it with Untether's engine system. The architecture uses a Runner abstraction to execute agent tasks and report progress tracking events back to the Telegram interface.

What is the UntetherEvent model used for in event tracking?

The UntetherEvent model is a core abstraction used to represent events within the Untether architecture. It facilitates progress tracking and approval notifications by defining how data flows between the Telegram bot and the agent runner.

Can I use Untether to track agent task progress and send Telegram approval notifications?

Yes, Untether tracks agent task progress and sends approval notifications through its event model. The Runner abstraction executes tasks and updates the Telegram bridge with status events, allowing users to monitor and approve actions.

What are the limitations of modifying the Untether core infrastructure?

Modifying the Untether core infrastructure requires understanding its event model, Runner abstraction, and engine backend registration. Developers must work within the constraints of its TOML configuration and environment variable system when altering data flow.