Vista is a general-purpose agent for Linux, Windows, and macOS. Describe a goal in its browser interface and let the agent use files, shell commands, web queries, MCP tools, and skills to complete the work. Each open conversation has its own Worker process; conversations and their history are stored where Vista runs.
Download the archive for your system from GitHub Releases and extract it.
Linux, Windows, and macOS each provide x86-64 (amd64) and ARM64 (arm64) archives.
Run vista; on Windows, you can also double-click vista.exe. It starts the service in the background and opens the default browser. Opening it again uses the running instance. The browser opens http://127.0.0.1:5186/ by default, while the service listens on all IPv4 interfaces (0.0.0.0). Other devices use http://<host-IP>:5186/. Set the optional VISTA_HOST environment variable to a specific IPv4 address to restrict the listener; HTTPS is provided by a reverse proxy, not Vista itself.
On Windows, the running service has a notification-area icon. Click or double-click it to open Vista; right-click for Restart, Status, and Stop. Status opens a native window with service, conversation, process, memory, and build information. Stop removes the icon along with stopping the service.
Connect a model provider in Settings before sending the first message. Built-in connections provide their authentication and protocol settings; custom connections let you choose the conversation API format and authentication independently. Model availability follows the connected account or service.
| Command | Action |
|---|---|
vista / vista start |
Start the service or open the existing instance |
vista status |
Show service, conversation, Worker, and process status |
vista stop |
Stop the service and its managed work, keeping history |
vista restart |
Stop and start the service, keeping history |
Closing the browser does not stop work. Closing a conversation stops its Worker and managed background work, while retaining its history; deleting it also removes its associated data. Restarting Vista records unfinished operations as interrupted and does not replay their side effects.
About Vista provides service restart and port settings. Restart keeps conversations and the current port, then continues unfinished agent tasks from saved context; managed background processes stop. See service controls for details.
Building requires Go 1.26+, Node.js with native TypeScript support, npm, and Make. From the repository root:
make build
./bin/vista startmake build builds and embeds the frontend with version dev; use make build VERSION=v0.1.0 for a release version. Development rules are in AGENTS.md; build checks and test commands are in verification.
Settings manages service connections, model web access, MCP, global instructions, skills, and resource storage.
Configuration and conversations are stored under these directories, with runtime data in state/:
| Platform | Configuration root |
|---|---|
| Linux | $XDG_CONFIG_HOME/vista, or ~/.config/vista when unset |
| Windows | %APPDATA%/vista |
| macOS | ~/Library/Application Support/vista |
The directory includes settings, plaintext credentials, global AGENTS.md instructions, and skills. Keep it private. See configuration editing for file formats and upgrades, and configuration storage for technical contracts.
Conversations have no fixed working directory. Provide relevant paths in the task. Different conversations share the real filesystem: editing or withdrawing a message rolls back conversation context only, keeping file changes and other tool side effects.
Closing a conversation keeps its attachments. After deleting the last conversation that uses an attachment, its original file becomes eligible for manual cleanup in Settings. See resources.
Vista can compact long conversations automatically after a model reports a context limit, or manually while idle. See context compaction.
- Product scope and audience
- Architecture and runtime contracts
- Provider routing and model metadata
- Advanced configuration: network and proxies, prompt caching
- Worker and background process lifecycle
- Test goals and capacity measurement
- Benchmarks: setup and results
- Frontend, internationalization, and browser checks
- Context compaction, resources, and conversation rollback
Vista's original code and documentation are licensed under the MIT License. Third-party components retain their own licenses and copyrights; the complete license and attribution notices are included in distribution archives and available at /licenses on the running service.
