mmr710

Nightmux — Development skill for Claude Code

Development community

Your night crew, on Telegram.

How to install Nightmux

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

What Nightmux does

Your night crew, on Telegram. Run Claude Code, Codex or any terminal agent from a Telegram topic — one topic per tmux session. Watches the context window and the 5-hour limit, compacts before the wall, and holds prompts through a lockout instead of losing them. Python stdlib only, no relay server.

Alternatives in Development

Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★
Mulmoterminal — Run multiple Claude Code and Codex sessions in parallel — a browser terminal grid that shows which agent needs 187 ★

README

nightmux

[![tests](https://github.com/mmr710/nightmux/actions/workflows/test.yml/badge.svg)](https://github.com/mmr710/nightmux/actions/workflows/test.yml) [![Telegram](https://img.shields.io/badge/Telegram-Community-blue.svg?logo=telegram)](https://t.me/+SGmmExdMHTQ3OWVk) [![PyPI](https://img.shields.io/pypi/v/nightmux.svg)](https://pypi.org/project/nightmux/)

![nightmux — unified Telegram control for multi-agent AI workflows, quota monitoring, and automated recovery](docs/hero.jpg)

**Your night crew, on Telegram.**

02:14  ⏸ api hit the usage limit
       5-hour window spent — resumes 04:11, resuming itself with 'continue'
04:11  ▶️ api resumed · sending queued prompt
04:11  ⚙️ api

A usage limit at 2am used to end the night. The turn dies mid-refactor, the prompt that started it is already spent, and the session sits there until someone awake types `continue`. nightmux reads the reset time, holds everything you send, and puts the work back the moment the window reopens — including the turn the limit cut off. You read the result at breakfast.

That is the part nobody else is doing. The rest is what makes it usable:

Run **Claude Code from your phone** — or Codex, Gemini, aider, anything with a prompt. One Telegram forum topic per project, one tmux session behind it. Text you send is typed into that session's prompt; what the session says comes back to the topic. Approvals arrive as tap buttons.

No container, no DNS, no certificates, no ports open, no relay service. It attaches to tmux sessions you already have, on the machine you already use. Python stdlib only — one file, ~5,400 lines you can read in an afternoon.

![What a night looks like: the limit hits at 02:14, nightmux resumes the turn at 04:11, and the one approval waits for breakfast](docs/demo.svg)

**Try it:** `curl -fsSL https://raw.githubusercontent.com/mmr710/nightmux/main/install.sh | bash` — five minutes, no dependencies, no server. [Full install →](#install)