Getting Started
From installation to your first workspace, get up and running with Termdock in 5 minutes.
1. Download & Install
Termdock currently supports macOS. Follow these steps to install:
- Go to the GitHub Releases page
- Download the latest
.dmgfile - Open the downloaded DMG file
- Drag Termdock to the Applications folder
- On first launch, you may need to allow execution in System Preferences > Privacy & Security
2. First Launch
When you first launch Termdock, the app will automatically initialize:
- Shell Detection: Automatically detects your system's default shell (usually zsh or bash)
- Config Creation: Creates configuration files in
~/.termdock - Theme Selection: Choose between dark or light theme
- AI Tool Detection: Scans for installed AI CLI tools (Claude, Copilot, etc.)
3. Create Your First Workspace
Workspaces are Termdock's core concept - each workspace corresponds to a project:
Method 1: Quick Create
- Click the "+" button in the top-left or press Cmd+N
- Select a project folder
- Enter workspace name (optional)
- Click "Create Workspace"
Method 2: Use Project Templates
- Click "Create New Project"
- Choose a template (React, Node.js, Python, etc.)
- Set project name and location
- Optional: Link to GitHub repository
4. Start Using
Congratulations! You're ready to start using Termdock. Here are some common operations:
- Cmd+T - New terminal tab
- Cmd+P - Switch workspace
- Cmd+B - Toggle sidebar
- Cmd+1-4 - Switch window layout
- Cmd+Shift+F - Global search