io.github.RohitYajee8076/backburner

Official

by RohitYajee8076 · Python

Run long shell commands as background tasks: start them, keep working, collect the results later

Run long shell commands as background tasks and retrieve results asynchronously.

Topics

ai-agentsbackground-jobsclaudemcpmcp-servermodel-context-protocolpython

Install

Configuration

Environment variables

BACKBURNER_HOME

Directory for the task database and log files (default: ~/.backburner)

BACKBURNER_ALLOW

Comma-separated regexes; if set, only matching commands may run

BACKBURNER_DENY

Comma-separated regexes; matching commands are always refused (deny wins over allow)

claude_desktop_config.json

{
  "mcpServers": {
    "backburner": {
      "command": "uvx",
      "args": [
        "backburner-mcp"
      ],
      "env": {
        "BACKBURNER_HOME": "<YOUR_BACKBURNER_HOME>",
        "BACKBURNER_ALLOW": "<YOUR_BACKBURNER_ALLOW>",
        "BACKBURNER_DENY": "<YOUR_BACKBURNER_DENY>"
      }
    }
  }
}