Module @theia/ai-terminal
ECLIPSE THEIA - AI TERMINAL EXTENSION
Description
The @theia/ai-terminal extension contributes an overlay to the terminal view.
The overlay can be used to ask a dedicated TerminalAgent for suggestions of terminal commands.
It also provides the shellExecute tool that allows AI agents to run commands on the host system.
Shell Execution Tool
The shellExecute tool enables AI agents to execute shell commands on the host system with user confirmation.
Security
By default, every command requires explicit user approval. The tool is marked with confirmAlwaysAllow, which shows an additional warning dialog when users try to enable auto-approval.
Warning: This tool has full system access. Only enable auto-approval in isolated environments (containers, VMs).
Features
- Execute any shell command (bash on Linux/macOS, cmd/PowerShell on Windows)
- Configurable working directory and timeout (default 2 min, max 10 min)
- Output truncation (first/last 50 lines) for large outputs
- Cancellation support
Additional Information
License
- Eclipse Public License 2.0
- δΈ€ (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception
Trademark
"Theia" is a trademark of the Eclipse Foundation https://www.eclipse.org/theia
Modules
- browser/ai-terminal-agent
- browser/ai-terminal-contribution
- browser/ai-terminal-frontend-module
- browser/ai-terminal-prompt-template
- browser/shell-execution-tool
- browser/shell-execution-tool-renderer
- common/shell-execution-input-parser
- common/shell-execution-server
- node/ai-terminal-backend-module
- node/shell-execution-server-impl