# 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://docs.atoi.app/llms-full.txt): Every public guide in one text response.
- [Documentation home](https://docs.atoi.app/): Start from the five sections.

## Introduction

What Atoi is, how a session works, and where to start.

- [Overview](https://docs.atoi.app/introduction/overview.md): How a session with Atoi works, what Library is for, and how to read a result.
- [Atoi 101](https://docs.atoi.app/introduction/atoi-101.md): Your first useful session, start to finish.
- [Library](https://docs.atoi.app/introduction/library.md): The signed-in home that organizes itself around your work.
- [Keyboard shortcuts](https://docs.atoi.app/introduction/keyboard-and-accessibility.md): The shortcuts you will use most in the web app, plus how Atoi handles focus, motion, and assistive technology.
- [Troubleshooting](https://docs.atoi.app/introduction/troubleshooting.md): Fix sign-in, model, connection, computer, task, and terminal problems, and file a report that gets acted on.
- [FAQ and glossary](https://docs.atoi.app/introduction/faq-and-glossary.md): Short answers to common questions and the meaning of every product noun.

## Core

Threads, projects, tasks, asks, computers, memory, models, sharing, and your data.

- [Threads](https://docs.atoi.app/core/threads.md): Start a thread, keep its history in one place, and file it in a project when it helps.
- [Projects](https://docs.atoi.app/core/projects.md): Give related threads one source of truth, shared instructions, documents, and tasks.
- [Tasks](https://docs.atoi.app/core/tasks.md): Follow long running work by its state, then read the receipt: result, changes, checks, and proof.
- [Asks and approvals](https://docs.atoi.app/core/asks-approvals-safety.md): When Atoi stops to ask, when it asks for permission, and the actions it will never take on its own.
- [Computers](https://docs.atoi.app/core/computers.md) [preview]: Where Atoi runs work: Cloud, your own Mac, or another machine you connect.
- [Memory](https://docs.atoi.app/core/memory-and-personalization.md): What Atoi remembers about you, how it proposes new memories, and how to review or remove them.
- [Models and keys](https://docs.atoi.app/core/models-and-keys.md): Connect a provider with your own key or subscription, enable models, and pick a default.
- [Sharing and invites](https://docs.atoi.app/core/sharing.md) [preview]: Invite a person into a thread, add a member to your workspace, or publish a read only page. Three actions, three audiences.
- [Security and privacy](https://docs.atoi.app/core/security-privacy-data.md): How Atoi handles keys, permissions, sharing, execution data, and your account data.
- [Storage and billing](https://docs.atoi.app/core/storage-and-billing.md): What Atoi stores, what the limits are, and where to read your plan and usage.

## Surfaces

How Atoi's clients are designed to converge, with the verified record set for each one.

- [Web](https://docs.atoi.app/surfaces/web.md): Sign in on the web, ask Atoi, answer an Ask, follow a Task, read its Receipt, and share the result.
- [iOS and macOS](https://docs.atoi.app/surfaces/ios-and-macos.md): Open Atoi on iPhone, iPad, or Mac, ask in a Thread, read Task proof, and continue unsupported actions on the web or in the terminal.
- [Android](https://docs.atoi.app/surfaces/android.md): Sign in on Android, ask in a Thread, inspect group participants, and continue Task, Ask, Receipt, and sharing actions on a verified surface.
- [Terminal](https://docs.atoi.app/surfaces/terminal.md): Sign in with `atoi`, ask in a Thread, answer an Ask, run a Task, read its Receipt, share from the TUI, and connect your Computer.
- [Files and attachments](https://docs.atoi.app/surfaces/file-support-and-storage.md): Choose a supported file, attach it to a Thread, tell Atoi how to use it, follow the work, and check the Receipt before you share.
- [Sharing checklist](https://docs.atoi.app/surfaces/shared-links-and-permissions.md) [preview]: Finish the work, review the Thread and Receipt, choose private participation or a public copy, test the link, and revoke the exact access you granted.

## Ambient

Connections to your services, channels that continue a thread, and automations that run on a schedule.

- [Connections](https://docs.atoi.app/ambient/connections.md): Authorize Atoi to use GitHub, Google Workspace, Linear, Slack, an MCP server, or one of your browser sessions.
- [Channels](https://docs.atoi.app/ambient/channels.md): Continue a thread on Telegram, answer simple asks there, and get updates in Slack.
- [Automations](https://docs.atoi.app/ambient/automations.md): Save a prompt, give it a schedule and a project, and read every run.
- [Release notes](https://docs.atoi.app/ambient/release-notes.md): What changed in Atoi, by date.

## Developers

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

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