Cueless

Cueless is an IM-first control plane that receives commands, dispatches them to a swappable agent runtime, and streams execution status back to IM.

Quick Start

1. Install dependencies:

pnpm install

2. Configure environment variables:

cp .env.example .env

3. Run in development:

pnpm run dev

Configuration

Variable	Default	Description
IM_PROVIDER	telegram	IM provider (telegram or mock).
TELEGRAM_BOT_TOKEN	-	Telegram bot token (required for Telegram).
RUNTIME_TYPE	mock	Runtime type (mock or cli).
RUNTIME_COMMAND	-	Shell command to run when RUNTIME_TYPE=cli.
RUNTIME_WORKING_DIR	-	Working directory for runtime command.
RUNTIME_TIMEOUT_MS	600000	Runtime timeout in ms.
LOG_LEVEL	info	Log verbosity.

Runtime Notes

• mock runtime echoes the command and completes immediately.
• cli runtime spawns RUNTIME_COMMAND and streams stdout/stderr back to IM.

End-to-End Test

Run the mock adapter + mock runtime test:

pnpm run test:e2e

Docker

docker build -t cueless .

docker run --env-file .env cueless