Skip to content

Repository files navigation

Terry

中文

Terry turns your terminal into a workspace.
Group shells, browse files, and keep an AI agent beside you — built for people who live in the command line.

Preview

Terry preview 1

Terry preview 2

Terry preview 3

Features

  • Terminal workspace — Group and manage multiple terminals; open new sessions with the right working directory; groups support automatic tiled layouts (manual / tall / grid / stack, like kitty)
  • Terminal images — kitty graphics protocol and sixel support for rendering images directly in the terminal, with animated GIFs (chafa / viu / icat work)
  • Terminal protocols — kitty keyboard protocol (CSI u) and OSC 52 clipboard read/write
  • Link jump — Ctrl+Shift+E lists all currently visible links (URL / path / OSC 8); pick one with the keyboard to open it
  • AI Agent — Chat with LLMs in a side panel; run commands and tools with configurable profiles
  • MCP — Connect Model Context Protocol servers to extend agent capabilities
  • Files panel — Browse the project tree alongside your terminals
  • Editor — Open text from the files panel, or with New File / Open File; files share tabs and splits with terminals. Vim mode is on by default, with in-file search and go to line. Markdown can be previewed, and images open in a viewer
  • Settings & themes — Customize shell, appearance, agent models, and more
  • i18n — UI strings available in multiple locales (including English and Chinese)

Platforms

Platform Status
macOS (Apple Silicon / Intel) Supported
Linux (x86_64) Supported
Windows (x86_64) Supported

Release packages are built via GitHub Actions (.github/workflows/release.yml).

Getting started

Prerequisites

  • Rust 1.95.0 (see rust-toolchain.toml)
  • Platform build deps: CMake, a C/C++ toolchain, and on Linux the usual X11/Wayland/fontconfig libraries

Build & run

cargo run --release

Config and data live under the app name Terry (for example ~/.config/terry/ on Linux, ~/Library/Application Support/Terry on macOS).

Package locally

# macOS
script/package-macos.sh

# Linux
script/package-linux.sh

# Windows (PowerShell)
.\script\package-windows.ps1

Artifacts are written under target/release/.

Project layout

src/                 # App entry, terminal/file panels, menus
crates/              # Shared libraries (GPUI, terminal, agent, settings, …)
agent_ui / crates/agent_ui
assets/              # Icons, default settings, themes
script/              # Packaging scripts
resources/           # App icons and desktop metadata

License

  • Application package: GPL-3.0-or-later (see LICENSE-GPL)
  • Many crates retain their upstream licenses (including Apache-2.0; see LICENSE-APACHE and per-crate metadata)

Contributing

Issues and pull requests are welcome. Please keep changes focused; match existing code style, and test on the platform you touch.

About

Open source gpui-based cross-platform terminal with vertical tabs for AI coding agents. Built for multitasking, organization, and programmability. Support MCP.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages