richieaprile661

Smith Agents — Development skill for Claude Code

Development community

Smith Agents: a floating desktop widget for Claude Code and Codex.

How to install Smith Agents

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

What Smith Agents does

Smith Agents: a floating desktop widget for Claude Code and Codex. Track usage, sessions, and agent activity on Windows and macOS.

Alternatives in Development

  • Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
  • Claude Keysmith — Managed Claude Code instruction deployment with safe CLI recovery and an unsigned macOS/Windows desktop beta 696 ★
  • SSH Skill — 面向 Codex 和 Claude Code 的跨平台 SSH 工作流 Skill,支持 Windows、macOS、Linux 488 ★

README

Smith agents in glowing green typewriter lettering, above a preview of Claude and Codex sessions, usage readings, and a compact top-edge strip.

“We're not here because we're free. We're here because we're not free.”

**Your agents. At a glance.**

**Smith Agents** is a small floating desktop widget for **Claude Code and Codex** on **Windows and macOS**. Check your usage, see which sessions are working or ready, and open the agent you need. Tuck it against a screen edge when you want your workspace back.

[Get started](#get-started) · [How it works](#how-it-works) · [Codex setup](docs/codex.md) · [Privacy](#privacy) · [Development](docs/development.md)

A little less window hunting

  • Claude and Codex together. See local terminal and VS Code sessions in one agent list, with a provider logo on each figure.
  • Usage you can read at a glance. Switch providers, check account limits and stats, or click the header to cycle through Used % → Remaining % → Reset time/day.
  • A figure for every session. Working, waiting, and ready states have their own poses. Each session keeps its figure until its state changes; subagents get a Little helper.
  • Small when you need it. Tuck along the top, left, or right edge. Project names wrap, larger lists scroll, and clicking a figure opens just that agent's panel.
  • Context without opening every chat. See the model, context tokens, recent activity, and last request. Missing readings stay visibly unknown.
  • Open it. Hide it. Keep it running. Bring a matched agent window forward or hide it from its panel. Hiding a window leaves the session running.

Keep your workspace

Top-edge tuck beside a right-edge tuck with just the selected agent's panel open.

Park the strip along the **top, left, or right** edge. Click a figure to open t