Skip to content

IBM_Bob_Slack_Integration

Choose a tag to compare

@BrUn3y BrUn3y released this 17 Aug 03:21
· 23 commits to main since this release

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 /run re-runs Bob until a shell check
    command passes (exit 0), up to max_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-dev mode — full read/edit/command/browser/mcp access,
    governing the whole container.
  • Single-container deployment — serve-all runs the API and the bot
    together; ships with a HEALTHCHECK and 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/