Skip to content

Rostmen/ClaudeGUI

Repository files navigation

Tenvy

Tenvy is a native macOS app for managing and resuming Claude Code CLI sessions — with a beautiful glass UI, embedded terminal, and smart notifications.

macOS 26+ Swift License Release


Screenshot 2026-03-27 at 20 58 13

Installation

Homebrew (recommended)

brew install --cask rostmen/tenvy/tenvy

Manual

  1. Download the latest Tenvy-x.x.x.dmg from Releases
  2. Open the DMG and drag Tenvy to your Applications folder
  3. Launch Tenvy from Applications

Tenvy is notarized by Apple — no "unidentified developer" warnings.


Features

Session Management

Browse all your Claude Code sessions in one place. Resume any session instantly, rename sessions for easier identification, and delete ones you no longer need. Sessions are discovered automatically from ~/.claude/projects/.

Embedded Terminal

Each session runs in a full terminal embedded directly in the app — choose between SwiftTerm (default) or Ghostty in Settings. Every session gets its own isolated window or tab — no cross-contamination between projects. Tenvy monitors CPU usage to detect when Claude is thinking, waiting, or idle, and reflects that state in real time.

Smart Notifications

Tenvy hooks into Claude Code's event system to notify you when:

  • Claude is waiting for your input — get a macOS notification when a background session needs attention
  • Permission is required — approve or deny tool use directly from the notification without switching windows

Notifications are suppressed for the session you're actively viewing and shown only for background sessions.

Appearance

Choose between Light, Dark, or System (follows macOS) in Settings → Appearance. Tenvy applies the chosen mode across all windows — including the Settings and Release Notes windows — and automatically syncs the Claude CLI theme in ~/.claude.json so Claude's output colors match. Idle sessions are restarted transparently so the new theme takes effect immediately.

Multi-Window Support

Open multiple Claude Code sessions side by side, each in its own window or tab. Tenvy enforces one process per session — no duplicate terminals, no wasted resources.

Shell Environment

Tenvy sources your ~/.zprofile and ~/.zshrc before launching Claude, so auth tokens, PATH entries, and other shell exports are available just as they are in your regular terminal. You can also add custom environment variables in Settings → Environment Variables.


Requirements


Setup

On first launch, Tenvy will prompt you to install Claude Code hooks. These hooks allow Tenvy to track session state and send notifications. Click Install Hooks when prompted — it takes one second and requires no manual steps.


Building from Source

git clone https://github.com/Rostmen/ClaudeGUI.git
cd ClaudeGUI
open Tenvy.xcodeproj

Or from the command line:

xcodebuild -scheme Tenvy -destination 'platform=macOS'

Requirements: Xcode 17+, macOS 26 SDK


License

MIT — see LICENSE

About

Claude sessions manager

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors