mobius 开源编码智能体运行时发布 0.17.8

An open-source runtime for coding agents.

A Rust framework, a gateway that runs your agents, a terminal client, and a native macOS app.
Run it on your own machine and pick up the same conversation from your Mac, terminal, iPhone, or iPad.

Quick start · Embed · Contribute · User guide · Rust API

What is in this repository

The iPhone and iPad app connects to the same gateway and is maintained separately.

This checkout prepares 0.17.8 for all four packages. It requires protocol 102 clients and gateway configuration version 30. Protocol 101 clients cannot connect; update clients before upgrading a gateway. Gateways already on 0.17.2 can upgrade in place. Existing 0.16.x gateways require an offline configuration conversion that preserves usage history in usage.json. See the 0.17.8 upgrade notes for client compatibility and rollout details, and the 0.17.7 notes for older configuration conversions.

Quick start

Install with Homebrew on macOS or Linux:

brew tap citizenhicks/mobius
brew trust citizenhicks/mobius
brew install mobius-cli
brew install --cask mobius-app   # the macOS app, optional

Then open a project:

cd /path/to/your/project
mobius

The first launch starts a local gateway in the background and opens provider setup. Connect a provider, choose a model, and start a conversation with the default @mobius Bot. Use /login to change providers and /bot to edit the Bot.

Built-in providers are OpenAI, Codex, Anthropic, DeepSeek, Kimi, Mistral, OpenRouter, and A2Agent, plus any endpoint that implements the OpenAI Responses API.

Other ways to install (the CLI guide has the details):

• Prebuilt archive: download mobius-<version>-<target>.tar.gz from Releases for Apple Silicon macOS (aarch64-apple-darwin) or 64-bit Intel/AMD Linux (x86_64-unknown-linux-gnu).
• Cargo: cargo install --locked mobius-cli. This needs Rust 1.100.0 or newer, and cloudflared installed separately if you want Quick Connect.

On Linux, sandboxed command execution requires Bubblewrap.

Connect your other devices

mobius-gateway connect

The gateway prints an address and a single-use pairing code. Enter them in the Apple app under Use your own gateway, or run the mobius pair command it prints on another terminal. By default this uses an account-free Cloudflare tunnel whose address changes when the gateway restarts. The gateway guide covers stable addresses and direct TLS. Keep the gateway machine awake and reachable for remote access and scheduled work.

The iPhone and iPad app is in TestFlight beta. If you would rather not host a gateway, möbius Cloud runs this same gateway for you; it is in beta and optional.

How it fits together

The gateway is where files, commands, provider credentials, and agent sessions live. Clients send requests and render the same event stream, so work continues while the gateway runs, even after you close a client.

Each Bot chooses its capabilities. File and shell tools are always present. Memory, context compaction, subagents, voice, questions, attachments, and artifacts start on; task lists, workspace instructions, image generation, computer control (Chromium, and native apps on macOS), and installed Agent Skills or OpenAI-format plugins start off. MCP and app connectors are not yet supported.

Commands run in a sandbox, Seatbelt on macOS and Bubblewrap on Linux, and fail closed if it is unavailable. A Bot's approval policy decides which actions need your confirmation; Full access lets its tools use everything the gateway account can. The gateway guide explains these boundaries, computer control, and the Linux desktop.

Embed the framework

[dependencies]
mobius = "0.17"

You compose an AgentConfig from a model router, a sandbox, a checkpoint store, and an ordered middleware stack. The core owns one linear session and its model and tool loop. Your application supplies the dependencies and consumes frontend-neutral events.

• Bring a model: implement Model, or register a built-in provider with ModelRouter.
• Add a capability: implement Middleware. It owns its tools, lifecycle hooks, state, commands, and presentation.
• Build a frontend: submit protocol::Op values and render protocol::Event values.
• Choose storage and execution: inject a CheckpointStore and a SandboxBackend.
• Handle files and images: inject one backend::session_files::SessionFileStore into ModelRouter and the media-capable middleware. Tool results carry ordered ContentPart text, image, and file parts; checkpoints store references, not bytes.

Start from the compile-checked composition example in the API documentation. The gateway is the shipped composition root and the largest worked example.

Work on this repository

cargo run --locked -p mobius-cli --bin mobius   # build and run the terminal client
just test                                       # every test in the workspace
just complexity                                 # Clippy, warnings denied
just rules                                      # project rules Clippy cannot express

Rust 1.100.0 is pinned in rust-toolchain.toml. The shared Cargo configuration uses RUSTC_BOOTSTRAP for the experimental eight-worker compiler frontend; Cargo also builds independent crates in parallel. Linux sandbox tests need Bubblewrap.

Read AGENTS.md before you change anything: it holds the design rules, the Rust style rules, the checks to run before handoff, and the release order. Issue reports and contributions are welcome.

Documentation

The four packages share one version number. The three crates are published to crates.io one at a time and the macOS app is released as a signed build; see Releases in AGENTS.md.

License

Apache-2.0. See NOTICE for third-party attributions.