- 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.
Start here
Install the desktop and complete your first Agent task.
Core concepts
Understand how projects, workspaces, sessions, the authoritative runtime, and provider profiles fit together.
Install
Download a desktop installer, or prepare mobile and self-hosted environments.
Developer guide
Learn the architecture, build, tests, and Remote v2 contracts.
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
Quickstart
Install the desktop and complete your first session.
Changelog
See what each release adds, fixes, and changes internally.