gilvt / site

# gilvt

> gilvt is a free, open-source (Apache-2.0) native macOS terminal for running and monitoring parallel coding agents. Claude Code and Codex keep their own TUIs; gilvt shows which session needs you, which failed, and which finished, and lets you review each turn in place. It works locally and on remote machines over SSH.

gilvt is first a complete everyday terminal (tabs, splits, true color, the Kitty keyboard protocol, input methods, search, large scrollback), rendered natively with GPU acceleration using gpui and alacritty_terminal. On top of that it understands coding agents:

- A sidebar lists every Claude Code and Codex session, with the ones waiting for approval or input on top; `⌘⇧J` jumps to the next one across tabs and windows.
- Pane borders and tab dots are colored by state: needs you, error, working, done and unread.
- The inspector shows each turn's commands, file edits, TODOs, sub-agents and failures as a timeline, with a per-turn diff.
- Notifications and a Dock badge fire when a session needs you while you are in another app.
- Session Center (`⌘⇧R`) finds and resumes sessions from days ago; New Agent (`⌘⇧N`) starts an agent in any directory or a fresh git worktree.
- The Monitor (`⌘⇧O`) shows every session as cards, with optional AI summaries that use your local CLI.
- Quick Look, `⌘P` file search, rendered Markdown and Mermaid, a built-in editor and 725 themes.

Design principles: agents stay in their native TUI; gilvt observes and never types into an agent; your shell rc files, `~/.claude` and `~/.codex` are not modified unless you run `gilvt integrate install`.

Requirements: macOS 11 or later, Apple silicon or Intel. The app is signed and notarized and updates itself. The interface is available in English and Simplified Chinese.

## Install

- [Download page](https://gilvt.com/install/): the dmg, Homebrew (`brew install --cask gilvt-wtj/gilvt/gilvt`) and first steps
- [Direct download](https://gilvt.com/download): the latest signed dmg

## Docs

- [User guide](https://gilvt.com/docs/): every feature, one page per topic
- [Agent sessions](https://gilvt.com/docs/agent-sessions/): how gilvt recognizes Claude Code and Codex and shows their state
- [Resume and manage sessions](https://gilvt.com/docs/sessions/): find, resume, rename and archive past sessions
- [SSH remote](https://gilvt.com/docs/ssh-remote/): agents on Linux hosts and Apple Silicon Macs over ssh
- [Keyboard shortcuts](https://gilvt.com/docs/keyboard-shortcuts/)
- [Configuration](https://gilvt.com/docs/configuration/): `~/.config/gilvt/config.toml`
- [Troubleshooting](https://gilvt.com/docs/troubleshooting/): known limitations and fixes
- [Features](https://gilvt.com/features/): an illustrated tour
- [Changelog](https://gilvt.com/changelog/): what changed in each version

## Guides

- [What is an AI agent terminal?](https://gilvt.com/agent-terminal/)
- [How to manage multiple Claude Code sessions on macOS](https://gilvt.com/guides/manage-multiple-claude-code-sessions/)
- [How to run Claude Code and Codex in parallel](https://gilvt.com/guides/run-claude-code-and-codex-in-parallel/)
- [How to run Claude Code and Codex over SSH](https://gilvt.com/guides/claude-code-over-ssh/)
- [How to get notified when Claude Code needs your input](https://gilvt.com/guides/claude-code-notifications/)
- [How to review what Claude Code and Codex changed, without an IDE](https://gilvt.com/guides/review-claude-code-changes/)
- [Claude Code integration](https://gilvt.com/integrations/claude-code/)
- [Codex CLI integration](https://gilvt.com/integrations/codex/)
- [gilvt vs tmux for coding agents](https://gilvt.com/compare/gilvt-vs-tmux/)

## Optional

- [Source code on GitHub](https://github.com/Gilvt-WTJ/gilvt)
- [简体中文网站](https://gilvt.com/zh-CN/)