Skip to content

termdock/termdock-issues

Repository files navigation

Termdock

Terminal-Centric AI Development Environment

Unified workspace for AI CLI tools, multi-terminals, and Git workflows

Product Hunt

Languages: English | 繁體中文

DownloadDocumentationReport IssueDiscussions


Demo

Termdock Demo

▶ Watch full video on YouTube

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

Important Notice: Intel Mac Users

If you're on an Intel Mac and experiencing terminal launch issues:

  1. Update to version 1.3.2+ - This fixes the ARM64 PTY loading issue
  2. If errors persist, a dialog will display the full error log
  3. Click "OK" to copy the log and paste it in a GitHub issue

Download the correct DMG for your Mac:

  • Intel Mac → Termdock-x.x.x.dmg
  • Apple Silicon → Termdock-x.x.x-arm64.dmg

What is Termdock?

Termdock is a terminal-centric AI development environment that unifies AI CLI tools, workspace management, and Git workflows in one powerful interface. Built for developers who live in the terminal but want the power of modern development tools.

Why Termdock?

  • AI-First Design - Seamlessly integrate Claude Code, Cursor AI, Aider, and other AI CLI tools
  • AST-Powered Code Search - Tree-sitter integration for 13+ programming languages with intelligent symbol analysis
  • Multi-Workspace Management - Handle multiple projects and repositories with instant context switching
  • Smart Terminal - Split views, tab management, and session persistence built-in
  • Highly Customizable - Themes, backgrounds, layouts - make it yours

Screenshots

AST-Powered Code Analysis

Intelligent symbol search and dependency visualization across 13+ languages

Code Analysis

Multi-Terminal Workspace

Manage multiple terminals, repositories, and AI tools in one unified interface

Multi-Terminal

Theme Customization

Dark mode, light mode, and custom backgrounds - personalize your workspace

Theme Customization


Core Features

Smart Terminal Management

  • Multi-tab interface with independent Shell sessions
  • Quick tab switching (Cmd+1-9)
  • Drag-and-drop tab reordering
  • Session restore - Terminals survive app restarts
  • Split view support:
    • Horizontal split (Cmd+D)
    • Vertical split (Cmd+Shift+D)
    • Flexible pane resizing
  • Picture-in-picture window mode
  • Quick workspace switching (Cmd+P)
  • Terminal grouping by workspace

Remote Terminal Control

  • Telegram bot - Control terminals from your phone: /ws, /new, /send, /read, /watch, /key, /snap
  • Discord bot - Slash commands with interactive button prompts for CLI option selection
  • /watch - Push notifications when background terminals produce output
  • /snap - Per-session or full-window screenshots
  • Setup Guide

Terminal API (Agent Integration)

  • Local HTTP API for AI agents to create and control terminal sessions
  • Polling-based output reading with cursor-based incremental updates
  • Output modes: text (strips ANSI), raw, content (filters TUI chrome)
  • Bearer token authentication with rate limiting
  • API Documentation

AST Code Analysis

  • Tree-sitter + LSP integration supporting 13+ programming languages:
    • JavaScript, TypeScript, Python, Rust, Go
    • C, C++, Java, Ruby, PHP, Swift
    • And more...
  • Intelligent symbol reference finding
  • Dependency analysis and visualization
  • Function call graph generation
  • Precise code navigation

AI CLI Tools Integration

  • Optimized workflows for:
    • Claude Code
    • Cursor AI
    • Aider
    • GitHub Copilot CLI
    • And any terminal-based AI tool
  • Large context paste with compression logging
  • AI-generated commit messages (BYOK)
  • Voice input via Whisper transcription
  • Claude Code Skills - Install skills from Settings to teach Claude Code how to use Termdock features:
    • Termdock AST Skill - Query codebase structure, find symbols, analyze dependencies via REST API
    • Termdock Terminal API Skill - Agent-controlled terminal sessions

Git & File Management

  • Complete Git integration with visual branch management
  • Full-featured file explorer
  • Clipboard image auto-processing
  • Drag-and-drop file upload with validation
  • Full-text search and fuzzy filename matching

Developer Experience

  • Dynamic theme system with custom backgrounds
  • Discord Rich Presence - Show Termdock activity in Discord status
  • Global hotkey support
  • Fast, native macOS performance
  • Lightweight and responsive

What's Coming Next

Planned (Q2-Q3 2026)

  • Project Aurora - Rust rewrite of code analysis engine for parallel file scanning and parsing
  • Multi-Git Repository Support - Mount multiple Git repos under a single workspace with automatic context switching
  • Terminal API Advanced Integration - Agent collaboration protocols, external tool query and control
  • Default File Reader for macOS - Open Markdown, JSON, YAML files directly from Finder
  • Linux Support - Native builds for Debian/Ubuntu and AppImage

View Full RoadmapFeature Requests


Download & Installation

Homebrew (Recommended)

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

Manual Download

Latest Release: Download Here

macOS Requirements

  • macOS 10.14 or later
  • Intel or Apple Silicon processor
  • Recommended: Apple Silicon (M1/M2/M3/M4) for optimal performance

Installation Steps

  1. Download the appropriate DMG for your Mac:
    • Intel Mac: Termdock-x.x.x.dmg
    • Apple Silicon: Termdock-x.x.x-arm64.dmg
  2. Open the DMG file and drag Termdock to Applications folder
  3. First launch may require allowing the app in:
    • System PreferencesSecurity & Privacy

Platform Availability

  • macOS (Intel & Apple Silicon)
  • Windows
  • Linux (Coming Soon)

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:
    • macOS version
    • 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

Version Information

  • Stable Releases: Production-ready updates
  • Development Releases: Preview versions with latest features
  • System Requirements: macOS 10.14+, Apple Silicon recommended

Termdock - Making AI Development Smarter and More Efficient

Built for developers who live in the terminal

WebsiteDownloadDocs