# Atoi documentation

> Atoi is one agent for your apps, files, and computers. It asks before anything consequential and shows its work.

These guides cover the web app, the Apple and Android apps, and the terminal.

- [Complete documentation corpus](https://atoi.app/docs/llms-full.txt): Every public guide in one text response.
- [Documentation home](https://atoi.app/docs): Start from the six areas.

## Home

One workspace, one thread. Atoi posts here, asks here, and keeps everything it did here.

- [Atoi 101](https://atoi.app/docs/home/atoi-101.md): Your first useful session, start to finish.
- [Threads](https://atoi.app/docs/home/threads.md): Your one thread, what it keeps, how long work becomes a Task, and how a project scopes it.
- [Asks and approvals](https://atoi.app/docs/home/asks.md): See when Atoi asks for direction, requests approval, and stops at permanent safety gates.
- [Memory](https://atoi.app/docs/home/memory.md): What Atoi remembers about you, how it proposes new memories, and how to review or remove them.
- [Sharing and invites](https://atoi.app/docs/home/sharing.md) [preview]: Choose the right audience: one thread, your workspace, or a read-only public page.

## Work

Tasks, projects, computers, automations, and files: the work Atoi does for you, and where it runs.

- [Tasks](https://atoi.app/docs/work/tasks.md): Track long-running work by state, then inspect its result, changes, checks, and proof.
- [Projects](https://atoi.app/docs/work/projects.md): Give related threads one source of truth, shared instructions, documents, and tasks.
- [Computers](https://atoi.app/docs/work/computers.md) [preview]: Where Atoi runs work: Cloud, your own Mac, or another machine you connect.
- [Automations](https://atoi.app/docs/work/automations.md): Save a prompt, choose a schedule, and inspect every run.
- [Files and attachments](https://atoi.app/docs/work/files.md): Attach a supported file to a Thread, state its purpose, watch the upload and Task, then inspect the Receipt before sharing.

## Connect

Models, connections, channels, and plugins: what Atoi can reach and how it reaches you.

- [Models and keys](https://atoi.app/docs/connect/models.md): Connect a provider with your own key or subscription, enable models, and pick a default.
- [Connections](https://atoi.app/docs/connect/connections.md): Authorize services, MCP servers, and browser sessions for Atoi to use.
- [Channels](https://atoi.app/docs/connect/channels.md): Continue a thread on Telegram, answer simple asks there, and get updates in Slack.
- [MCP and plugins](https://atoi.app/docs/connect/mcp-and-plugins.md): Give Codex, Claude Code, Cursor, or Pi governed access to your projects and tasks, and install the Atoi plugin.

## Apps

Atoi on the web, on iPhone, iPad, and Mac, on Android, and in the terminal.

- [Web](https://atoi.app/docs/apps/web.md): Sign in to your thread, ask Atoi, answer an Ask, follow a Task, read its Receipt, and share the reviewed result.
- [iOS](https://atoi.app/docs/apps/ios.md): Sign in on iPhone or iPad, ask in a Thread, read Task proof, and hand unsupported actions to the web or terminal.
- [macOS](https://atoi.app/docs/apps/macos.md): Sign in on Mac, ask in a Thread, read Task proof, and use the Mac as a Computer for local work.
- [Android](https://atoi.app/docs/apps/android.md): Sign in on Android, ask in a Thread, inspect participants, and hand Task, Ask, Receipt, and sharing actions to the web or the terminal.
- [Terminal](https://atoi.app/docs/apps/terminal.md): Use `atoi` to sign in, ask in a Thread, answer an Ask, run a Task, read its Receipt, share from the TUI, and connect your Computer.

## Developers

Drive Atoi from a terminal or a coding client: the CLI, MCP, plugins, skills, and the models behind it.

- [Quickstart](https://atoi.app/docs/developers/quickstart.md): Install the CLI, sign in, check the bridge, and run one task with proof.
- [CLI](https://atoi.app/docs/developers/cli.md): Every command family in the atoi CLI, with the flags that keep consequential actions explicit.
- [Skills](https://atoi.app/docs/developers/skills.md): Teach Atoi how you want a kind of work done, and keep a skill separate from the connections it uses.
- [Tools](https://atoi.app/docs/developers/tools-and-capabilities.md): How Atoi decides which tool to use, and where its authority stops.
- [Providers](https://atoi.app/docs/developers/provider-matrix.md): The provider IDs Atoi recognizes, and how direct and routed access differ.
- [Model capabilities](https://atoi.app/docs/developers/model-capabilities.md): What to verify before you rely on a model for images, tools, long context, or media.
- [Set up the CLI](https://atoi.app/docs/developers/setup.md): Connect this machine to your account, then prove the connection works.
- [Account CLI reference](https://atoi.app/docs/developers/cli-account.md): Connect, inspect, and revoke the operator identity used by CLI and MCP requests.
- [Login CLI reference](https://atoi.app/docs/developers/cli-login.md): Pair the local Computer with Atoi.
- [Logout CLI reference](https://atoi.app/docs/developers/cli-logout.md): Disconnect the local Computer credential.
- [Connect CLI reference](https://atoi.app/docs/developers/cli-connect.md): Run the standalone bridge for the paired Computer.
- [Auth CLI reference](https://atoi.app/docs/developers/cli-auth.md): Connect, inspect, and revoke the provider credentials used by the paired Computer runtime.
- [Status CLI reference](https://atoi.app/docs/developers/cli-status.md): Read local configuration and readiness without calling the heartbeat.
- [Doctor CLI reference](https://atoi.app/docs/developers/cli-doctor.md): Run local readiness checks and an optional live heartbeat.
- [Settings CLI reference](https://atoi.app/docs/developers/cli-settings.md): List, inspect, and change settings through the shared registry contract.
- [Upgrade CLI reference](https://atoi.app/docs/developers/cli-upgrade.md): Check for a newer CLI release without changing the installation.
- [Version CLI reference](https://atoi.app/docs/developers/cli-version.md): Read the installed CLI version.
- [TUI CLI reference](https://atoi.app/docs/developers/cli-tui.md): Open the product terminal interface.
- [Run work from the terminal](https://atoi.app/docs/developers/cli-work.md): Create projects, send messages, launch tasks, and read what came back.
- [Project CLI reference](https://atoi.app/docs/developers/cli-project.md): Create Projects, attach source, inspect state, and manage the Project lifecycle.
- [Thread CLI reference](https://atoi.app/docs/developers/cli-thread.md): Resolve, read, message, steer, answer, and act on a Workspace Thread.
- [Task CLI reference](https://atoi.app/docs/developers/cli-task.md): Start, inspect, continue, cancel, apply, and publish proof-bearing Tasks.
- [Inbox CLI reference](https://atoi.app/docs/developers/cli-inbox.md): List and resolve durable approvals and decisions.
- [Search CLI reference](https://atoi.app/docs/developers/cli-search.md): Search the Atoi context you can access.
- [Computer CLI reference](https://atoi.app/docs/developers/cli-computer.md): Inspect placement targets, change their labels and policy, or open one in Atoi.
- [Memory CLI reference](https://atoi.app/docs/developers/cli-memory.md) [preview]: Inspect the paired-host memory recall contract before the full command is available.
- [Workspace CLI reference](https://atoi.app/docs/developers/cli-workspace.md): Read, attach, check, and inspect a Project's source, and clear a Workspace.
- [Automation CLI reference](https://atoi.app/docs/developers/cli-automation.md): Create and operate reusable manual or scheduled work.
- [Skill CLI reference](https://atoi.app/docs/developers/cli-skill.md): Inspect and manage account-level Skills with durable receipts.
- [Repo CLI reference](https://atoi.app/docs/developers/cli-repo.md): Discover the GitHub repositories a connection can reach and attach one to a Project.
- [Extend Atoi](https://atoi.app/docs/developers/extend.md): Add the channels, connections, MCP clients, and plugins Atoi can reach.
- [Channel CLI reference](https://atoi.app/docs/developers/cli-channel.md): Inspect, authorize, test, and revoke Atoi Channels.
- [Connector CLI reference](https://atoi.app/docs/developers/cli-connector.md): Inspect and manage browser-owned connections without accepting credentials in the CLI.
- [MCP CLI reference](https://atoi.app/docs/developers/cli-mcp.md): Inspect, configure, and run the authenticated MCP bridge.
- [Plugin CLI reference](https://atoi.app/docs/developers/cli-plugin.md): Install and manage the pinned first-party Atoi plugin pack.
- [MCP tools and configuration](https://atoi.app/docs/developers/reference.md): The governed MCP tool surface, and every configuration file, variable, and error code.
- [MCP tools reference](https://atoi.app/docs/developers/mcp-tools.md): Call all twelve governed Atoi MCP tools with source-backed arguments and result shapes.
- [CLI configuration reference](https://atoi.app/docs/developers/configuration.md): Configure Atoi CLI paths, endpoints, credentials, runtime overrides, installer behavior, and machine-readable errors.

## Account

Security, billing, shortcuts, fixes for common problems, the meaning of every product noun, and what changed.

- [Security and privacy](https://atoi.app/docs/account/security.md): How Atoi handles keys, permissions, sharing, execution data, and your account data.
- [Storage and billing](https://atoi.app/docs/account/billing.md): What Atoi stores, the limits that apply, and where to read your plan and usage.
- [Keyboard shortcuts](https://atoi.app/docs/account/shortcuts.md): The shortcuts you will use most in the web app, plus how Atoi handles focus, motion, and assistive technology.
- [Troubleshooting](https://atoi.app/docs/account/troubleshooting.md): Fix sign-in, model, connection, computer, task, and terminal problems, and file a report that gets acted on.
- [FAQ and glossary](https://atoi.app/docs/account/faq-and-glossary.md): Short answers to common questions and the meaning of every product noun.
- [Release notes](https://atoi.app/docs/account/release-notes.md): What changed in the Atoi app, from 1.0 on.