Cloud Agent Setup
Set up Cloud Agents to run long, complex tasks on Vyre's secure infrastructure while you're offline. This guide walks you through connecting your repository and running your first cloud agent.
Cloud Agents require a Vyre Pro or Enterprise subscription. Start a free trial at vyre.dev/pricing.
Prerequisites
Before setting up Cloud Agents, ensure you have:
- A Vyre Pro or Enterprise account
- A GitHub, GitLab, or Bitbucket repository connected to Vyre
- Admin access to the repository (for webhook configuration)
Connecting your repository
Open Cloud Settings
Go to Settings → Cloud Agents → Repositories and click "Add Repository."
Select your repository
Choose from the list of repositories connected via your GitHub/GitLab integration. If your repo isn't listed, first connect your GitHub account in Settings → Integrations → GitHub.
Configure the clone environment
Set the Node.js/Python version, environment variables (as secrets), and any setup scripts that should run before the agent starts.
{
"runtime": "node-20",
"setup": "npm install",
"secrets": ["DATABASE_URL", "API_KEY"],
"branch": "main"
}Test the connection
Click "Test Setup." Vyre will clone your repo in a temporary environment, run your setup script, and report success or failure. Fix any setup errors before proceeding.
Running your first cloud agent
Start a new agent session
In the Agents Window, click "New Agent" and toggle the "Run in Cloud" switch in the top-right corner. The icon changes to a cloud symbol.
Enter your task
Enter a task description as you would for a local agent. For cloud agents, longer and more complex tasks are ideal — the whole point is to offload heavyweight work.
Refactor all API routes in src/app/api/ to use the new
validation middleware. Run the test suite after each file
to verify no regressions. Open a PR when complete.Monitor progress
The agent status card in the Agents Window shows real-time progress. You can safely close your laptop — the agent continues running in the cloud and will notify you when it's done.
Configuration
Environment variables
Store secrets for your cloud agents in Settings → Cloud Agents → Secrets. Secrets are encrypted at rest and injected as environment variables when the agent runs. They never appear in logs.
Resource limits
Configure CPU and memory limits per cloud agent run. Larger limits support more parallelism and faster test suites. Resource usage is tracked toward your plan's monthly allotment.
- Starter: 2 vCPU, 4GB RAM per run
- Pro: 8 vCPU, 16GB RAM per run
- Enterprise: Custom limits available
Notifications
Configure where you receive notifications when a cloud agent finishes:
- Slack (if connected)
- Push notification to the Vyre mobile app
- Webhook to a custom URL