alfonsocartes

Lil Agents — Development skill for Claude Code

Development community

Live status overlay for Claude Code, Codex CLI, and Grok CLI on macOS, plus iPhone widgets for weekly usage.

How to install Lil Agents

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

What Lil Agents does

Live status overlay for Claude Code, Codex CLI, and Grok CLI on macOS, plus iPhone widgets for weekly usage.

Alternatives in Development

Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
Clawdmeter Plus — A round AMOLED desk display for your live Claude Code usage, weather, background-agent health, and a daily voi 87 ★
AgentLimits — AgentLimits is macOS widgets that display Codex/Claude Code usage limits and ccusage tokens, cost, heatmap 56 ★

README

lil agents · lil usage

A live status overlay for Claude Code, Codex CLI & Grok CLI sessions on macOS, plus Home Screen widgets for weekly usage on iPhone.

**Stop alt-tabbing to check if your AI coding agent is done.** `lil agents` is a tiny, native macOS menu-bar app that shows the live status of every [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [OpenAI Codex CLI](https://developers.openai.com/codex/), and [Grok CLI](https://x.ai) session in an always-on-top overlay — working, idle, or waiting for you — and lets you jump straight to the terminal pane that needs attention.

**lil usage** is the iPhone companion in the same repo: a host app and Home Screen widgets for Claude, Codex, and Grok weekly usage. Sign in on the phone, or optionally copy CLI tokens from the Mac.

Built for developers running **multiple AI agents in parallel** across terminal tabs and windows. One glance tells you which session is blocked on a permission prompt, which finished its turn, and which is still crunching.

![Platform](https://img.shields.io/badge/platform-macOS%2026%2B-black) ![iOS](https://img.shields.io/badge/iOS-18%2B-black) ![Swift](https://img.shields.io/badge/Swift-6.2-orange) ![UI](https://img.shields.io/badge/UI-SwiftUI%20%2B%20AppKit-blue) ![License](https://img.shields.io/badge/license-MIT-green) ![Release](https://img.shields.io/github/v/release/alfonsocartes/lil-agents?color=brightgreen)

lil agents floating overlay with usage gauges and three live sessions