Terminals

TeamIDE provides powerful terminal capabilities throughout the application. Terminals can be accessed in multiple ways depending on your workflow.

Ways to Use Terminals

Terminal Module (Overlay)

The Terminal module provides a full-screen terminal overlay with advanced layout options.

Opening the Terminal Module

• Click the Terminal tab in the module bar (or press the keyboard shortcut)

• The terminal opens as an overlay on top of your current view

• Click the Terminal tab again to close the overlay

Layout Modes

Tiled Layout (Default)

Display up to 4 terminals in a grid:

Split Direction: Toggle between horizontal (side-by-side) and vertical (stacked) using the toolbar button.

Stacked Layout

Display up to 6 terminals with one main terminal and smaller stacked terminals:

• Main terminal takes most of the space

• Stacked terminals appear in a vertical column

• Toggle which side the main terminal appears (left/right)

Toolbar Controls

Managing Sessions

Adding Terminals:

• Click the + button in the toolbar

• New terminals appear in the current layout

• Hidden sessions (beyond layout limit) accessible from session list

Removing Terminals:

• Click the X on any terminal pane header

• Session remains available for re-adding later

Switching Active Terminal:

• Click on any terminal pane to make it active

• Active terminal has visual focus indicator

Code Module Terminals

Split View Terminal

Work with code and terminal side-by-side:

1. Open a file in the editor

2. Click the Split Terminal button in the toolbar (or use keyboard shortcut)

3. Terminal appears on the right side of the editor

4. Drag the divider to resize panes

Features:

• Resizable split (20%-80% range)

• Focus indicator shows which pane is active

• Terminal persists when switching files

• Auto-runs Claude if CLAUDE.md detected in repository

Terminal Tabs

Open terminals as tabs alongside your files:

1. Right-click a folder in the file explorer

2. Select Open Terminal Here

3. Terminal opens as a new tab in the tab bar

Or open a file in a terminal editor:

1. Right-click a file in the explorer

2. Select Open in Vim or Open in Nano

3. Editor opens in a terminal tab

Terminals Panel (Right Drawer)

Access all terminal sessions from the Code module:

1. Open the right drawer (if closed)

2. Click the Terminals tab

3. View all sessions organized by repository

Session List Features:

• Sessions grouped by current repository vs. other repositories

• Status indicators show connection state

• Running process indicator with current command

• Click any session to open it as a tab

Tabbed View:

• When sessions are open as tabs, view switches to tabbed mode

• Quick tab switching in the panel

• Add new sessions from the + menu

• Click Back to return to full list

Terminal Features

Session Persistence

Terminals use tmux on the backend for session persistence:

• Sessions survive browser refreshes

• Reconnect to running sessions after disconnection

• Long-running processes continue in background

• Multiple users can share sessions (collaboration)

Persistent Session Indicator: Look for the save icon next to session names.

Clickable File Paths

File paths in terminal output are automatically detected and clickable:

• Click a path like src/app.ts:42:10 to open the file

• Jumps to the specified line and column

• Works with relative and absolute paths

• Supports path:line and path:line:column formats

Enable/Disable: Settings > Features > Clickable file paths

Copy on Select

Automatically copy text when you select it:

1. Select text in the terminal with your mouse

2. Text is automatically copied to clipboard

3. No need for Ctrl+C/Cmd+C

Enable/Disable: Settings > Terminal > Copy on select

Right-Click Paste

Paste clipboard contents by right-clicking in the terminal:

• Right-click anywhere in the terminal area

• Clipboard contents are pasted at cursor

• No context menu appears

Enable/Disable: Settings > Terminal > Right-click paste

Drag and Drop

Drag files into the terminal to insert their paths:

1. Drag a file from the file explorer

2. Drop it into the terminal

3. The file path is inserted (with proper escaping)

Works with files from both the TeamIDE file explorer and your system file manager.

Search

Search through terminal scrollback buffer:

1. Press Ctrl+F (Cmd+F on Mac) or click the search icon

2. Type your search query

3. Press Enter for next match, Shift+Enter for previous

4. Press Escape to close search

In Terminal Module, the search bar affects all visible terminal panes.

Terminal Settings

Access terminal settings from Settings > Terminal.

Appearance

Overlay Indicator

Visual border around the terminal overlay:

Behavior

Editor Integration

Options: Vim, Neovim, Emacs, Nano, or None (prompts each time)

Keyboard Shortcuts

Terminal Module

Code Module

Session Status Indicators

Tool Mounting

Mount local tools into container terminals for enhanced functionality:

Configure tool mounting in Settings > Terminal > Tools.

Connection Modes

Container Terminals

For repositories cloned into containers:

• Connects via WebSocket to terminal proxy

• Full Linux environment with your repository

• Persistent sessions backed by tmux

Local Terminals (Desktop App)

For the native Tauri desktop app:

• Direct connection to local shell

• Access to your system environment

• Same persistence features via tmux

Tips

1. Reuse Sessions: TeamIDE automatically reuses idle terminal sessions to prevent terminal proliferation.

2. Session Names: Sessions are auto-named (Terminal 1, Terminal 2, etc.) but you can rename them for clarity.

3. Multiple Layouts: Use tiled layout for monitoring multiple processes, stacked for focused work with references.

4. File Navigation: Click file paths in error messages to jump directly to the problematic code.

5. Context Switching: Each repository maintains its own terminal sessions - switch repos without losing terminal state.

Related

• Terminal Module - Terminal module overview

• Code Module - Code editor with terminal integration

• Settings - All application settings

Changelog