BuilderForce Agents

BuilderForce Agents 🤖

“Build faster. Ship anywhere.” — BuilderForce Agents

Self-hosted, open-source AI-powered coding assistant with multi-channel integrations for WhatsApp, Telegram, Discord, iMessage, and more.
Advanced multi-agent workflows, deep code understanding, and RBAC make it ideal for developers and teams. Get coding help, code reviews, and development assistance from anywhere. Plugins add Mattermost and more platforms.

Install BuilderForce Agents and bring up the Gateway in minutes. Guided setup with `builderforce onboard` and pairing flows. Launch the browser dashboard for chat, config, and sessions.

What is BuilderForce Agents?

BuilderForce Agents is a distributed AI runtime built on top of BuilderForce Agents’s self-hosted gateway. It connects your favorite chat apps — WhatsApp, Telegram, Discord, iMessage, and more — to AI coding agents, with added Phase 2 capabilities for secure orchestration, distributed task execution, and team collaboration.

Who is it for? Developers and teams who want a personal AI assistant with enterprise-ready features like RBAC, audit trails, and CI/CD integration — without giving up control of their data or relying on a hosted service.

What makes it different from BuilderForce Agents?

Distributed Runtime: Execute tasks locally or remotely with transport abstraction
Enhanced Security: RBAC, device trust levels, and granular policy enforcement
Task Lifecycle Management: Formal state machine with audit trails and resumability
Team Collaboration: Multi-session isolation and shared agent registries
CI/CD Ready: Designed for automated workflows and team-wide deployments

What do you need? Node 22+, an API key (Anthropic recommended), and 5 minutes.

How it works

flowchart LR
  A["Chat apps + plugins"] --> B["BuilderForce Agents Gateway<br/>(BuilderForce Agents + Phase 2)"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

The Gateway is the single source of truth for sessions, routing, and channel connections, enhanced with distributed task execution and security controls.

Key capabilities

Execute tasks locally or remotely with transport abstraction layer. RBAC, device trust levels, and audit logging for enterprise-ready deployments. WhatsApp, Telegram, Discord, and iMessage with a single Gateway process. Formal state machine with persistence, resumability, and audit trails. Multi-session isolation and shared agent registries for teams. Automated workflows with deterministic execution and GitHub Actions support.

Quick start

```bash npm install -g builderforce@latest ``` ```bash builderforce onboard --install-daemon ``` ```bash builderforce channels login builderforce gateway --port 18789 ```

Need the full install and dev setup? See Quick start.

Dashboard

Open the browser Control UI after the Gateway starts.

Local default: http://127.0.0.1:18789/
Remote access: Web surfaces and Tailscale

Configuration (optional)

Config lives at ~/.builderforce/builderforce.json.

If you do nothing, BuilderForce Agents uses the bundled Pi binary in RPC mode with per-sender sessions.
If you want to lock it down, start with channels.whatsapp.allowFrom and (for groups) mention rules.
For Phase 2 features, see Phase 2 Configuration.

Example:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@builderforce"] } },
}

Start here

All docs and guides, organized by use case. Core Gateway settings, tokens, and provider config. SSH and tailnet access patterns. Channel-specific setup for WhatsApp, Telegram, Discord, and more. iOS and Android nodes with pairing and Canvas. Common fixes and troubleshooting entry point.

Learn more

Complete channel, routing, and media capabilities. Workspace isolation and per-agent sessions. Tokens, allowlists, and safety controls. Gateway diagnostics and common errors. Project origins, contributors, and license.