blackpaw-studio/leo

<h1 align="center">🐈‍⬛ Leo</h1> <p align="center"> <em>A process supervisor and task scheduler for Claude Code.</em> </p> <p align="center"> <a href="#install">Install</a> · <a href="#quick-start">Quick Start</a> · <a href="#what-leo-does">What it does</a> · <a href="#cli">CLI</a> · <a href="https://blackpaw-studio.github.io/leo/">Docs</a> </p> <p align="center"> <a href="https://github.com/blackpaw-studio/leo/actions/workflows/ci.yml"><img src="https://github.com/blackpaw-studio/leo/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/blackpaw-studio/leo/releases/latest"><img src="https://img.shields.io/github/v/release/blackpaw-studio/leo" alt="Release"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a> <a href="https://goreportcard.com/report/github.com/blackpaw-studio/leo"><img src="https://goreportcard.com/badge/github.com/blackpaw-studio/leo?style=flat" alt="Go Report Card"></a> </p>

---

<p align="center"> <img src="docs/demo/leo-demo.gif" alt="leo demo" width="860"> </p>

Leo keeps long-running Claude Code sessions alive, runs cron-driven Claude tasks, and spawns on-demand coding agents from templates. Manage it from the CLI, a browser, or any Claude Code channel plugin (Telegram, Slack, webhook, …).

Install

Homebrew (recommended):

brew install blackpaw-studio/tap/leo

Shell installer:

curl -fsSL leo.blackpaw.studio/install | sh

Go:

go install github.com/blackpaw-studio/leo/cmd/leo@latest

Prerequisites: authenticated Claude Code CLI, tmux (3.2+ recommended — Leo uses display-popup). Channel plugins (e.g. claude plugin install telegram@claude-plugins-official) are optional.

Leo runs on its own tmux socket (-L leo) so your personal tmux ls stays clean. Inspect Leo's sessions dire