FAQ
Frequently asked questions about Verun — setup, agents, licensing, and common usage scenarios.
Answers to the most common questions about Verun.
Do I need an account or subscription?
No. Verun requires no account, no subscription, and no sign-up. Download the app and start using it immediately. You only need an account with your chosen AI agent provider (e.g., Anthropic for Claude Code).
Does Verun send my code to any server?
No. Verun runs entirely on your machine. Your code, session history, and configuration never leave your device. When an AI agent runs, it communicates directly with its own API (e.g., Anthropic's API for Claude Code) — Verun does not intercept or relay this traffic. See Privacy & Licensing for details.
Which AI agents are supported?
Verun supports the following agent providers:
| Provider | Status |
|---|---|
| Claude Code (Anthropic) | Available |
| OpenAI Codex | Available |
| Google Gemini | Available |
| Cursor | Available |
| Local Models | Coming Soon |
See Agent Providers for details on each.
Can I use my existing Claude Code / Codex API key?
Yes. Verun uses the agent CLI you already have installed and authenticated. If Claude Code or Codex CLI is set up and working in your terminal, it will work in Verun without additional configuration. Verun does not manage API keys — each CLI handles its own authentication.
What is a "worktree" and why does Verun use them?
A git worktree is an isolated copy of your repository's working directory on a separate branch. Verun creates one worktree per task so that multiple agents can work in parallel without interfering with each other or with your main branch. See Parallel Agents for more.
Can I run Verun on Windows Subsystem for Linux (WSL)?
Yes. Verun supports WSL as a Linux environment. Install the Linux version of Verun inside your WSL distribution. Make sure your chosen agent CLI is also installed within WSL.
How many tasks can I run in parallel?
There is no fixed limit. The practical limit depends on your machine's resources — CPU cores, RAM, and disk I/O. Each task creates a separate worktree and runs its own agent process, so resource usage scales with the number of concurrent tasks.
How do I update Verun to a newer version?
Verun auto-updates after the first install. When a new version is available, the app downloads and applies the update on restart. You can also download the latest version manually from the GitHub Releases page.
Can I use Verun on a project that isn't a git repo?
No. Verun requires each project to be a git repository. Worktrees, branch isolation, and the diff viewer all depend on git. If your directory is not a git repo, initialize it first:
git init
git add .
git commit -m "initial commit"What happens to my changes if I delete a task?
Deleting a task removes the worktree and its branch. If you have uncommitted changes in the task's worktree, they will be lost. Before deleting a task, commit and push any changes you want to keep, or merge them into your main branch.
Is Verun free forever?
Verun is open-source software licensed under AGPL-3.0. The source code is freely available on GitHub. There are no plans for paid features or subscriptions. See Privacy & Licensing for license details.
Where can I report a bug or request a feature?
Open an issue on the GitHub repository. Please include your OS, Verun version, and steps to reproduce the issue.