gitwtfhub

wtf is ibm_bob_harness?

brun3y/ibm_bob_harness — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · developerComplexity · 4/5Setup · moderate

TL;DR

A Docker wrapper that exposes IBM's Bob Shell AI coding agent over a REST API and Slack bot, with an unrestricted execution mode and a verify-and-retry loop.

Mindmap

mindmap
  root((IBM Bob Harness))
    What it does
      Wrap Bob Shell in Docker
      Expose REST API
      Slack bot integration
    Tech stack
      Python
      FastAPI
      Docker
    Use cases
      Run AI coding tasks via API
      Verify and retry results
      Schedule recurring runs
    Audience
      Developers
      Ops teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run IBM Bob Shell coding tasks programmatically over a REST API instead of typing commands directly.

REASON 2

Send tasks to a Slack bot and get Bob's replies back inside a Slack channel.

REASON 3

Automatically verify a task's result and retry it until it passes using the orchestrated /run endpoint.

REASON 4

Schedule recurring Bob runs on a cron-style timer and stream live output over SSE.

What's in the stack?

PythonFastAPIDockerBob Shell

How it stacks up

brun3y/ibm_bob_harness1038lab/comfyui-agnes-aiadityaarsharma/wordpress-malware-removal
Stars181818
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker or Podman and a Bob Shell API key from IBM's Bob website, runs in an unrestricted execution mode by default.

Wtf does this do

IBM Bob Harness is a Docker container that wraps IBM's Bob Shell, an AI coding assistant, so it can run on its own instead of needing someone to type commands into it directly. Bob Shell does not have a built in way to run as a server, so this project adds a REST API on top of it, meaning other programs can send it tasks over the network and get results back, along with a Slack bot that lets you send tasks to Bob and get replies right inside a Slack channel. The container ships with a custom mode called unrestricted-dev, which gives Bob full access to read files, edit files, run commands, use a browser, and use other tools without asking for confirmation each time, sometimes described in the README as a YOLO mode. By default Bob's working directory is set to the root of the container, so in this unrestricted mode it can affect the entire container's filesystem, not just a specific project folder. The API offers several ways to run a task: a synchronous endpoint that waits for Bob to finish and returns the full output, a background job endpoint that starts a task and lets you check on it later, and an orchestrated run endpoint that executes a task, checks whether the result actually meets the goal, and automatically retries if it does not. Results from a running job can also be streamed live as they happen, and you can schedule recurring runs using cron style timing. To use it, you need Docker or Podman installed, a Bob Shell API key created from IBM's Bob website, and optionally Slack bot tokens if you want the Slack integration. After copying your key into a .env file, running docker compose up builds and starts the container, and the API becomes available at localhost port 8080, with automatically generated documentation you can browse in a web browser.

Yoink these prompts

Prompt 1
Walk me through setting up my .env file and Bob API key to run IBM Bob Harness with docker compose.
Prompt 2
Explain what the unrestricted-dev mode and YOLO setting let Bob do inside the container.
Prompt 3
Show me how to call the /run endpoint so Bob verifies and retries a task until it succeeds.
Prompt 4
Help me configure the Slack bot in IBM Bob Harness using the provided manifest.yaml.

Frequently asked questions

wtf is ibm_bob_harness?

A Docker wrapper that exposes IBM's Bob Shell AI coding agent over a REST API and Slack bot, with an unrestricted execution mode and a verify-and-retry loop.

What language is ibm_bob_harness written in?

Mainly Python. The stack also includes Python, FastAPI, Docker.

How hard is ibm_bob_harness to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ibm_bob_harness for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.