One AI agent, everywhere you work.

Terminal, desktop, mobile, and your chat apps — one Rust core, one agent, 3,800+ models.
Every tool call gated by your approval. Local-first. Open source.

Quick Start • Features • 3,800+ Models • Commands • Troubleshooting

⭐ If FutureOS is useful to you, a star helps others find it.

Why FutureOS

• Trust before capability. Every tool call — read, write, edit, shell — is gated by your approval by default. Nothing writes to your filesystem or runs a command silently. When an agent holds your credentials, trust can't be a config option.
• One backend, every surface. A single gRPC agent drives the terminal UI, desktop app, mobile apps, CLI, and IM bots — same sessions, same memory, same skills, wherever you happen to be.
• Long runs need engineering, not prompting. The built-in loop control plane gives durable goals, event-sourced state, and verification gates to runs of 24+ hours — start a research task at night, review the results from your phone in the morning.

Features

Quick Start

Install

One line, no source build required:

macOS / Linux — one script, auto-detects the platform: macOS gets the official signed app (arm64 / Intel); Linux gets the .deb on Debian/Ubuntu (desktop app + unified future CLI) or the portable tarball everywhere else:

curl -fsSL https://dl.future-os.cn/install.sh | bash

Windows (PowerShell) — runs the signed installer silently:

iex (irm https://dl.future-os.cn/install.ps1)

Step-by-step installation for every platform (desktop app, toolchains, GUI packaging) is in the Build & Install guide.

Configure a model

The agent needs at least one model with an API key before it can answer.

FutureOS hosted models — device-flow sign-in provisions keys and a model list automatically:

future auth login

This works whether or not the agent is running: with the agent up the key is applied live; without it the key is written to ~/.future/agent/auth.json and picked up when the agent starts.

{
  "openai": { "type": "api_key", "key": "sk-..." }
}

{
  "azure": { "type": "api_key", "key": "sk-...", "baseUrl": "https://my-resource.openai.azure.com/openai/v1" }
}

{
  "providers": {
    "my-provider": {
      "apiKey": "sk-...",
      "baseUrl": "https://my-api.example.com/v1",
      "models": [
        { "id": "my-model", "name": "My Model", "contextWindow": 128000, "maxTokens": 16384 }
      ]
    }
  }
}

Install skills (optional)

Skills are add-on capability packs the agent picks up from ~/.future/agent/skills/. Browse the catalog and install what you need — this only needs network access, not a running agent:

future skills list             # browse the skill catalog
future skills install <name>   # install one skill
future skills install          # no name: install every built-in skill

Skip this and the agent still answers fine — skills just add ready-made workflows. uninstall / update and friends are in the CLI reference.

Run the agent

The terminal and CLI clients are thin gRPC clients. The agent must be running first, listening on 127.0.0.1:50051:

future agent     # start the agent in the terminal (logs to stdout; Ctrl-C to stop)

Then launch the terminal UI from the same future command:

future tui       # terminal UI

future <cmd> is the unified entry point for every Rust component: future agent, future tui, future channel, future loop. Each runs the same code as the standalone binary of the same name (the future-* binaries still exist as build targets — cargo build -p future-tui etc. — but are no longer installed by default).

A client that exits with a connection / gRPC error almost always means the agent isn't running yet — see Troubleshooting.

Essential Slash Commands (TUI)

Keyboard Shortcuts (TUI)

Troubleshooting

Community

💬 Discussions • 🐛 Issues • 🔒 Security • 📖 Wiki • Third-Party Notices