> ## Documentation Index
> Fetch the complete documentation index at: https://vibex.peatboy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vibex documentation

> A guide to the local-first Vibex AI coding workbench, for users and developers.

Vibex puts Agent sessions, workspace files, the editor, Git, terminals, and previews into one native workbench. You can ask an Agent to change code, then inspect the plan, tool calls, and diff, and finally run and deliver the change from the same workspace.

Vibex is built around an **authoritative runtime plus typed projections**:

* The **authoritative runtime** owns Agent processes, session timelines, workspace files, Git, terminals, and provider credentials. It comes in two forms with identical capabilities:
  * The **local runtime embedded in the desktop** (the default).
  * The **headless runtime `vibex-server`**, running on your own server or home machine.
* **Clients** are the desktop workbench and the iOS / Android mobile apps. They render the projections sent by the authoritative runtime and send typed operations. Mobile does not run Agents locally and does not keep a second copy of the workspace.

In other words, the desktop can either **act as the authoritative runtime itself** or **connect to a remote authoritative runtime**. See [Remote access and mobile](/docs/en/remote-mobile) and [Self-hosted headless runtime](/docs/en/self-hosted-server).

<Columns>
  <Card title="Start here" icon="rocket" href="/docs/en/quickstart">
    Install the desktop and complete your first Agent task.
  </Card>

  <Card title="Core concepts" icon="book-open" href="/docs/en/concepts">
    Understand how projects, workspaces, sessions, the authoritative runtime, and provider profiles fit together.
  </Card>

  <Card title="Install" icon="download" href="/docs/en/install">
    Download a desktop installer, or prepare mobile and self-hosted environments.
  </Card>

  <Card title="Developer guide" icon="code" href="/docs/en/developer">
    Learn the architecture, build, tests, and Remote v2 contracts.
  </Card>
</Columns>

## What you can do with Vibex

* Follow Markdown replies, reasoning, plans, tool calls, process details, attachments, approvals, and elicitation forms in a structured timeline.
* Organize Composer input with `/` commands, `@` file references, `$` Skills, and attachments.
* Let Vibex download, upgrade, and uninstall supported Agent runtimes for you.
* Search, edit, save, rename, and preview files in the file tree and editor.
* Review Git status, diffs, history, and blame; create branches and commit or push changes; run several tasks in parallel with isolated Git worktrees.
* Run project commands in multiple terminal tabs on a native PTY with ANSI emulation.
* Configure Agents, model providers, MCP, and Skills.
* Filter usage by time, Agent, provider, model, project, and session, and tell complete, derived, partial, and unknown data apart.
* Search across every session and message body.
* Pair a desktop session securely with mobile to follow progress, answer questions, and handle approvals on your phone.
* Pair the desktop or mobile with a self-hosted headless runtime and continue the same sessions from any device.

## Next steps

<Card title="Quickstart" icon="arrow-right" href="/docs/en/quickstart">
  Install the desktop and complete your first session.
</Card>

<Card title="Changelog" icon="list" href="/docs/en/changelog">
  See what each release adds, fixes, and changes internally.
</Card>