bash

Execute bash commands from an agent. Returns stdout + stderr as a string. Unix/Mac only.

The simplest way to give an agent shell access: from connectonion import bash and pass it as a tool.

Quick Start

main.py

from connectonion import Agent, bash

agent = Agent("coder", tools=[bash])

agent.input("run the tests and show failures")
agent.input("install httpx and show the installed version")
agent.input("check git log for last 5 commits")

API Reference

main.py

bash(command, description, cwd=".", timeout=120)

Parameter	Type	Default	Description
command	str	required	Bash command to run
description	str	required	What the command does (shown to user)
cwd	str	"."	Working directory
timeout	int	120	Seconds before timeout (max 600)

Examples

main.py

from connectonion import bash

# Basic commands
bash("git status", "Check git status")
bash("python --version", "Check Python version")

# Working directory
bash("npm install", "Install packages", cwd="/path/to/project")
bash("pytest -v", "Run tests", cwd="./my-module")

# Longer timeout
bash("npm run build", "Build project", timeout=300)

# Direct call — returns output string
result = bash("git log --oneline -5", "Recent commits")
print(result)

Combined with FileTools

A common pair — FileTools for reading/editing, bash for running:

main.py

from connectonion import Agent, bash
from connectonion.useful_tools.file_tools import FileTools

agent = Agent("coder", tools=[FileTools(), bash])

agent.input("read main.py, fix the import error, then run it to verify")

Notes

• Output truncated at 10,000 characters to prevent token overflow

• stdout and stderr are merged in the returned string

• Non-zero exit codes included in output (Exit code: 1)

• Unix/Mac only — use Shell for cross-platform

Shell

Slash Command

bash

Quick Start

API Reference

Examples

Combined with FileTools

Notes

Enjoying ConnectOnion?