Watch your coding agents without switching terminals. Each session becomes an animated 8-bit
vulture: see who is working, who finished and who needs you. Dictate into other apps, talk to
Zeca, and follow your GitHub work from the same desktop companion. Zeca is optional.
Features · Screenshots · Installation ·
Quick start · Support · Documentation
Release status: the latest published version is 0.1.8. This checkout includes
Unreleased work targeting 0.1.9, subject to desktop acceptance and release checks.
The feature map describes this checkout; consult the changelog for shipped changes.
Screenshots below are existing captures from earlier builds; navigation and spacing have since changed.
Features
| When you want to… | What Vults provides | Guide |
|---|
| Follow several agents at once | A bird per session, project species, working/finished/failed/waiting states, session details and live diffs | Flock |
| Handle interruptions from one place | Permission and question cards where supported, keyboard answers, exact Always rules, reviewed policies and an audit trail | Approvals |
| Return to the right terminal | Jump to a session's pane or window; continue supported sessions in Chat with an owned Stop action | Sessions and Chat |
| Speak instead of typing in another app | Local global dictation, copy by default, optional supported insertion routes, cancel and copy-last shortcuts | Dictation |
| Make dictation fit your vocabulary | Dictionary, snippets, spoken code, per-app choices, optional model cleanup and translation styles | Your words |
| Control the flock and playback by voice | Separate command key, searchable examples, a non-executing phrase check and opt-in selected-player playback, computer audio and installed-app opening; bounded local grammar, with desktop acceptance still pending | Voice commands |
| Find and manage what you dictated | Searchable local history, retention controls, usage statistics, microphone/model setup and diagnostics | Dictation history |
| Ask for help without leaving your desktop | Zeca Chat through an existing Claude Code/Codex CLI login, an API or a local model; Markdown, files, saved conversations and access choices |
Screenshots
Click a capture to open its original resolution. These illustrate individual workflows rather than
the final 0.1.9 layout. Fresh release captures are still pending.
Guide: the Nest. Earlier Room layout, including its former Tasks tab.
Guide: Chat access. Earlier compact Chat layout.
Guide: dictation. Statistics now live in the Dictation workspace.
Installation
Linux first. Download the .deb or .rpm from the
latest release.
Verify the archive with sha256sum -c SHA256SUMS --ignore-missing in your download folder.
KDE Plasma and other layer-shell compositors host the island at the screen edge; GNOME uses a
regular always-on-top window. Windows builds are previews; macOS work comes later.
Arch source packages are in packaging/aur/ and are not yet published to the AUR.
For dependencies, package verification and installation instructions, see Getting started.
To run the current development checkout, after installing the documented Linux dependencies:
git clone https://github.com/rogeriojunior31/Vults
cd Vults
npm install
npm run tauri dev
Coding-agent CLIs are installed separately. GitHub uses gh; local speech requires a checked model
download. API-backed chat, cleanup and voice features can incur provider charges.
Quick start
- Connect an agent. Open Set up agents… from the tray. Review its hook diff, then approve
the write. Vults keeps a dated backup and preserves third-party hooks. Codex also requires
trusting the installed hooks in its CLI.
- Start working. Run your agent as usual. Select its bird to inspect activity, changes and any
supported cards. Start in Mini; open Quick for a short interaction or Room for the Nest.
- Enable only what you need. Set up local speech under Dictation, choose a Chat provider,
or add a repository under Connections. The Nest's tabs are Flock, Chat, Dictation,
Connections and Activity; Chat is hidden when Zeca is off.
| Default shortcut on Linux | Action |
|---|
| Ctrl+Alt+Space | Open the island with keyboard focus |
| Ctrl+Alt+Y / Ctrl+Alt+N | Allow / deny the card in front |
| Hold Ctrl+Alt+V | Global dictation into copied text or an explicitly enabled destination |
| Ctrl+Alt+X | Cancel dictation or Chat voice |
| Ctrl+Alt+B | Copy the last successful dictation again |
| Hold Ctrl+Alt+Z | Voice command mode, separate from dictation |
| Ctrl+K, while Vults is focused | Open the command palette |
The Chat microphone records into Chat; Ctrl+Alt+V is global dictation. Insertion support depends
on the desktop and destination, and never submits a message automatically.
Support
Built-in integrations: Claude Code, Codex, Antigravity, OpenCode, Hermes Agent, Qwen Code, Copilot CLI, Cursor,
Factory Droid and Kimi Code. Watching a session, answering its cards and driving it are different
capabilities: some agents keep approvals in their own terminal. See the
per-agent capability table.
Specialist profiles currently run through Claude Code or Codex. Voice conversation uses its own
API setup and budget; Codex voice consultation is unavailable. GitHub workflows, voice routes and
new UI still have native acceptance gates in the active roadmap.
Safety and control
- Hooks fail open. On failure, the hook exits successfully without an answer, leaving the agent
to ask in its own terminal.
- You choose access. Cards are answered by a human, an exact Always rule, an accepted policy or
a signed paired-phone answer. Chat also respects the access you selected; destructive actions
still ask and policy denies/asks still apply. Zeca never answers flock approvals.
- Review config changes. Agent config writes require a dated backup, a diff and your click.
- Keep control of data. No telemetry; secrets stay in the OS keyring. Network features require
their own opt-in and use the network gate, budgets and local traces. Local transcription and
optional provider processing are separate choices. See Safety.
Documentation
Read the published documentation online.
It follows releases; guides in this checkout include development changes.
Contributing
Bug reports, agent integrations, connectors and documentation improvements are welcome. See
CONTRIBUTING.md, the Code of Conduct and
SECURITY.md for private vulnerability reports. Built with Rust and Tauri.
License
MIT. See LICENSE and third-party attributions in NOTICE.
