# Zortex documentation

> A practical handbook for using Vision and Indra, with or without an agent. All sections belong to the same product.

- [Vision overview](https://zortex.me/docs/vision)
- [Choose a workflow](https://zortex.me/docs/vision/experience-map.md)
- [Complete published handbook](https://zortex.me/docs/vision/handbook.md)
- [Version and integrity manifest](https://zortex.me/docs/manifest.json)

Each document is available as HTML and Markdown (.md). HTML routes also accept Accept: text/markdown. Read installed tool schemas for current capabilities. Scaffold pages describe documentation still being prepared.

## Overview

- [Vision documentation](https://zortex.me/docs/vision.md): Use your connected apps, local information, browser, and computer—with an agent or directly from the command line.
- [Get started](https://zortex.me/docs/vision/quickstart.md): Connect one app, read a small result, and check that you used the right source.
- [Install and open Vision](https://zortex.me/docs/vision/local-app.md): Install the command-line tools, reuse your data directory, and open the local connection and status pages.
- [Choose a workflow](https://zortex.me/docs/vision/experience-map.md): Start from the result you need and go directly to the guide that completes it.
- [Key concepts](https://zortex.me/docs/vision/key-concepts.md): Understand the few terms you need to connect apps, find information, and use tools.
- [About this handbook](https://zortex.me/docs/vision/agent-handbook.md): A practical manual for people and agents, with the same guidance available as web pages and Markdown.

## Tools

- [Using tools](https://zortex.me/docs/vision/tools.md): Find saved information, read current app data, and take actions through the terminal or your agent.
- [Find available tools](https://zortex.me/docs/vision/tools/discovery.md): List a source’s methods, inspect the one you need, and use its exact input schema.
- [Search saved information](https://zortex.me/docs/vision/tools/search.md): Query collected records in the local Vault and keep the evidence needed to use the results.
- [Read live data and verify sources](https://zortex.me/docs/vision/tools/read.md): Read current information from a connected app and check that the inspected material supports your answer.
- [Run an action](https://zortex.me/docs/vision/tools/actions.md): Read or change a connected app using the operation it actually exposes, then check the result.
- [Work with local files](https://zortex.me/docs/vision/tools/local-files.md): Find and read files within the folders your installed file connector can access.
- [Save and share results](https://zortex.me/docs/vision/tools/sharing.md): Keep a useful output or publish a fixed copy of selected context and files.

## Browser & computer

- [Browser and computer use](https://zortex.me/docs/vision/browser-computer.md): Choose a browser or desktop route, complete a task, and verify what changed.
- [Use a browser](https://zortex.me/docs/vision/browser-computer/browser-use.md): Open a page from the terminal, inspect its contents, act on current controls, and close the session.
- [Browser sessions and profiles](https://zortex.me/docs/vision/browser-computer/sessions.md): Choose the right browser context, reuse a live session, and recover without repeating completed actions.
- [Sign in and recover access](https://zortex.me/docs/vision/browser-computer/sign-in-and-recovery.md): Finish an existing app connection in the help page or its retained browser session, then verify access.
- [Use your computer](https://zortex.me/docs/vision/browser-computer/computer-use.md): Discover your installed desktop controls, inspect the right application, and invoke an operation through the CLI or agent.
- [Work in desktop apps](https://zortex.me/docs/vision/browser-computer/native-workflows.md): Take a document task from the correct application through a saved, inspected output.

## Autopilot

- [Autopilot](https://zortex.me/docs/vision/autopilot.md): Give your agent a task, follow its progress, and receive a result you can inspect.
- [Run your first task](https://zortex.me/docs/vision/autopilot/first-task.md): Find project decisions, read their evidence, and produce a useful summary with an agent or the terminal.
- [Plan and execute a task](https://zortex.me/docs/vision/autopilot/planning-and-execution.md): Turn the requested result into supported operations and adapt when the current route needs recovery.
- [Follow long-running work](https://zortex.me/docs/vision/autopilot/long-running-tasks.md): Inspect connection jobs and background progress, handle continuations, and use the controls available for the operation.
- [Continue work](https://zortex.me/docs/vision/autopilot/context-and-continuation.md): Save the task state a person or another agent needs, then resume from current observations.
- [Review and deliver results](https://zortex.me/docs/vision/autopilot/review-and-delivery.md): Check the requested outcome and return an artifact or changed state the reader can inspect.
- [Write a useful task brief](https://zortex.me/docs/vision/autopilot/task-design.md): Describe the outcome, scope, and completion evidence without having to prescribe every tool call.
- [Evaluate task results](https://zortex.me/docs/vision/autopilot/evaluation.md): Test a repeatable workflow against its intended outcome and record what the evidence actually establishes.
- [Work with an IDE agent](https://zortex.me/docs/vision/autopilot/ide-workflows.md): Use Indra for context and connected tools while your coding host owns the repository, edits, and checks.

## Connectors

- [Connectors](https://zortex.me/docs/vision/connectors.md): Connect your apps, check their available operations, and read or change the right information.
- [Connect an app](https://zortex.me/docs/vision/connectors/connect.md): Open connection help, complete an app's setup and sign-in, and check that its tools are ready.
- [Accounts and permissions](https://zortex.me/docs/vision/connectors/accounts.md): Select the right account and resource, understand access, and change a connection without losing context.
- [Coverage and freshness](https://zortex.me/docs/vision/connectors/coverage.md): Tell which account, records, time range, and current state a connector result actually covers.
- [Sync your sources](https://zortex.me/docs/vision/connectors/sync.md): Collect supported source records, inspect progress, and continue an incomplete pass.
- [Find supported apps](https://zortex.me/docs/vision/connectors/sources.md): Find a source on your installation and discover what it can actually do.
- [Recover a connection](https://zortex.me/docs/vision/connectors/recovery.md): Resume a failed or waiting connection using its current state and the live help page.

## CLI & MCP

- [CLI and MCP reference](https://zortex.me/docs/vision/reference.md): Use Vision from a terminal or an agent with the exact installed commands, tools, and result shapes.
- [CLI commands](https://zortex.me/docs/vision/reference/cli.md): Operate Vision from a terminal, select the existing Vault, and run product operations with JSON.
- [Set up MCP](https://zortex.me/docs/vision/reference/mcp-setup.md): Connect an agent host to the existing Vision installation and verify its tool connection.
- [MCP tools](https://zortex.me/docs/vision/reference/mcp-tools.md): Exact product tool names, arguments, and differences between local and remote connections.
- [Shared Actions](https://zortex.me/docs/vision/reference/actions.md): Arguments and follow-up steps for connection, sync, browser, and sharing operations.
- [SQL reference](https://zortex.me/docs/vision/reference/sql.md): Query retained records with bounded, parameterized SQL and understand the returned evidence.
- [Remote access](https://zortex.me/docs/vision/reference/remote-access.md): Connect another MCP client to your existing computer and manage the resulting access.

## Settings

- [Settings](https://zortex.me/docs/vision/settings.md): Control the existing installation, its sources, stored data, updates, and background work.
- [Vault and storage](https://zortex.me/docs/vision/settings/vault.md): Locate the existing collection, understand retained records, and preserve its identity across changes.
- [Permissions and source controls](https://zortex.me/docs/vision/settings/permissions.md): Control source enablement, startup, collection, and access without confusing them with data deletion.
- [Updates](https://zortex.me/docs/vision/settings/updates.md): Check an update offer, apply it to the existing installation, restart, and verify the loaded version.
- [Privacy and feedback](https://zortex.me/docs/vision/settings/privacy.md): Understand where task data goes, control optional telemetry, and distinguish local data from shared copies.
- [Troubleshooting](https://zortex.me/docs/vision/settings/troubleshooting.md): Identify the failing layer and recover a command, connection, read, or task without resetting healthy work.
- [Background host and reliability](https://zortex.me/docs/vision/settings/reliability.md): Start and stop the existing host, inspect ongoing work, and recover without duplicate operations.
