SkillAgentSearch skills...

terry

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

Install / Use

claude mcp add bindoffice -- npx -y github:bindoffice/terry

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

84/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of terry

terry scores 84/100 on our quality scale, 249th of 313 Customer Support skills we index.

Its MCP Server is 24 KB long, well organised into 30 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated yesterday, so terry is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 85/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-19. Automated pattern scan on 2026-11-19. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

terry compared with similar skills

All 4 of these similar skills score higher than terry; compare them before choosing.

SkillScoreStarsUpdatedFormat
terry (this skill)by bindoffice84101d agoMCP Server
Agent-Reachby Panniantong100113.3k12d agoCLAUDE.md
hyperframesby heygen-com10087.1ktodayCLAUDE.md
rufloby ruvnet10082.1ktodayCLAUDE.md
headroomby headroomlabs-ai10080.2ktodayCLAUDE.md

Frequently asked questions

How do I install terry?
Run claude mcp add bindoffice -- npx -y github:bindoffice/terry. The install tabs above show the steps for each supported agent.
Which AI agents does terry work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is terry safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 85/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is terry still maintained?
The repository was last updated yesterday, so terry is actively maintained.

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

<p align="center"> <img src="assets/images/1.jpg" alt="Terry preview 1" width="800" /> </p> <p align="center"> <img src="assets/images/2.png" alt="Terry preview 2" width="800" /> </p> <p align="center"> <img src="assets/images/3.png" alt="Terry preview 3" width="800" /> </p>

Features

  • Terminal workspace — group multiple terminals, switch groups with ctrl-alt-shift-up / ctrl-alt-shift-down; new sessions open in the right working directory; groups support automatic tiling layouts (manual / splits / tall / fat / grid / stack / horizontal / vertical, kitty-style); enable broadcast input from a group's context menu to type into every terminal in the group at once (ctrl-alt-b)
  • Tab management — cmd-shift-t (ctrl-shift-t) reopens the most recently closed terminal with its cwd, profile/SSH/tmux launch, colors and font zoom; “Move Tab to New Window” moves a running terminal, process intact, into a new window
  • Quake terminal — A drop-down terminal summoned anywhere with `ctrl+`` , docked to the top of the screen (macOS)
  • CLI — Drive a running Terry from scripts and editors: terry new-tab --cwd ~/src, terry send-text "cargo test", terry run "cargo test", and terry session save/load for reusable workflows
  • Kittens / plugins — executable extensions discovered from kittens/ directories, launched with terry kitten list / terry kitten run NAME; they receive TERRY_* context and the automation API. This is Terry's plugin contract, not a drop-in implementation of kitty's Python kitten API
  • 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 with press/repeat/release events, alternate keys, and associated text), OSC 52 clipboard write (clipboard read is opt-in via "terminal": { "clipboard_read": true }), OSC 99 desktop notifications, OSC 22 mouse pointer shapes, OSC 66 text sizing, CSI 8 t window resize, and Unicode grapheme clustering (emoji ZWJ sequences, flags, keycaps, combining marks)
  • Paste safety — multi-line pastes ask for confirmation by default; choose “Paste and Don't Ask Again” in the prompt to stop asking, or set "terminal": { "confirm_multiline_paste": false }
  • Shell integration — automatic for zsh and fish: prompt marks (OSC 133 / VS Code OSC 633) and working-directory tracking (OSC 7); ctrl-shift-up / ctrl-shift-down move between prompts
  • Terminal profiles — named launch profiles can override the shell, environment, and working directory, and run a startup command (for example tmux or a project virtualenv); pick one from a group's context menu or set default_profile
  • SSH hosts — a picker built from ~/.ssh/config and terminal.ssh_hosts; connections are reused for 60s (ControlMaster), so a second terminal on the same host opens instantly. Plain SSH sessions automatically install shell integration for remote zsh, fish, and bash, and the status bar marks the terminal as remote with the host and the remote directory while the sidebar and tab follow the remote folder. “Connect with tmux” starts an attach-or-create tmux session on the remote host
  • tmux sessions — attach to (or create) a local tmux session from the picker; the remote equivalent goes through ssh … tmux new -A -s <name>. Choose the native option to mirror the session through tmux control mode: every tmux window becomes a Terry group and every pane a native split, with input, layout changes, window names and reconnects kept in sync. Without native mode the session runs inside a single terminal.
  • Terminal color schemes — a bundled library (Dracula, Nord, Solarized, Gruvbox, One Dark, Tokyo Night, Catppuccin, Rosé Pine, …) that changes only terminal colors; pick one per terminal, per profile, or with terminal.color_scheme. Import Alacritty .toml, iTerm2 .itermcolors, or Terry JSON files from the Terminal menu
  • Session restore — groups, split layouts, working directories, titles, per-profile color schemes, per-terminal font zoom, and profile/SSH/tmux launches are restored on restart
  • Persistent sessions (opt-in) — with terminal.persistent_sessions enabled, terminals are owned by a background daemon: they keep running after you quit Terry or close the window, and reattach with their scrollback when you come back. Closing a single tab detaches it (you are told once); reopen it with "Reopen Closed Terminal" or end it with terry daemon kill. Unix only for now
  • Hints — Ctrl+Shift+E lists visible URLs, paths, git hashes, UUIDs, IPs, and custom regex matches; choose one with the keyboard to open, copy, paste, or select. Add custom rules under terminal.hints, for example { "regex": "#\\d+", "action": "copy" }
  • Built-in coding agent — tom ships inside Terry: type tom in any terminal to get a full terminal coding agent that reads, edits, and writes files and runs shell commands. It inherits the terminal's colors, keeps durable JSONL sessions, and needs no separate install. See Coding agent.
  • AI Agent — Chat with LLMs in a side panel; run commands and tools with configurable profiles. The side panel also marks running coding agents as working, waiting for input, or idle, detected from the bottom of the terminal screen (Claude, Codex, Gemini, OpenCode, Cursor, Qwen, Copilot, Grok, Kimi, Amp, Hermes, Qoder, Antigravity, and more)
  • 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)

Shell integration

Terry parses OSC 133 prompt marks (including the VS Code OSC 633 variant) and OSC 7 working-directory reports. With integration active, ctrl-shift-up / ctrl-shift-down move between prompts, and the last command line is recorded so it can be selected or re-run.

  • zsh and fish work out of the box. Terry writes its integration scripts to its data directory (on macOS: ~/Library/Application Support/Terry/shell-integration) and injects them automatically — no dotfile changes needed. Disable it with "shell_integration": false in the terminal section of your settings.

  • bash is supported manually — add one line to ~/.bashrc:

    [ -n "$TERRY_INTEGRATION_DIR" ] && . "$TERRY_INTEGRATION_DIR/bash/terry.bash"
    

    (Works with the system bash on macOS; if bash-preexec is loaded, Terry hooks into it automatically.)

SSH sessions opened from the host picker bootstrap the same integration into a remote zsh, fish, or bash login shell. The remote host needs base64 and a writable cache directory; otherwise Terry silently starts a normal login shell. When the remote shell reports its directory (OSC 7 from another hostname), the terminal is marked as remote in the status bar, and its sidebar/tab name follows the remote folder instead of the local one. SSH commands typed manually inside a terminal, remote tmux sessions, and task runs do not get automatic integration.

CLI

A running Terry instance listens on a local IPC socket (token-protected; connection info in ipc.json under your data directory). The terry binary doubles as the client:

terry new-tab --cwd ~/src          # open a new tab in the active window
terry send-text "cargo test"       # paste text into the active terminal
terry send-text --terminal 7 "hi"  # paste text into a specific terminal (no Enter)
terry run "cargo test"             # paste text and press Enter
terry session save "Work"          # save the active group as a session template
terry session load "Work"          # create a new group from that template
terry session list                 # list saved templates
terry session delete "Work"        # delete a template
terry agents                       # list agent terminals and their state (working/blocked/idle)
terry wait --state blocked         # block until an agent needs input
terry wait --match-output "FAILED" # block until recent terminal output contains FAILED
terry events                       # subscribe to agent state changes (SSE, Ctrl-C to stop)
terry kitten list                  # list installed kitten/plugin executables
terry kitten run hello --arg       # run a kitten (or: terry kitten hello --arg)
terry kitten path                  # show plugin search directories
terry install-cli                  # install terry/terry-daemon/tom into ~/.local/bin
terry uninstall-cli                # remove those shims again

send-text pastes without executing — it never appends a newline. run pastes and submits the command. A session template stores the group's terminals, working directories, profiles/launches, tiling layout, and broadcast setting.

Inside terminals opened by Terry, terry, terry-daemon, and tom are always on PATH: all resolve to the running build, terry-daemon ... is shorthand for terry daemon ..., and tom ... starts the built-in coding agent (see Coding agent). This works even when Terry is launched from a bundle that is not on your login shell's PATH.

To use these from shells Terry did not spawn, run terry install-cli. It writes all three shims into ~/.local/bin (override with --dir DIR or TERRY_CLI_DIR) and prints how to add that directory to PATH if needed. An existing file with the same name that Terry did not create is never overwritten.

Kittens are executables (with a shebang on Unix) in $TERRY_KITTEN_PATH, the kittens/ directory under Terry's config directory, or the kittens/ directory under its data directory. They run with inherited stdio and receive TERRY_KITTEN_NAME, TERRY_KITTEN_DIR, TERRY_KITTEN_PATH, TERRY_PID, TERRY_IPC_URL, TERRY_IPC_TOKEN, TERRY_CONFIG_DIR, and TERRY_DATA_DIR, so they can call the automation API or the terry CLI. Kittens are trusted local executables and receive the IPC token, so only install plugins you trust. Kitty's Python kitten API is not provided; existing kittens need porting to this contract.

Starting terry while an instance is already running focuses that instance instead of launching a second process, and prints the pid of the instance it handed the launch to. Use terry --new-instance to start a second process anyway (handy when running a freshly built binary next to an older one).

Automation API

The same bearer-protected loopback server also accepts JSON requests:

  • /api/list_sessions — groups, group ids, layouts, terminal ids, titles, cwd, and running commands
  • /api/focus_session — focus a terminal by terminal_id / session_id
  • /api/focus_group — switch to a group by group_id
  • /api/send_keys — send text or a keystroke such as ctrl-c
  • /api/send_text — paste text into terminal_id (defaults to the active terminal) without executing it
  • /api/run — paste text and optionally press Enter ("enter": false to skip)
  • /api/read_screen — read a terminal's content as plain text (lines limits it to the last N non-empty lines)
  • /api/screen — read the visible screen as styled cells: colors, bold/italic/underline attributes, cursor position and shape, and the grid size
  • /api/get_context — active terminal title, cwd, group, command, and detec

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryCustomer
Updated1d ago
Forks0

Languages

Rust

Trust signals

85/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 info