Bash Tool

Purpose

Execute shell commands in isolated environment

The Bash tool provides secure command-line execution capabilities within an isolated sandbox environment, enabling agents to run system commands, manage processes, and interact with the operating system.

Key Features

60-second timeout for command execution
Real-time stdout/stderr capture
Secure authentication with computer service
Support for both local development and production environments
Chat-specific execution context

Parameters

command (string): The shell command to execute

Security Features

API Key Authentication: Secure access via API keys or JWT tokens
Isolated Execution Environment: Commands run in contained sandbox
Command Logging: All executions are logged for monitoring
Timeout Protection: Automatic termination after 60 seconds
Permission Controls: Limited to sandbox environment

Response Format

Returns structured output containing:

stdout: Standard output from command execution
stderr: Error output if any issues occur
command: Echo of the executed command

Environment Support

Local Development: Uses simple API key authentication
Production: JWT token-based authentication with organization context
Computer Service Integration: Communicates with dedicated compute instances

Use Cases

Package management (npm, pip, apt, etc.)
File system operations (ls, mkdir, cp, mv)
Process management and monitoring
System information gathering
Build and deployment scripts
Git operations and version control
Development environment setup

Limitations

60-second execution timeout
Sandbox environment restrictions
No interactive command support
Limited to non-privileged operations

Technical Implementation

HTTP API communication with computer service
JWT authentication for production environments
Error handling for network and execution failures
Structured JSON response format
Integration with TeamDay.ai usage tracking

Guides