JustSessions

Nothing extra. Just sessions.
Multiple agents, all your sessions in one place. Your familiar command line, with native tabs.

For people who prefer the command line. JustSessions adds a native Mac workspace around your existing CLIs. Keep their terminal interface, configuration, and provider authentication.

Website · Guide · Compare · Download · Supported CLIs · Documentation

Multiple agents. One project.

Claude Code · Codex CLI · Antigravity CLI · Kiro CLI · OpenCode · Pi

• Group sessions from different agents under the same project.
• Search projects and sessions; pin and rename favorites.
• Start or resume a session in its original CLI and project folder.

New. Resume. Delete.

• Start with any installed agent.
• Read a conversation, then resume in its original CLI.
• Delete saved sessions from the app.

Reading controls cover text size, images, history paging, and search limits.

Work on any host.

• Local and SSH projects in one sidebar.
• Browse history and resume remotely.
• Your code and CLI stay on the remote machine.

Add a ~/.ssh/config alias or user@hostname with passwordless SSH, rsync, and the CLI installed. Session history is cached on your Mac. SSH setup.

Close a tab. Keep the work.

• Close the tab → choose Keep running.
• Quit the app. The CLI stays alive in tmux.
• Click the session to reattach to the same process.

The packaged app includes tmux for this Mac. Install tmux on each SSH host to survive disconnects there. Keep the machine awake. Plain shell tabs do not use tmux. Terminal persistence.

Tabs like Chrome. Split view.

• Create, switch, and group tabs by project.
• Use Open tabs for a vertical list of your terminals.
• Automatically reopen tabs on launch.
• Keep an agent and shell side by side; drag the divider to resize.

Tab recovery is controlled in Settings → General; split layouts reopen as separate tabs. Tabs and split view.

Lightweight by design

• Native SwiftUI + SwiftTerm. A Mac app with an AppKit terminal.
• No import or new account. Reads the history your CLIs already create.
• No conversation uploads. JustSessions reads existing CLI history; your CLIs still communicate with their providers.
• Free and open source. MIT licensed; your CLI provider’s charges still apply.

Choose system, English, or Chinese for the interface. Set app themes, terminal fonts and colors, or import iTerm2 colors. Local Claude Code and Codex sessions can notify when a turn finishes or needs your input. Settings and notifications.

Download

macOS 14+ · Apple Silicon · A supported CLI installed and signed in

1. Download JustSessions.dmg, Developer ID signed and notarized by Apple.
2. Drag JustSessions into Applications and launch it.
3. Choose a session in Projects, then double-click or press Resume.

Updates arrive through Sparkle; check manually in Settings → General. Getting started.

Supported CLIs

New session menus offer only installed CLIs. See the storage guide for discovery paths and deletion requirements.

Search matches project names and paths, session titles, and session IDs. It does not search the full conversation text. Branch forks a conversation; it does not create a Git branch.

Documentation and development

Build locally with make; the app is written to dist/JustSessions.app. Use make dev to build and open it, or make help for other commands.

• Getting started
• Session management: tabs, split view, shortcuts, SSH, notifications, and settings.
• Session storage and privacy
• Build and release · Source layout
• Website development and traffic · Counting update checks
• All documentation · Release notes

Submit changes through a pull request. Run make verify on the final commit and include the results in the PR template.

For in-app help, open Settings → Help. Send feedback or report an issue from Settings → General, or the website Guide.

License

MIT. The embedded terminal uses SwiftTerm under its MIT license.