Pennyroyaltea

Pennyroyaltea is manage Claude and codex sessions in one CLI

Last verified:

Visit Pennyroyaltea

What is Pennyroyaltea?

Pennyroyaltea is Resume is a command-line interface tool that allows developers to manage and resume AI coding assistant sessions across multiple platforms including Claude Code, Codex, and Gemini CLI from a single unified interface. It provides a text-based user interface (TUI) session picker that scans each supported tool's session store and displays all available sessions ranked by last activity.

Pennyroyaltea pricing

Pricing model: Freemium

Free and open source. No pro tier, no pricing plans, no credit card required, no trial. Every feature is available to everyone. The tool is completely free with no paid plans or subscriptions.

Pennyroyaltea pros

  • Unified session picker across Claude Code, Codex, and Gemini CLI
  • Lightweight at only ~17kb with no external dependencies
  • Resumes sessions in original working directory automatically
  • Preserves original session ID for exact context restoration
  • Sessions ranked by last activity for easy finding
  • TUI interface makes session selection intuitive
  • Open source and free to use
  • Works with tmux for multiple concurrent sessions
  • Extracts session title from first user message
  • Cross-platform session management
  • No account or credit card required
  • Retains context after machine restarts
  • Multiple projects supported without conflicts
  • Shows complete session metadata including cwd and timestamp
  • Original CLI invocation used for resume (native experience)

Pennyroyaltea cons

  • Requires jq dependency for some automation features
  • TUI may not appeal to users preferring GUI
  • Learning curve for command-line interface
  • Session storage locations vary by tool requiring configuration
  • Limited to CLI-based AI assistants only
  • No built-in session sharing or collaboration features
  • Session titles truncated to 80 characters may be unclear
  • No cloud sync for sessions across machines

Frequently asked questions about Pennyroyaltea

What AI coding assistants does Resume support?

Resume supports Claude Code, Codex (OpenAI), and Gemini CLI. It scans each tool's session store and provides a unified interface to pick up any session from any of these platforms.

How does session resume work?

Resume scans each supported tool's session store, shows every session in a TUI ranked by last activity, and resumes the one you pick in its original working directory with its original session ID via the appropriate CLI command (claude --resume, codex resume, or gemini --resume).

Where are sessions stored for each tool?

Claude Code stores sessions at ~/.claude/projects/<encoded-cwd>/<uuid>.jsonl, Codex stores at ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl, and Gemini CLI stores at ~/.gemini/tmp/<project>/chats/session-*.json plus projects.json.

Is Resume free to use?

Yes, 100% free. There is no pro tier, no pricing, no credit card required, and no trial. Every feature is available to everyone with no paid plans.

Can I use Resume with multiple projects?

Yes, multiple projects work simultaneously with no conflicts. Each project maintains its own session history and working directory.

What metadata does Resume extract for each session?

For each session, Resume extracts: cwd (working directory the session was started in), title (first user message truncated to 80 chars), and last activity timestamp for ranking.

Does Resume require any external dependencies?

No, Resume is lightweight at approximately 17kb and has no external dependencies. It is a self-contained CLI tool.

Can I resume sessions after restarting my machine?

Yes, that is one of the main features. Resume allows you to retain previous context even after interruptions such as restarting your machine by accessing saved session data.

How do I install Resume?

Resume is open source and available on GitHub. As a CLI tool, it can be installed via package managers or by cloning the repository. Check the GitHub repository for specific installation instructions.

Who created Resume?

Resume was created by Boris Starkov (GitHub username: pennyroyaltea, X/Twitter: @ktoya_me). It was showcased as Show HN on Hacker News as a tool to manage Claude and Codex sessions in one CLI.

Categories

Use cases

Browse all AI tools on NeedAnAI