← Reddit

I built a TUI to find and resume any Claude Code session from anywhere on my machine

Reddit · miladmaaan · May 30, 2026
The ccs tool scans and lists all Claude Code sessions across a machine, enabling users to browse, search, and resume any session from any directory regardless of where it originated. The terminal UI generates descriptive titles for sessions, supports fuzzy searching by title or content, groups sessions by project, and integrates with cmux to open resumed sessions in separate workspaces. Built with Bun, TypeScript, and Ink, ccs solves the problem of losing access to sessions when switching directories or after computer restarts.

Detailed Analysis

A developer has released an open-source terminal UI tool called `ccs` (claude-sessions) that addresses a significant usability gap in Anthropic's Claude Code developer environment: the inability to easily find and resume coding sessions initiated from different directories on the same machine. The built-in `--resume` flag in Claude Code is limited to surfacing sessions tied to the current working directory, meaning sessions started in other repositories become effectively inaccessible unless the user remembers the exact originating folder. Compounding the frustration, the native `claude --resume <id>` command can fail silently with a "No conversation found" error, leaving developers with no clear recovery path. The tool, built with Bun, TypeScript, and the Ink framework, scans the entire machine for Claude Code session transcripts, presents them in a searchable list sorted by recency, generates readable titles for sessions that lack them, groups sessions by their git repository root, and provides both preview and full transcript views before resuming.

Several features of `ccs` address developer workflow concerns that the native Claude Code tooling does not yet fully solve. The fuzzy search and full-text search over conversation content allow developers to locate sessions by topic rather than by file path, which is particularly valuable in multi-project or multi-repository environments. The integration with `cmux`, a terminal multiplexer, is especially notable: when active, it opens a resumed session in a new labeled workspace rather than displacing the current terminal context, enabling developers to run multiple Claude Code threads simultaneously across named workspaces. The developer also surfaced an important operational detail embedded in Claude Code's configuration: session transcripts are deleted after 30 days by default via a `cleanupPeriodDays` setting, a behavior that many users are likely unaware of and that can result in permanent loss of context-rich coding history.

The tool's reliance on the Codex CLI rather than `claude -p` for generating session titles reflects an awareness of shifting economics in the AI developer tools space. The developer explicitly notes that non-interactive use of Claude is expected to begin consuming API credits, making alternative CLI tools a cost-conscious substitution. This decision signals a broader awareness among power users that the boundary between free and metered access in agentic AI tools is actively shifting, and that community-built tooling increasingly needs to account for those cost structures when making implementation choices.

The emergence of `ccs` fits within a broader pattern of community tooling being developed around frontier AI coding assistants as they mature from experimental features into daily development infrastructure. Tools like GitHub Copilot, Cursor, and Claude Code have all attracted secondary ecosystems of plugins, wrappers, and workflow utilities as developers encounter friction at the edges of official implementations. The specific problem `ccs` solves — session continuity and discoverability across a fragmented filesystem — reflects a fundamental tension in agentic AI tools: they generate valuable, context-rich conversational history, but the mechanisms for managing and retrieving that history have not kept pace with usage patterns. The developer's comment that they can now "close sessions without feeling like they are gone forever" encapsulates the psychological cost of that gap.

Anthropic's Claude Code has been positioning itself as a serious competitor in the agentic coding assistant market, and the existence of community tools like `ccs` indicates that the product's power-user base is growing large and engaged enough to produce auxiliary tooling. At the same time, the specific limitations being worked around — directory-scoped session discovery, silent resume failures, undocumented transcript deletion — suggest areas where Anthropic's own product development has room to catch up. Community-built solutions like this often serve as useful signal for product teams about which friction points are severe enough to motivate third-party development, and the traction this tool appears to be gaining on Reddit's Claude community suggests session management is a pain point shared across a substantial segment of Claude Code users.

Read original article →