Agent Session Switch

Agent Session Switch

A lightweight macOS desktop app for AI coding-agent session switching: **Claude Code, Codex CLI, and oh-my-pi (omp)**. Built natively with **Rust + [GPUI](https://github.com/zed-industries/zed/tree/main/crates/gpui) + [alacritty_terminal](https://github.com/alacritty/alacritty/tree/master/alacritty_terminal)**, with project grouping, cross-agent session resume, and an embedded terminal.

English (current) | [中文](./README.zh.md)

---

Overview

`Agent Session Switch` is not trying to replace your CLI workflow. It focuses on making session management visual, recoverable, and automation-friendly:

• Organize projects and sessions with a clear UI hierarchy
• Execute real work in embedded terminals running claude --resume
• Keep behavior config-driven so both humans and AI can manage it

---

Design philosophy

This app is not trying to become a heavier IDE. It is designed as a **lighter, calmer, terminal-first** workspace for session-heavy workflows:

• Immersive by default: restrained UI with clear hierarchy, avoiding visual noise
• Low interruption: non-essential signals stay subtle so focus remains on active work
• Terminal-centered: CLI stays the execution core; GUI focuses on organization and switching
• Session management first: quickly locate projects, switch sessions, and restore context
• Config-driven behavior: settings live in files for personal tuning and AI-assisted automation

In short: **keep native CLI flow, remove session-management friction.**

---

Feature highlights

1) Project and session management (multi-agent)

• Projects are manual-only: nothing is auto-imported from your CLI history — add a folder and it appears in the sidebar
• The sidebar lists only sessions created inside this app (kept in the app's own sessions.json registry); the CLIs' pre-existing sessions on disk are never listed
  • New Claude sessions pin their id up front (`claude --session-id