Documentation Index
Fetch the complete documentation index at: https://docs.upsonic.ai/llms.txt
Use this file to discover all available pages before exploring further.
The AutonomousShellToolKit enables secure terminal command execution within the workspace.
| Tool | Description |
|---|
run_command | Execute shell commands |
run_python | Execute Python code snippets |
check_command_exists | Verify if a command is available |
Configuration Options
| Option | Default | Description |
|---|
shell_timeout | 120 | Default command timeout in seconds |
shell_max_output | 10000 | Maximum output characters before truncation |
blocked_commands | Security defaults | Commands that are blocked |
Example: Running Commands
from upsonic import AutonomousAgent, Task
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project",
shell_timeout=60
)
# Run development tasks
task = Task("Run the test suite and report any failures")
agent.print_do(task)
Example: Python Execution
from upsonic import AutonomousAgent, Task
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project"
)
# Execute Python code
task = Task("Write and run a Python script that calculates the Fibonacci sequence up to 100")
agent.print_do(task)
Command Blocking
By default, dangerous commands are blocked. You can customize the blocklist:
from upsonic import AutonomousAgent
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project",
blocked_commands=["rm -rf", "sudo", "chmod 777"]
)
Environment Variables
Pass custom environment variables to commands:
from upsonic import AutonomousAgent, Task
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project"
)
# The shell toolkit supports environment variables
# Commands run in the workspace directory
task = Task("Set DEBUG=true and run the application")
agent.print_do(task)
from upsonic import AutonomousAgent
agent = AutonomousAgent(
model="anthropic/claude-sonnet-4-5",
workspace="/path/to/project"
)
# Direct execution
result = agent.shell_toolkit.run_command("python3 --version")
print(result)
# Check command availability
exists = agent.shell_toolkit.check_command_exists("docker")
print(f"Docker available: {exists}")
# Run Python code
output = agent.shell_toolkit.run_python("print([x**2 for x in range(5)])")
print(output)
