superturtle docs - Super Turtle

superturtle is a coding agent on your phone. Send a voice message or text from Telegram, and it runs Claude Code (or Codex) on your machine to write code, run tests, fix bugs, and ship features.

npm install -g superturtle
superturtle init
superturtle start

macOS is fully supported. Linux is alpha. Windows is not yet supported. See Platform Support.

Start here

Introduction

What superturtle is and how Meta Agent + SubTurtles work.

Quickstart

Install, init, start. Up and running in minutes.

Architecture

Orchestration, loop types, and supervision.

Dashboard

Local operational view for sessions, workers, queue, and conductor state.

Key principles

Outcome-first UX — milestone updates, minimal noise
Autonomous execution — SubTurtles run and recover without micromanagement
Uses your subscriptions — Claude Code and optionally Codex, no extra API tokens

​Start here

Introduction

Quickstart

Architecture

Dashboard

​Key principles

Start here

Key principles