remote-control-on-demand

# RCOD: Remote Control On Demand

[![Build](https://github.com/zevro-ai/remote-control-on-demand/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/zevro-ai/remote-control-on-demand/actions/workflows/build.yml)
[![Release](https://github.com/zevro-ai/remote-control-on-demand/actions/workflows/release.yml/badge.svg)](https://github.com/zevro-ai/remote-control-on-demand/actions/workflows/release.yml)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)

RCOD is an operator console for AI coding sessions. It runs on your machine or server, discovers git repositories under one base folder, and gives you two control surfaces:

- a web dashboard with a live session wall, focused agent view, prompt and bash composer, telemetry, and provider-aware session management
- a Telegram bot for starting Gemini remote-control sessions, checking logs/status, and chatting with Codex or Gemini from your phone

Built by [zevro.ai](https://zevro.ai).

![RCOD dashboard session wall](./docs/assets/rcod-dashboard-wall.png)

## Current Dashboard

The dashboard is served by the `cmd/rcodbot` binary when `api.port` is enabled.

| Session focus | New session picker |
| --- | --- |
| ![Focused RCOD dashboard session](./docs/assets/rcod-dashboard-focus.png) | ![RCOD dashboard provider and repository picker](./docs/assets/rcod-dashboard-new-session.png) |

## What RCOD Does

- Shows all active chat sessions in a tmux-like session wall
- Opens a focused session view with agent activity, telemetry, wire tap, and message history
- Sends prompts to configured chat providers from the browser
- Runs bash commands in the selected repository from the focused dashboard session
- Supports image attachments for providers that expose image support
- Creates new chat sessions by provider and repository
- Adopts existing Codex sessions from local Codex state
- Streams updates through WebSocket so the dashboard stays live
- Starts, stops, restarts, a