[!NOTE]
gilvt is in early development (before 1.0) and runs on macOS 11 or later only. The interface follows your Mac's preferred
language: Simplified Chinese when it is Chinese, English otherwise. Pick one in Settings (⌘,) →
Language, or set language = "en" / "zh-CN" in ~/.config/gilvt/config.toml. The developer docs (HACKING.md) are in Chinese for now.
About
When three or four Claude Code and Codex sessions run at once, the hard part is knowing which one
stopped to ask for approval, which one just failed its tests, and which one finished and is waiting for
you to read the result. A plain terminal gives you a grid of text and makes you check every tab.
gilvt is first a complete, everyday terminal: tabs, splits, true color, the Kitty keyboard protocol,
input methods, search and a large scrollback, rendered natively with GPU acceleration
(gpui + alacritty_terminal). On top of
that it understands what your coding agents are doing:
- Sidebar: every agent session in one list, with the ones that need you on top.
⌘⇧J jumps to the
next one.
- Status at a glance: pane borders and tab dots are colored by state (needs you · error · working ·
done and unread).
- Inspector: each turn's commands, file edits, TODOs and failures as a timeline; click a row to
scroll the terminal back to it. Per-turn file changes with a "this turn" diff.
- Notifications and a Dock badge when a session needs you while you are in another app.
- Session management: find and resume sessions from days ago (
⌘⇧R), start a new agent in any
directory or a fresh git worktree (⌘⇧N), review finished sessions offline, archive and clean up.
- Monitor (
⌘⇧O): every session and terminal across all windows as cards, with optional AI
summaries and a read-only chat about what is going on (off by default; uses your local CLI).
- Quick Look and an editor: code with syntax highlighting and diffs, rendered Markdown and Mermaid,
⌘P fuzzy file search, and a built-in editor with live preview.
- SSH remote (preview):
ssh to a Linux host or an Apple Silicon Mac, and the agents you run there show up in
the sidebar like local ones; gilvt view / gilvt diff open the host's files.
- 725 built-in themes plus your own; the window chrome follows
the theme.
Design principles:
- Agents stay in their native TUI. gilvt adds no chat UI and no approval buttons.
- Observe, never answer. gilvt shows state and moves focus; it never types into an agent.
- Your configuration is untouched. Shell integration and agent hooks are injected through launch
arguments and temporary files. Your rc files,
~/.claude and ~/.codex are not modified unless you
explicitly run gilvt integrate install.
- Failures degrade, not break. If hooks are missing or a transcript can't be parsed, gilvt falls back
to a reduced mode or a plain terminal.
Install
Download gilvt for macOS (macOS 11 or later, Apple silicon and Intel;
signed and notarized). Open the disk image, drag Gilvt into Applications, and open it from there. Then run
claude or codex in a pane: the sidebar and inspector pick up the session automatically. The app keeps
itself up to date and installs updates when you quit. More on gilvt.com.
With Homebrew:
brew install --cask gilvt-wtj/gilvt/gilvt
This also puts the gilvt command on your PATH. Updates still arrive through the app itself.
Build from source
Requirements: macOS, Xcode Command Line Tools, and Rust (the pinned toolchain in rust-toolchain.toml
is selected automatically by rustup). A full Xcode install is not needed.
git clone https://github.com/Gilvt-WTJ/gilvt.git
cd gilvt
scripts/bundle.sh release # builds and signs target/release/Gilvt.app
open target/release/Gilvt.app
Build outside /tmp (macOS ignores app bundles there). Native notifications and the Dock badge need
the app bundle. To keep macOS privacy grants across rebuilds, create a self-signed gilvt-dev
certificate as described in HACKING.md (稳定签名). Builds from source have no updater.
Documentation
Privacy
gilvt has no telemetry and makes no network requests of its own. It reads Claude Code and Codex
session files on your machine to show their state. The optional Monitor summaries and chat run your
own claude or codex CLI, which talks to its provider as usual. See PRIVACY.md.
Contributing
Bug reports and focused pull requests are welcome. Please read CONTRIBUTING.md and
the AI usage policy first. Security issues: see SECURITY.md.
Disclaimer
gilvt is an independent project. It is not affiliated with, endorsed by, or sponsored by Anthropic or
OpenAI. Claude and Claude Code are trademarks of Anthropic; Codex is a trademark of OpenAI.
License
Apache License 2.0. See LICENSE and NOTICE. Third-party licenses are listed in
THIRD_PARTY_LICENSES.md.
