Settings

Configure TeamIDE appearance, accounts, features, and integrations

Overview

TeamIDE provides a comprehensive settings system organized into panels. Settings are stored locally and persist across app restarts.

Opening Settings

  • Desktop App: Use the native menu or Cmd+, (macOS)
  • Web Version: Click the settings button (gear icon) at the bottom-right

Settings Panels

General

Basic application preferences.

Setting Options Description
Theme Dark, Light, System Application color scheme
Editor Font Size 10-24px Size of text in the code editor
Auto Save On/Off Automatically save files when modified
Usage Data On/Off Share anonymous usage statistics (opt-in)
Recent Repositories On/Off Show recent repos in the repository dropdown
Number of Recent Repos 3-10 How many recent repositories to display

Accounts

Manage connected GitHub and GitLab accounts.

Connected Accounts - View all linked accounts with avatar and type (user/organization) - Click Sign Out to disconnect an account

Add Account - Click GitHub to connect a new GitHub account - Uses device flow authentication (no password entry in TeamIDE) - Follow the on-screen instructions to authorize via github.com

Note: GitLab support is coming soon.

TeamIDE

TeamIDE cloud account and server connection.

Account Section - Sign in status and profile information - Account tier display (Free/Pro) - Account ID and membership date

Server Connection - Connection status indicator - Click Refresh to check connection

Hosted Repositories (Pro feature) - View hosting availability - Configure per-workspace hosting - Upgrade prompt for free tier users

Repositories

Manage local and remote repositories.

Local Repositories - View imported local folders - Click Add to import a folder from your filesystem - Click the trash icon to remove (optionally deletes associated containers)

Cloned Repositories - View all repos cloned from GitHub - Delete cloned repos (warning: deletes local data)

Remote Repositories - Browse repositories from all connected GitHub accounts - Expandable list per account - Shows repository name, description, and privacy status - “Cloned” badge indicates already-cloned repos - Click Refresh to sync with GitHub

Subrepos

Manage git submodules in the current project.

Submodule List - View all submodules with status indicators - Status types: Clean, Dirty, Ahead, Behind, Diverged, Uninitialized

Actions | Action | Description | |——–|————-| | Fetch | Fetch updates for a single submodule | | Pull | Pull changes for a single submodule | | Push | Push changes for a single submodule | | Fetch All | Fetch updates for all submodules | | Pull All | Pull changes for all submodules | | Initialize All | Initialize uninitialized submodules |

Features

Toggle optional features for each module.

Features are organized by: - Module: Which module the feature belongs to (Code Editor, Terminal, etc.) - Category: General, Advanced, or Experimental

Code Editor Features

Feature Default Description
Autocomplete On Suggest completions as you type
Bracket Matching On Highlight matching brackets
Auto Close Brackets On Automatically close brackets and quotes
Code Folding On Collapse code blocks
Git Gutter On Show git status in the editor margin
Markdown WYSIWYG On Rich editing for markdown files
Vim Keybindings Off Use Vim-style keyboard commands
Emmet Abbreviations Off Expand Emmet shortcuts (experimental)

Terminal Features

Feature Default Description
Clickable File Paths On Click file paths to open in editor
Copy on Select Off Auto-copy selected text to clipboard
Right-Click Paste On Paste clipboard on right-click
Bell Sound Off Play sound on terminal bell
Shared Terminal Sessions On Share sessions with collaborators (experimental)

Click Reset All to Defaults to restore all features to their default values.

Plugins

Manage external plugins that extend TeamIDE.

Remote Plugins - Add plugins from GitHub, GitLab, or container URLs - View plugin name, version, and description - Status badges show loaded/loading/error state - Toggle plugins on/off - Reload or remove plugins

Local Plugins (Development) - Load plugins from local file paths - Create new plugins with the wizard - Manage container state for containerized plugins - Rebuild plugins during development

See the Plugin System Guide for details.

Developer Tools

Configure development integrations and CLI tools.

Claude Code Integration - Enable/disable MCP server integration - Shows configuration status - Config location: ~/.claude/claude_desktop_config.json

CLI Tool - Install the teamide command to /usr/local/bin - Usage: teamide --help - Requires password for first-time installation

CLI Commands Reference

Category Commands
Authentication login, logout, whoami
Workspaces list, info, use
Environment Variables list, get, set, delete
Deployments deploy, stop, logs, status

MCP Tools (for Claude Code) - teamide_list_workspaces - List available workspaces - teamide_get_env_vars - Get environment variables - teamide_set_env_vars - Set environment variables - teamide_delete_env_var - Delete an environment variable - teamide_deploy - Deploy a branch - teamide_stop - Stop a deployment - teamide_get_status - Check deployment status - teamide_get_logs - View deployment logs

Hosting Templates - Starter repository with quick-clone button - Pre-built templates: Static Site, Node.js, Vite/React - Copy Dockerfile snippets for common setups

Module-Specific Settings

Some modules add their own settings panels:

Editor Settings

Additional code editor configuration. Access via Settings > Editor.

See Code Module for editor-specific settings.

Terminal Settings

Terminal appearance and behavior. Access via Settings > Terminal.

See Terminal Module for terminal-specific settings.

Settings Persistence

All settings are stored locally in a SQLite database:

  • Settings persist across app restarts
  • No account required for local settings
  • Settings are per-device (not synced across devices)

Changelog

Date Change
2026-02-02 Initial documentation