Tab Management
Work with multiple files using tabs
Overview
TeamIDE uses tabs to manage open files, terminals, and diffs. You can have multiple tabs open and switch between them easily.
Tab Types
| Tab Type | Icon | Description |
|---|---|---|
| File | Language-specific | Code files, text files, configs |
| Terminal | Green terminal | Embedded terminal sessions |
| Diff | Orange difference | File change comparisons |
Opening Tabs
Files
- Click any file in the Explorer to open it as a tab
- Files open in a new tab unless already open
Terminals
- Click Add Terminal Tab (green + icon) in the tab bar
- Choose from:
- Terminal - New bash session
- Claude - Terminal with Claude CLI
- Open Existing - Connect to an existing terminal
Diffs
- Click a file in the Changes tab to see uncommitted changes
- Click a file in the History tab to see that commit’s changes
Closing Tabs
| Method | Action |
|---|---|
| Click X | Click the close button on any tab |
| Middle-click | Middle-click anywhere on the tab |
Switching Tabs
Click any tab to make it active. The active tab shows: - Blue accent line on top - Its content in the main area
Tab Indicators
File Tabs
| Indicator | Meaning |
|---|---|
| White dot | Unsaved changes |
| M badge | Git: modified file |
| A badge | Git: added/staged file |
| U badge | Git: untracked file |
| D badge | Git: deleted file |
Terminal Tabs
| Feature | Description |
|---|---|
| Pop-out button (↗) | Open terminal in separate window |
| Client count | Shows how many viewers are connected |
Tab Overflow
When you have many tabs open: - The tab bar scrolls horizontally - All tabs remain accessible by scrolling - Tab widths stay between 120-200 pixels - Long filenames are truncated with “…”
Tab Persistence
TeamIDE remembers your open tabs:
What’s Saved
- Which files are open
- Which tab is active
- This is saved per repository
What’s Restored
When you reopen the app or switch back to a repository: - Previously open file tabs reopen - The last active tab becomes active again - Folder expansion state in Explorer is restored
What’s Not Saved
- Terminal tab content (sessions are temporary)
- Unsaved file changes (save before closing!)
- Diff tabs (reopen from Changes/History)
Terminal Tab Features
Terminal tabs have special features:
Pop-Out Window
Click the ↗ button to open the terminal in a separate window: - Window connects to the same session - Multiple windows can view the same terminal - Close the window to return to tab view
Shared Sessions
Terminal sessions persist in tmux: - Close and reopen tabs without losing session - Session continues running in background - Reconnect from Terminal module or tab bar
Tips
- Keep important files open: Tabs persist across sessions
- Use terminal tabs: Embed terminals right next to your code
- Middle-click to close: Faster than clicking the X button
- Check for unsaved: Look for the white dot before closing
Related
- Code Module - Editor features
- Terminal Module - Terminal features
- Git Integration - Understanding git status badges
Changelog
| Date | Change |
|---|---|
| 2026-02-02 | Initial documentation |