About this project

FutureOS is an open-source AI agent platform built on a Rust core, designed to provide a unified agent experience across multiple interfaces: terminal UI (TUI), desktop app, mobile apps (Android & iOS), CLI, and IM bots. It emphasizes a single backend (gRPC) driving all surfaces, ensuring consistent sessions, memory, and skills. Key features include: - **Multi-Interface**: One agent accessible from TUI, GUI, mobile, CLI, and chat bots. - **Configurable Tool Safety**: Approval rules and OS sandboxing (macOS Seatbelt, Linux Bubblewrap, Windows restricted-token) for tools like read, write, edit, and shell. Tiers: off, manual, sandbox. - **Model Flexibility**: 3,800+ built-in models across 140+ providers, with support for custom providers via `models.json` and scoped model lists. - **Loop Engineering**: Durable goals, todos, gates, and monitors for long-horizon runs (24+ hours), with event-sourced state and verification gates. - **Built-in Skills**: 15+ skills for image handling, PDF/Word parsing, web search, browser control, slides, software install, and a `/future-loop` orchestrator. - **Forkable Sessions**: Branch conversations like a repo, with fork, clone, and tree navigation over JSONL history. - **Rust Core**: High performance and memory safety across all components. **Quick Start**: - Install via one-line script for macOS/Linux or PowerShell for Windows. - Configure a model using `future config` or `future auth login` for hosted models; BYOK and custom providers supported. - Optionally install skills with `future skills install`. - Run the agent with `future agent` and launch TUI with `future tui`. **Slash Commands (TUI)**: `/help`, `/model`, `/new`, `/sessions`, `/compact`, `/scoped-models`, `/clone`, `/fork`, `/tree`, `/name`, `/status`, `/stop`, `/cwd`, `/approve`, `/reject`, `/cancel`, `/reload`. **Keyboard Shortcuts**: `ctrl+p` (cycle model), `ctrl+t` (thinking level), `ctrl+o` (expand/collapse thinking), `ctrl+r` (browse sessions), `ctrl+c` (interrupt/exit), `tab` (autocomplete), `enter` (submit), `escape` (close popup), arrow keys (navigate). **Troubleshooting**: Use `future doctor` for connection issues; ensure model configuration with `future config`; refer to build/install guide for platform-specific problems. FutureOS is licensed under MIT + Apache-2.0 and is local-first, with community support via Discussions, Issues, and a Wiki.