Try
↑↓Move↵OpenCtrl↵New tabescClose

Project

thronectl

Your coding agents, in your pocket.

Source ↗ (opens in a new tab)

Six thronectl screens on the Cardputer: the host dashboard, the agent list, an agent's output, an approval, a terminal, and push-to-talk.

Overview

Firmware for the M5Stack Cardputer ADV and a macOS or Linux daemon. Start, watch, prompt, and approve coding agents from your pocket over Wi-Fi or Bluetooth.

Languages
TypeScript

C++ESP32TypeScriptCoding AgentsHardware

thronectl runs your coding agents from a keyboard that fits in your pocket. It has two parts:

  • Firmware for the M5Stack Cardputer ADV, an ESP32-S3 board with a 240 × 135 screen and a full keyboard.
  • A daemon for macOS and Linux. It runs your agent CLIs in terminals on the host and talks to the Cardputer over an encrypted link, on Wi-Fi or Bluetooth LE.

From the Cardputer you can start, watch, prompt, approve, and stop agents. You can also open a real shell on the host, check CPU, memory, disk, and network, end processes, and talk to your agents. Replies are read back on the device speaker.

Agents

The daemon finds Claude Code, Codex, Pi, Cursor Agent, Antigravity, Gemini CLI, OpenCode, Amp, Mistral Vibe, Junie, Grok, Kiro, and Amazon Q on your PATH. Each one runs in a pseudo-terminal, so you can attach from the device and see the real TUI. If Paseo is installed, the agents it manages show up too.

Status comes from the terminal output: working while the output changes, waiting when a permission prompt is on screen, and idle when it goes quiet. Each change chimes, flashes the LED, and can be read aloud.

  • Approvals: one card per waiting agent. y allows, d denies, and c denies with a comment.
  • Simple mode: the approval queue becomes the home screen, for quick reviews away from your desk.
  • New agent: pick the harness, the folder, the mode, and the prompt.

Voice

Hold the G0 button, talk, and let go. The daemon transcribes the audio and sends it as a prompt. By default, speech runs on the host with Parakeet and Kokoro, the same local models Paseo uses, so no API key is needed and the audio stays on your machine. OpenAI, Groq, ElevenLabs, Piper, and macOS say work too.

Pairing and security

The device and the host each have an X25519 key. Both sides derive a 6-digit code from the handshake, and you confirm it on the host with thronectl pair. After that, every frame is encrypted with AES-256-GCM, and the device pins the host’s key. Bluetooth uses the same handshake, so a laptop in your backpack still works without shared Wi-Fi.

Install

The daemon needs Node.js 20.10 or newer.

git clone https://github.com/yannelli/thronectl.git
cd thronectl/daemon
npm install && npm run build && npm link
thronectl doctor
thronectl install

Flash the release image to the Cardputer with Launcher, the browser flasher, or esptool. After that, throne update updates the daemon and offers new firmware to each connected device.

Even more.

All work