Agent Workbench (awb)
Quick Start
- Ensure the user has the playground open with
awb ui. - Run a component with
awb run --title "..." <component> [args]. - Always call
awb wait <id>and read the JSON response.
Components
Interactive: confirm, checklist, ask
Display: code, table, markdown, plan-viewer, html
Essential Rules
- Require
--titlefor everyawb run. - Run
awb run --helpbefore using a component you are unsure about. - If
awbis not on PATH, ask the user to install or run the local CLI.
Interactive Runs (Always wait)
awb run returns immediately with an ID. Always call awb wait <id> to get the response.
bash1ID=$(awb run --title "Q1" confirm --prompt "Approve?") 2awb wait $ID
Fire multiple at once, then wait for each:
bash1ID1=$(awb run --title "Q1" confirm --prompt "Approve?") 2ID2=$(awb run --title "Q2" checklist --items "A,B,C") 3awb wait $ID1 4awb wait $ID2
Wait Results
awb wait <id> returns JSON with the user's response:
json1{"confirmed": true} 2{"items": [{"text":"A","checked":true}]} 3{"answers": {"key": "value"}}
Examples
confirm
bash1awb run --title "Deploy" confirm --prompt "Deploy to production?"
checklist
bash1awb run --title "Tasks" checklist --items "Build,Test,Deploy"
ask (1-4 questions)
bash1awb run --title "Name" ask --questions '[{"question":"Your name?","header":"name"}]' 2awb run --title "Pick" ask --questions '[{"question":"Language?","header":"lang","options":[{"label":"TypeScript"},{"label":"Python"}]}]' 3awb run --title "Features" ask --questions '[{"question":"Enable?","header":"feat","multiSelect":true,"options":[{"label":"Auth"},{"label":"API"}]}]'
table
bash1awb run --title "Data" table --data '[{"name":"Alice","age":30},{"name":"Bob","age":25}]'
code (file only)
bash1awb run --title "Source" code --file ./src/index.ts
markdown
bash1awb run --title "Docs" markdown --file ./README.md 2awb run --title "Notes" markdown --content "# Hello\n\nWorld"
html
bash1awb run --title "Config" html --content '<html>...</html>'
plan-viewer
bash1awb run --title "Plan" plan-viewer --file ./plan.md
Background Processes with tmux
Use tmux for long-running processes. Run awb --help to see your tmux session name.
bash1tmux new-session -A -d -s <session-name> 2tmux new-window -t <session-name> -n "dev" "npm run dev" 3tmux capture-pane -t <session-name>:dev -p 4tmux send-keys -t <session-name>:dev "npm test" Enter 5tmux kill-window -t <session-name>:dev
