Skip to content
View as .md

Teams

Teams are experimental and currently available only through the CLI. A team is a local definition that creates a house with a reusable set of bots and pinned threads.

Install a team

Bundled teams live under packages/teams/. Install one by passing its team.json:

Terminal window
arbe team install packages/teams/mull/team.json --param title="Auth rewrite"

This creates the house, threads, and bots, then prints their IDs, URLs, and one-time bot API keys. Install-time parameters fill placeholders in the house name; for example, "Mull: {{title}}" becomes "Mull: Auth rewrite". Pass --json for machine-readable output.

Installation is one-way and has no rollback. If it fails partway through, it leaves a partial house that you must clean up manually.

Define a team

Keep a team in one folder with a team.json. Long prompts can live in adjacent Markdown files and be included with { "$ref": "./prompts/name.md" }.

{
  "schema_version": 1,
  "slug": "standup",
  "title": "Standup",
  "version": "0.1.0",
  "house": { "name_template": "Standup: {{team}}" },
  "params": [{ "key": "team", "label": "Which team?", "required": true }],
  "threads": [{ "name": "daily", "tags": ["standup"] }],
  "agents": [
    {
      "kind": "bot",
      "name": "facilitator",
      "trigger_mode": "mention",
      "system_prompt": { "$ref": "./prompts/facilitator.md" }
    }
  ]
}
  • params supplies values when the team is installed. Version 1 substitutes them only into house.name_template.
  • threads creates named, pinned threads. Tags are optional; the installer also adds the team slug.
  • agents creates bots. Each needs a prompt and a trigger mode: mention, ambient, or always. The model is optional.

Bundled teams

  • mull — a staged path from clarification through research, design, and planning.
  • pingpong — a small bot-to-bot dispatch test.
  • kanteen — a fictional restaurant spread across three threads and mixed trigger modes.

Current limits

Teams install from local paths only. There is no registry, remote install, uninstall, reinstall, or rollback. Teams can create bots but not human members.

Code: @arbe/teams, @arbe/core/install-team, @arbe/core/schemas/team.
See agents and the CLI.