v1.0 — open source

Little
Agents

A lightweight tmux session manager and quota tracker for Claude Code. Manage multiple agents, track token usage, and stay in the flow.

cst — little agents session manager

Everything you need,
nothing you don't.

Session Management

Create, attach, kill, and switch between tmux sessions with single-key shortcuts. Each session runs its own Claude agent in a dedicated workspace.

Quota Tracking

Real-time token usage across Claude's 5-hour billing windows. Color-coded from green to red so you always know where you stand. Auto-detects your tier.

Interactive TUI

A live-updating terminal UI that shows all sessions with their status, working directory, and quota — with keyboard-driven navigation.

Max 5x 0.0M / 120M
0% resets 4h46m
Pro ~45M tokens / 5h
Max 5x ~120M tokens / 5h
Max 20x ~480M tokens / 5h

Never hit the wall
by surprise.

Reads real token usage from Claude's session logs — input, output, and cache tokens — grouped into 5-hour billing blocks that match Claude's actual billing windows.

Automatically detects your subscription tier from your credentials. No config needed.

< 50%
50–79%
80%+

Six commands.
That's it.

cs Session status + quota usage at a glance
cst Live interactive session manager — attach, kill, create
nt New tmux session with interactive repo picker
kt Kill a tmux session by name
at Attach to an existing tmux session
cld Alias for claude --dangerously-skip-permissions

Up and running
in 30 seconds.

Clone the repo, run the installer, and restart your shell. That's the whole setup. Works on Linux and macOS.

python3 tmux claude
installation
01 $git clone https://github.com/samschooler/little-agents.git
02 $cd little-agents
03 $./install.sh
What does install.sh do?
  1. Checks that python3, tmux, and claude are installed
  2. Detects your shell and adds a source line to .bashrc or .zshrc

That's it — no sudo, no global installs, no package managers.