agentos-companion
v0.1.2
Published
ChorOS Companion Server — local HTTP server for browser automation, shell execution, and Playwright tests
Maintainers
Readme
agentos-companion
Local companion server for AgentOS. Provides browser automation, shell execution, and Playwright testing capabilities to the AgentOS chat agent.
Quick Start
npx agentos-companionThe server starts on port 8765 by default.
Custom Port
PORT=9000 npx agentos-companionWhat It Does
The companion server runs on your local machine and exposes HTTP endpoints that the AgentOS web app calls to execute tools that need local access:
| Endpoint | Method | Purpose |
|---|---|---|
| /health | GET | Health check (pid, cwd, uptime) |
| /exec | POST | Execute shell commands |
| /browser/* | POST | Browser automation (navigate, click, screenshot, etc.) |
| /playwright | POST | Run Playwright test scripts |
Browser Automation
Browser tools require Playwright installed:
npx playwright install chromiumThe companion manages a single persistent browser context for session continuity.
Requirements
- Node.js >= 18
- Playwright (optional, for browser/test tools)
License
MIT
