What is agent-session-search?

Agent-Session-Search is a local desktop application for searching, organizing, and resuming past sessions from AI coding agents such as Claude Code, Codex, and CodeBuddy. If you regularly use these tools and accumulate many sessions over time, this app gives you a single place to find and reopen them without digging through file system directories. The app reads existing session files directly from the locations where each tool stores them on your machine. It builds a local search index so you can do full-text searches across session content, project paths, and titles. It does not modify the original session files, any notes you add, such as custom titles and tags, are stored separately in a local SQLite database. You can also mark sessions as pinned or hidden, and filter by project, source tool, or time range. For resuming work, the app can open a session in several terminal emulators (Terminal, iTerm, Ghostty, WezTerm, or Warp on macOS, standard terminals on Windows), copy a resume command to the clipboard, or export the session as a Markdown file. It also tracks token usage and message counts across sessions and, if enabled, records how often individual Claude Code skills have been used. The app runs as a background process with an icon in the menu bar (macOS) or system tray (Windows). On macOS the default keyboard shortcut to open the search window is Option+Space. On Windows it is Ctrl+Alt+Space. Both shortcuts can be changed or disabled in settings. Light and dark themes are available, and the interface supports both Chinese and English. It is built with Electron, React, and TypeScript, and requires Node.js 22.13 or later. Installation involves cloning the repository, running the build, and registering a global command. The README is written primarily in Chinese, with an English version available in the docs folder.