cherminalv0.2.0 · macOS · Claude Code + Codex
Chat + terminal for your CLI agents.
A conversation manager for terminal CLI agents. It puts a sidebar of your Claude Code and Codex sessions next to a real Ghostty terminal: start them across your ~/dev folders, click any one to jump back in. It tracks them by reading the OS, nothing injected.
or curl -fsSL https://cherminal.com/install.sh | sh · signed & notarized · source on GitHub ↗
you@mac ~/dev/api ❯ claude --resume
· reattaching session a1b2c3d4 …
✻ Found it. The race is in the token refresh.
I'll share one in-flight refresh so concurrent requests don't stampede the endpoint.
· Edited auth/session.ts (+24 −6)
✓ tests passing · review clean
❯
conversations · a real Ghostty terminal · context watch
the one rule
No hooks. No wrappers. Nothing injected.
It reads Claude and Codex session files and matches processes by PID, so the agents run exactly like they would on their own. That's also why it stays fast and out of the way.
what it does
It manages conversations, not files.
Grouped by folder
01A room is just a folder under ~/dev. Every session you start there shows up in the sidebar, grouped by folder or recency, tagged live, idle, dormant, or pinned.
Switch without killing
02Tabs keep every session alive at once. Switch between them without killing the agent underneath, then pick up where you left off.
Detach, keep running
03Close a pane and the agent keeps running off-screen via dtach, at about zero memory. Reattach whenever.
Context on the side
04The right rail shows the session you're in: files touched this turn, the git diff, the token budget.
Real Ghostty
05The middle pane is an actual Ghostty terminal, GPU-fast and true-color. Not a re-implementation. The agent runs in it like it would on its own.
One stack only
06Not general-purpose. Wired to Claude Code, Codex, Ghostty, and ~/dev. No settings screens, no feed, no approval queue. Small enough to read, and to delete.
Apple Silicon · macOS · open source