Skip to main content

๐ŸŽฏ Promptbox

Remote prompt inbox for the coding agent.

Send a prompt from anywhere โ€” it lands as a GitHub issue โ€” the agent handles it.

Project status: production-ready, zero backend, mobile-first, published on npm.


๐ŸŽฏ What it doesโ€‹

CapabilityDescription
Zero backendStatic HTML page, no server, no database
GitHub integrationPre-fills issues/new?title=โ€ฆ&body=โ€ฆ
Mobile-firstWorks on any device with a browser
Agent workflowCoding agent picks up issues and closes them
Multi-projectSupports multiple project targets

โš™๏ธ How it worksโ€‹

flowchart LR
U["user<br/>any device"] --> P["prompt inbox page<br/>static, zero backend"]
P --> I["GitHub issue<br/>pre-filled"]
I --> A["coding agent<br/>picks it up"]
A --> H["handled + closed"]
  1. Open bartoszosiej.github.io/prompt-inbox
  2. Pick a project, type a prompt, hit Submit
  3. A pre-filled GitHub issue opens in the browser
  4. The coding agent picks it up, handles it, and closes the issue

๐Ÿš€ Quick startโ€‹

# Local dev
python3 -m http.server 8080

# Docker
docker build -t ghcr.io/bartoszosiej/prompt-inbox:latest .
docker run -p 8080:80 ghcr.io/bartoszosiej/prompt-inbox:latest

# npm
npx prompt-inbox

๐Ÿ“– Usageโ€‹

For usersโ€‹

  1. Open the prompt inbox page
  2. Select target project from dropdown
  3. Type your prompt
  4. Click Submit โ†’ GitHub issue opens
  5. Agent handles it

For agentsโ€‹

When the user says "check the inbox":

  1. Read open issues from https://api.github.com/repos/BartoszOsiej/Promptbox/issues?state=open
  2. Each issue has: title [Project] summary, body with the prompt
  3. Handle the prompt in the relevant project repo
  4. Close the issue
  5. Reply to the user with what was done