Files
theia-code-os/packages/ai-terminal/README.md
mawkone 8bb5110148
Some checks failed
Playwright Tests / Playwright Tests (ubuntu-22.04, Node.js 22.x) (push) Has been cancelled
3PP License Check / 3PP License Check (11, 22.x, ubuntu-22.04) (push) Has been cancelled
Publish packages to NPM / Perform Publishing (push) Has been cancelled
deploy: current vibn theia state
Made-with: Cursor
2026-02-27 12:01:08 -08:00

1.8 KiB


theia-ext-logo

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

Trademark

"Theia" is a trademark of the Eclipse Foundation https://www.eclipse.org/theia