How It Works
When a user @mentions or assigns the agent on a Linear issue, the agent claims it instantly, launches a workspace, writes the code, opens a pull request, and shuts down. Progress is streamed back to Linear in real time.Agents vs Workspaces
Autonomous agents and workspaces share the same underlying infrastructure but serve different workflows.| Workspaces | Autonomous Agents | |
|---|---|---|
| Trigger | Human clicks “Create” | Agent @mentioned or assigned on issue |
| Interaction | Human works in browser | AI agent runs autonomously |
| Output | Running application | Pull request |
| Lifecycle | Manual start/stop | Auto-launch, auto-stop on completion |
| Blueprint type | Workspace Blueprint | Agent Blueprint |
| Admin view | Workspace Management | Agents Dashboard & Runs |
Supported Runtimes
Each agent blueprint specifies which AI coding runtime to use. The runtime determines the CLI tool that drives the agent inside the workspace.Claude Code
Anthropic’s coding agent. Runs
claude -p with the issue description as the prompt.OpenCode
Open-source coding agent. Runs
opencode run to process the issue autonomously.Codex
OpenAI’s coding agent. Runs
codex --full-auto for fully autonomous operation.Gemini CLI
Google’s coding agent. Runs
gemini -p with the issue context as input.Cursor CLI
Cursor’s agent mode. Runs
cursor-agent to resolve the issue.Shared Infrastructure
Autonomous agents run on the same Kubernetes cluster as workspaces. They use the same split architecture - the portal orchestrates agent runs fromrde.qovery.com, while the agent containers execute on your infrastructure. The same security model applies: no inbound ports, outbound-only TLS/gRPC tunnels, and all code stays on your cluster.
For details on the underlying infrastructure, see Architecture and Security & Data Residency.
Supported Project Trackers
Linear is the currently supported project tracker. You connect your Linear workspace via OAuth, and your team triggers agents by @mentioning or assigning them on issues. The agent responds instantly with a real-time plan and progress updates visible directly in Linear.Jira and GitHub Issues integrations are planned. If you need a specific integration, contact the Qovery team.
Next Steps
Getting Started
Set up your first autonomous agent with Linear integration.
Agent Blueprints
Configure blueprints that define how agents run.
Managing Runs
Monitor agent runs, review results, and troubleshoot failures.
Linear Integration
Connect Linear, configure labels, and manage issue routing.