Hand tasks to bros in chat. They work on your machine.

robroz is a self-hosted, single-machine multi-agent workspace that you drive through chat, not an IDE. Each bro (agent) works in a Docker sandbox on your computer, and progress, approvals and results come back to the conversation as cards.

Quick startView on GitHub

You

查一下 Rust 最近一个版本的新功能,写成三点

Look up what's new in the latest Rust release, in three points

Ada排队

Queued

One status card per task, updated in place. The result is a file in the group's folder.

What a bro can do today

Task cards

In a group, start a message with @name to give that bro a task; in a DM every message is a task. Each task gets one status card that moves from queued to running to done, with a short progress line while it runs. The result arrives as a delivery card. Scheduled routines deliver a briefing the same way.

Memory

A bro can propose something to remember about you: who you are, how you work, or a project note. It only counts after you press 「记下」 (Keep) on the confirm card. You can also add, edit and forget memories yourself on the Memory page. A basic version: memories are added to the bro's prompt, and grant no permissions.

Skills

A skill is a named set of instructions, such as how you like a weekly report written. A bro can propose one; you save it from the confirm card, then switch it on for the groups that should use it. A basic version: skills are prompt text only, and grant no permissions.

You're in control

Bros read and write their group's folder freely. Anything that reaches outside stops and waits for you.

Three permission tiers

Reading and writing the group folder is allowed. Outbound network is GET-only and counted per task (8 by default). External writes and captchas stop the task and wait for a person.

Approval cards

When a task reaches an external write, it pauses and the host posts an approval card. The status card reads 「等你批准」 (Waiting for your approval). Press 「批准」 (Approve) and the task queues again and finishes; press 「拒绝」 (Deny) and it ends without doing that step. The card then shows who answered and when, for example 「我 批准 · 14:02」 (I approved · 14:02).

Takeover

Some steps need a person, such as a captcha. When a task gets stuck, it stops and waits for someone to take over.

Ada卡住

Stuck

Sandbox

Every task runs in a Docker container with no network. Web search and page reads are made by the host on the bro's behalf and count towards the same per-task limit. Your search key stays on your machine.

Ada等你批准

Waiting for your approval

Self-host it

You need the Rust stable toolchain and Docker. From the repository root:

# host and desktop clientcargo build -p robroz-host -p robroz-client# runner image used for tasksdocker build -f runner/Dockerfile -t robroz-runner:local .# listens on 127.0.0.1:8790 only, no token neededcargo run -p robroz-host# in a second terminalcargo run -p robroz-client

In the client, click 「引入一个 bro」 (add a bro) next to the 「聊天」 (Chats) heading, open its DM and send a message: that is your first task. Without a model configured, the bro writes your message back as the result.

To connect an OpenAI-compatible model, set up web search, set a token or reach the host from another machine, see the install guide. Install guide

The host, the runner and the desktop client are written in Rust. The client is native on Windows, Linux and macOS, with no web view.