Agent command path

From discovery to first runtime inspection.

The command path below follows `/agents`: bootstrap JSON, install, instance-repo setup, auth, and the first read-only inspection sequence.

Open `/agents` Open the CLI tour

Agent-first route: Start at /agents, inspect /docs/cli, and drop into this page when you need proof, detail, or rollout guidance.

Agent-first route

Humans should usually delegate first-pass evaluation to an agent. Agents should start at /agents, use /docs/cli as the official product tour, and open /docs/graphql only when needed.

Agent-ready surface

Start with the CLI, not browser guesswork.

Preferred route: /agents, then /docs/cli, then /docs/graphql only when lower-level integration details matter.

$ mbr spec export --json
$ mbr auth whoami --json
$ mbr queues list --workspace ws_preview --json

Open GraphQL reference | Open schema.graphql

System definition lives on `/agents`

Use `/agents` for system identity, primitives, invariants, evaluation logic, and authoritative resources.

The short command path lives here

Use it when you already know what the system is and want the shortest correct sequence.

Read-only first

Begin with inspection before mutation or deployment decisions.

Production review remains human

Deployment and trust choices still belong to humans.

Quickstart

From discovery to first owned runtime check.

Read `/agents` first for system definition and evaluation logic. Then use this shorter sequence for installation, instance-repo setup, and the first read-only inspection.

1. Read the public bootstrap JSON

Start from the canonical machine-readable discovery surface.

$ curl -fsSL https://movebigrocks.com/.well-known/mbr-agent.json

2. Install `mbr`

Use the public install path that matches the machine.

$ curl -fsSL https://movebigrocks.com/install.sh | shPS> Invoke-RestMethod https://movebigrocks.com/install.ps1 | Invoke-Expression

3. Create the private instance repo

Use the instance template so the agent can build the owned runtime itself.

$ gh repo create acme/mbr-prod --private --template MoveBigRocks/instance-template --clone$ cd mbr-prod$ scripts/read-instance-config.sh mbr.instance.yaml

4. Authenticate and set context

$ mbr auth login --url https://app.yourdomain.com$ mbr context set --workspace ws_preview --team team_operations

5. Start with read-only checks

Inspect queues or knowledge before state-changing operations.

$ mbr queues list --json$ mbr knowledge list --search policy --json

Role

Use this sequence after the product definition is clear.

The product definition, primitives, repo model, and approval rules live on `/agents`. The commands collected here start after that and stay focused on discovery, install, instance-repo setup, auth, and read-only inspection.

References

Canonical next surfaces.

Each link goes to the next authoritative page, reference, or support surface.

Let agents inspect the CLI-first surface. Let humans decide trust, rollout, and boundaries.

Start from /agents, use /docs/cli as the official product tour, inspect /resources for source and proof, and review /security before making deployment or data-handling decisions.

Open /agents Open resources

From discovery to first runtime inspection.

From discovery to first owned runtime check.

1. Read the public bootstrap JSON

2. Install `mbr`

3. Create the private instance repo

4. Authenticate and set context

5. Start with read-only checks

Use this sequence after the product definition is clear.

Canonical bootstrap

CLI tour

Resources

Canonical next surfaces.

Agents

Install CLI

Self-host

Let agents inspect the CLI-first surface. Let humans decide trust, rollout, and boundaries.