Skip to content
corral-devPublic

About

Animated, shareable card of your coding-agent week. npx agentflex

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

agentflex

An animated card of your coding-agent week, in one command.

agentflex card animation (fictional data)

npx agentflex

No install, no account, no upload. It reads the local histories of Claude Code, Codex, OpenCode and Pi, adds up the last 7 days, and plays the card in your terminal. Press s to save a 1200×630 PNG for posting, r to replay, q to quit.

Also works with pnpm dlx agentflex and bunx agentflex.

What the card shows

  • Tokens for the period, as each assistant recorded them (cache reads included).
  • Sessions, tokens per day and peak parallel sessions (the most agent sessions active at the same moment).
  • Agent share across Claude Code, Codex, OpenCode and Pi.
  • Activity by weekday and hour, with your busiest hour.

Options

npx agentflex --month        # last 30 days
npx agentflex --all          # all retained history
npx agentflex --png week.png # write the image and exit
npx agentflex --json         # print the numbers as JSON
npx agentflex --no-anim      # final card without animation

Fast

The default 7-day card is computed in well under a second on a heavy-use machine (about 900 MB of history): histories are read in parallel, pruned to the period, and only the fields that matter are decoded. The parsing engine is SessKit's native sesskit-stats crate, checked session by session against SessKit's reference implementation.

Platforms

macOS (Apple silicon, Intel), Linux (x64, arm64) and Windows (x64, arm64). Histories are found in each assistant's standard location; CLAUDE_CONFIG_DIR, CODEX_HOME, XDG_DATA_HOME, OPENCODE_DB, PI_CODING_AGENT_DIR and PI_CODING_AGENT_SESSION_DIR are honored.

Privacy

Everything stays on your machine. The card shows totals only: no prompts, file names, project names or paths.

From the makers of Corral

agentflex comes from Corral, a terminal home for all your coding-agent sessions: see who needs you, run agents side by side, and pick up from your phone. Corral users can also run corral flex.

License

MIT. The PNG export embeds a subset of the Spleen bitmap font (BSD-2-Clause, see assets/SPLEEN-LICENSE.txt).

About

Animated, shareable card of your coding-agent week. npx agentflex

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages