Skip to content

Repository files navigation

Termdock

Let AI Write the Code. You Own the View.

An AI-native terminal for macOS & Windows — hand your work to Claude Code, Codex, Gemini, OpenCode, or GitLab Duo, supervise everything from one GPU-accelerated workspace, and make every pixel of the backdrop yours.

Product Hunt

Languages: English | 繁體中文 | 日本語

DownloadDocumentationReport IssueDiscussions


Demo

Termdock demo — AI agents coding in a multi-terminal workspace with custom background and themes

▶ Watch full video on YouTube

Note: This repository is for downloading Termdock releases and reporting issues. Main development happens in a private repository.


What is Termdock?

The way we build software has changed: the agent writes, you direct. Termdock is a terminal-first development environment for macOS and Windows built around that reality — a fast, GPU-accelerated terminal emulator where Claude Code, Codex, Gemini CLI, OpenCode, and GitLab Duo run as first-class sessions, their permission requests land in an approval panel instead of scrolling past, and their output gets verified with code intelligence and visual Git review. Your workspaces don’t have to be local either: pair with another machine over the LAN or reach any server over SSH (beta), and their terminals open right next to your own. Meanwhile, the screen you stare at all day is entirely yours: custom background images, themes, fonts, translucent chrome.

Why Termdock?

  • AI-agent native — first-class sessions for Claude Code, Codex, Gemini CLI, OpenCode, and GitLab Duo; agents work in the background by default and never steal your pane
  • You stay in command — permission requests, questions, and plan reviews become cards you approve or deny from a dedicated panel, even from your phone
  • Your machines, one dock — mount workspaces from LAN peers or any SSH-reachable server (beta) and open their terminals like local ones
  • Verify what the AI wrote — a framework-aware code graph, diff impact analysis, and a visual three-pane Git review with blame and Twin Focus highlighting
  • The view is yours — custom background images, dark/light themes, custom fonts, translucent glass chrome
  • Fast and power-efficient — WebGL (GPU) rendering cuts renderer CPU by ~90% under heavy output, with automatic power-saving on battery

✨ New in v1.19

  • SSH Remote Workspaces (Beta) — mount a directory on any SSH-reachable server into your workspace list; terminals feel local, brief drops reconnect automatically
  • LAN Peer Remote (since v1.18) — discover nearby Termdock devices, pair once, mount their workspaces, and open remote terminals over an end-to-end encrypted connection with no cloud relay
  • Windows hosts, zero setup — pairing with a Windows machine no longer needs manual firewall configuration; the installer handles it
  • Hosts see everything — watch inbound terminal sessions live from the host side, read-only
  • Scheduled automation (since v1.17) — cron-style scheduled prompts and idle keep-alive for agent sessions, now editable in place
  • Light theme & surfaces overhaul — consistent colors across light and dark, plus solid or glass dialog surfaces selectable in Settings
  • In-app issue reporting — the new Report menu files bugs straight from the app

Full release notes →


Screenshots

Visual Git Review

Three-pane diff review with blame, cross-file navigation, and Twin Focus token highlighting

Termdock visual Git review — three-pane diff review with blame and Twin Focus token highlighting

Code Intelligence

Symbol search, call graphs, and dependency visualization across 13+ languages

Termdock code analysis — AST symbol search and dependency graph

Multi-Terminal Workspace

Terminals, file previews, repositories, and AI agents in one unified grid

Termdock multi-terminal workspace — split panes and tabs

Theme Customization

Dark mode, light mode, custom backgrounds and fonts — your terminal, your view

Termdock terminal theme customization — custom background image and translucent chrome


Features

Hand Off the Work

Stop babysitting terminal scrollback. In Termdock, Claude Code, Codex, Gemini CLI, OpenCode, and GitLab Duo run as managed agent sessions — in the background by default, so your pane stays yours while they grind.

  • Agent Workstream — permission requests, questions, and plan reviews are intercepted into structured cards; approve, deny, or answer from a dedicated panel. termdock hooks setup wires everything in one command
  • Terminal API — a local HTTP API for agents and scripts: create, control, and read terminal sessions (including headless ones), stream output in real time via SSE, authenticate with service tokens and rate limiting. API Documentation
  • termdock CLI — create, attach, and follow sessions or query the focused workspace from any shell script
  • Voice input via Whisper, AI-generated commit messages (BYOK), and installable Claude Code Skills for Termdock's AST and Terminal APIs

Own the View

The agents may write the code, but the screen you stare at eight hours a day is yours. Put your own image behind your terminal — Termdock tints an automatic readability scrim from the picture's own colors, so the text stays crisp and the art stays visible.

  • Dynamic theme system — dark mode, light mode, and per-theme accent colors across the entire app
  • Custom terminal fonts — including custom font search paths beyond system locations
  • Translucent glass chrome — unified across terminal panes and in-pane file viewers
  • Discord Rich Presence — show Termdock activity in your Discord status

A Terminal That Stays Fast

Agents produce a firehose of output. Termdock renders it with WebGL (GPU) instead of laying out every cell in the DOM — renderer CPU under heavy output drops by roughly 90% — and an automatic power-saving mode dials things back on battery and lets the GPU loose when you're plugged in.

  • Session restore — quit the app, come back, and every terminal is exactly where you left it
  • Split panes & tabs — horizontal (Cmd+D) and vertical (Cmd+Shift+D) splits, drag-and-drop reordering, quick switching (Cmd+1–9), picture-in-picture mode
  • Dock parking — drag a terminal you're not watching into the dock: no pane, no tab-strip slot, notifications keep piling up, and it's ready whenever you are
  • Background & headless terminals — long-running shells keep full screen state without a visible pane

Output You Can Actually Click

Every command's output range and working directory are tracked through shell integration (OSC 133), so file paths in your output just work: git diff prefixes are cleaned up, wrapped long paths are reassembled, and relative paths resolve against the directory the command actually ran in.

  • Listening port badges — see which ports your workspace services are listening on, live in the sidebar, no more lsof
  • Host detection — Termdock knows whether each session is local, over SSH, or inside a container

Verify What the AI Wrote

"Done!" says the agent. Termdock helps you check. A native Rust indexing pipeline builds a code graph that goes beyond functions and classes — it understands your web framework — and maps any diff back to its blast radius.

  • Diff impact analysis — a git diff maps onto the code graph and walks back to affected callers, so you know what the agent's change actually touches before you accept it
  • Framework route nodes — routes in Express, Fastify, Koa, FastAPI, and Flask become first-class graph nodes, traceable from route to handler to middleware
  • Tree-sitter + LSP across 13+ languages — JavaScript, TypeScript, Python, Rust, Go, C, C++, Java, Ruby, PHP, Swift, and more
  • Code Graph MCP server — expose your codebase structure to Claude Code, Codex, Cursor, and any MCP-compatible tool

Review Git Where You Work

The final check before you ship what the agent built — without bouncing to a browser. Termdock ships a visual Git review surface: three-pane layout with blame, cross-file navigation, and smooth handling of large files.

  • Twin Focus — corresponding tokens highlight on both sides at once, so renames line up at a glance
  • Read-only merge / conflict review, visual branch management, and colors that follow your theme

Workspaces Without Ceremony

Drop a folder onto Termdock and you have a workspace. Tag it, and the sidebar and quick switcher (Cmd+P) group everything automatically.

  • File previews inside panes — Markdown, code, JSON/YAML/XML, PDF, and images open in the same grid as terminals, with the same tabs and drag-and-drop rules
  • Full-featured file explorer, fuzzy search with */? wildcards, Markdown export to standalone HTML

Work Across Machines

Your projects don't all live on one computer. Termdock mounts remote workspaces next to local ones — same grid, same tabs, same shortcuts.

  • LAN Peer Remote — devices on the same network discover each other automatically; pair once, stay trusted, and mount shared workspaces over an end-to-end encrypted channel with no cloud relay
  • SSH Remote Workspaces (Beta) — enter an address, sign in, and work on any SSH-reachable server; terminal-first today, with remote file and Git panels on the way
  • Self-healing connections — brief drops and host restarts reconnect automatically, and interrupted sessions are kept alive for a recovery window
  • Host stays in control — sharing is off until enabled in Settings, unsafe roots are rejected, and inbound sessions are visible and individually terminable

Supervise From Your Pocket

The agent doesn't stop when you leave the desk — and neither does your oversight. Control terminals remotely from Telegram or Discord: send input, read output, get notified when background terminals produce output (/watch), and grab screenshots (/snap). Setup Guide


What's Coming Next

v1.19 stable → v1.20

  • SSH remote hardening — closing the gap from beta to stable
  • Remote File and Git panels — browse files and review Git on mounted remote workspaces, not just terminals

Beyond

  • Browser access — reach your terminals from outside the desktop app
  • Windows native Rust PTY
  • Linux support

View Full RoadmapFeature Requests


Download & Installation

macOS — Homebrew (Recommended)

brew tap termdock/termdock-issues https://github.com/termdock/termdock-issues
brew install --cask termdock

Manual Download

Latest Release: Download Here

Platform File
macOS (Apple Silicon, recommended) Termdock-x.x.x-arm64.dmg
macOS (Intel) Termdock-x.x.x.dmg
Windows Termdock.Setup.x.x.x.exe
Linux Coming soon

macOS Requirements: macOS 10.14 or later, Intel or Apple Silicon (M1/M2/M3/M4 recommended)

macOS Installation

  1. Download the appropriate DMG for your Mac
  2. Open the DMG file and drag Termdock to Applications folder
  3. First launch may require allowing the app in System PreferencesSecurity & Privacy

Intel Mac users: if the terminal fails to launch, update to version 1.3.2+ (fixes an ARM64 PTY loading issue). If errors persist, click "OK" on the error dialog to copy the log and paste it in a GitHub issue.


Bug Reports & Feature Requests

Found a bug or have an idea? We'd love to hear from you!

Create an Issue | Start a Discussion

Before Reporting

  • Check if the issue already exists
  • Try the latest version
  • Include:
    • OS and version (macOS / Windows)
    • Termdock version
    • Steps to reproduce
    • Error logs (if applicable)

Community & Support


Stay Updated

Follow this repository to get notified of new releases:

  1. Click Watch at the top
  2. Select CustomReleases

Termdock — let AI write the code; the view stays yours

For developers who delegate the work, not the taste

WebsiteDownloadDocs

About

Let AI write the code — you own the view. Termdock: the AI-native terminal for macOS & Windows. Claude Code / Codex / Gemini / GitLab Duo agent sessions, diff impact analysis, visual Git review, and a fully customizable backdrop (your images, themes, fonts). GPU-fast, battery-kind.

Topics

Resources

Stars

146 stars

Watchers

6 watching

Forks

Releases

Contributors

Languages