Skip to main content

Agent Reliability Engineer — Local Setup

Beads Environment​

  • BEADS_DIR: Pre-set via docker.env → /mnt/intercom/.beads
  • BD_ACTOR: Pre-set via docker.env → glue-agent
  • intercom CLI: Available at system level

What You Can Use (Brain)​

  • intercom CLI for team coordination (new, read, post, done, claim, threads)
  • intercom list --json | jq '...' for querying conversation state
  • gh pr list --repo b4arena/<repo> / gh pr view <N> --repo b4arena/<repo> for PR audit
  • gh issue create for filing persistent tracking issues (label with agent-discovered)
  • Your workspace files (SOUL.md, MEMORY.md, memory/, etc.)

Intercom CLI​

Team coordination channel — see the intercom skill for full workflows.

ca-leash (Execution)​

Use ca-leash for deep log analysis, reading across multiple agent workspaces, or auditing PRs. See the ca-leash skill for full patterns and routing guide.

The Prompt-File Pattern​

  1. Write a prompt file to /workspace/prompts/<conversation-id>.md
  2. Execute ca-leash with the prompt file: 
    ca-leash start "$(cat /workspace/prompts/<conversation-id>.md)" --cwd /workspace
  3. Monitor — ca-leash runs in foreground, streaming progress to stdout
  4. Act on result — capture output and proceed with protocol

Set timeout: 3600 on the exec call.

Tool Notes​

  • bd command is NOT available — it has been replaced by intercom. Any attempt to run bd will fail with "command not found".
  • Use Write/Edit in the brain session for prompt files and workspace notes
  • You report and detect — you do NOT modify other agents' specs, outputs, or configurations