Repository navigation
v1.0.0 — Bob Harness: run Bob Shell autonomously via REST API, Slack & cron
First public release of Bob Harness — a container that wraps IBM's Bob
Shell and turns its headless, one-shot CLI into a long-running service you can
drive over HTTP, from Slack, or on a schedule.
Bob Shell has no native server mode. This project wraps its
bob -p "<prompt>" --yolo --chat-mode=unrestricted-dev invocation and adds a
REST API, a verify/retry loop, a Slack bot, and a cron scheduler on top.
✨ Highlights
- REST API (FastAPI, v1.3.0) — call Bob programmatically: synchronous,
streaming (SSE), or fire-and-forget async jobs. - Verify / retry loop —
POST /runre-runs Bob until a shellcheck
command passes (exit 0), up tomax_attempts. - Bidirectional Slack bot — talk to Bob in a channel with no @-mention;
it replies in-thread over Socket Mode (no public URL required), with a
live rotating "Bob is thinking…" placeholder. - Cron scheduler — register recurring runs via
POST /schedules; a
persisted registry survives restarts and posts results to Slack. - Custom
unrestricted-devmode — full read/edit/command/browser/mcp access,
governing the whole container. - Single-container deployment —
serve-allruns the API and the bot
together; ships with aHEALTHCHECKand a compose-level healthcheck.
🔌 REST API
| Method | Path | Purpose |
|---|---|---|
GET |
/health |
Liveness / readiness probe |
POST |
/invoke |
Run Bob and wait for the full result |
POST |
/stream |
Same, streamed as Server-Sent Events |
POST |
/jobs |
Fire-and-forget async run → {id, status} |
GET |
/jobs, /jobs/{id}, /jobs/{id}/stream |
List / poll / stream jobs |
POST |
/run |
Run with a verify/retry loop |
POST |
/schedules |
Register a cron job |
GET/DELETE |
/schedules, /schedules/{id} |
Manage schedules |
POST |
/schedules/{id}/run |
Trigger a schedule now |
Interactive docs at /docs (Swagger) and /openapi.json.
🚀 Getting started
cp .env.example .env # add your BOBSHELL_API_KEY (+ Slack tokens)
podman compose up --build # or: docker compose up --build
curl http://localhost:8080/health
- Full docs: README.md
- Slack setup, step by step: SLACK_SETUP.md
- HTTPie / Postman collection to try every endpoint: httpie/