better-bash

Background process management for LLM coding agents
Non-blocking bash with streaming output, stdin, and long-polling

---

Your agent runs `npm run build` and waits. Does nothing. Watches output scroll by. Wastes tokens.

better-bash fixes that. Five tools that turn blocking bash into background process management: the agent starts a command, does other work, checks back when it's ready.

Install

OpenCode

Add to `~/.config/opencode/opencode.json`:

{
  "plugin": ["better-bash"]
}

MiMoCode

Add to `~/.config/mimocode/mimocode.json`:

{ 
  "plugin": ["better-bash"] 
}

From Source

git clone https://github.com/alper-dev/better-bash.git
cd better-bash
bun install && bun run build

What You Get

Tool	Does
bash_start	Start a command in the background
bash_status	Check status, get new output (long-poll supported)
bash_kill	Kill a running process
bash_stdin	Write to a process's stdin
bash_list	List all running processes

Examples

**Without better-bash:**

agent: bash("npm run build")
agent: ... waits 45 seconds doing nothing ...
agent: "Build complete!"

**With better-bash:**

agent: bash_start("npm run build")
  → { id: "p1", pi