breaktheready

Liteclaw — Development skill for Claude Code

Development community

Control Claude Code CLI remotely via Telegram.

How to install Liteclaw

This entry records only its repository, not the path inside it, so there is no exact command to give. Open breaktheready/liteclaw and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Liteclaw does

Control Claude Code CLI remotely via Telegram. No API key needed.

Alternatives in Development

Breach Check — HIBP k-anonymity check on a password wordlist 4.5k ★
Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★
Spot — Place and manage spot trading orders on Binance via API key authentication, supporting mainnet and testnet 483 ★

README

LiteClaw

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE) [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg)](#platform-support) [![CI](https://github.com/breaktheready/liteclaw/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/breaktheready/liteclaw/actions/workflows/ci.yml) [![GitHub stars](https://img.shields.io/github/stars/breaktheready/liteclaw?style=social)](https://github.com/breaktheready/liteclaw/stargazers)

Control Claude Code CLI remotely via Telegram. No API key needed.

[한국어](README_KO.md)

Why I made this

I'm not really a programmer — more of a power user who relies on Claude Code daily. When OpenClaw got cut off, I needed a way to keep using Claude Code from my phone.

My solution was pretty basic: a Python script that connects Telegram to a Claude Code session running in tmux. It types your message into the terminal (`send-keys`) and reads back what's on screen (`capture-pane`). That's it.

No API key needed. No extra cost. If you're already paying for Claude Code, this just lets you use it remotely.

It works for what I need, so I figured I'd share it in case others are looking for something similar.

How is this different?

Unlike tools that call Claude's API directly (which means extra costs), LiteClaw operates your **existing Claude Code CLI session** through tmux. You're already paying for Claude Max — this just lets you use it from your phone.

Single Python file (~900 lines), not a framework
No API keys to Anthropic needed
No containers, no Docker
Your subscription covers everything

Features

Remote access — Control Claude Code from anywhere via Telegram
AI summarization — Responses cleaned up by an LLM before delivery (toggleable)
Busy detection — Knows when Claude is working, queues your message autom