Teach Your Agent to
Deploy Your Code
Download the DeployHQ Skill and your agent learns to install the CLI, deploy, roll back, and manage your servers — all from a chat. Works with Claude (claude.ai and Claude Desktop) and OpenAI Codex. Takes 30 seconds to set up.
Last updated on 22nd June 2026
A skill is a small bundle of instructions your agent loads on demand. The DeployHQ Skill teaches your agent exactly how to drive the
dhq
command-line tool — how to authenticate, create deployments, watch progress, read logs, and roll back. Add it once and your agent can deploy for you in plain language, no copy-pasting commands.
Add It to Your Agent in 3 Steps
Pick your agent — Claude installs the skill via upload, Codex reads an AGENTS.md file.
Upload to Claude
In Claude, open
Settings → Capabilities → Skills
and choose
Upload skill.
Select the
.skill
file you downloaded, then enable it.
Deploy
Ask Claude to deploy. It installs and authenticates the CLI if needed, then runs the deployment for you.
Deploy my-app to production
Save to your repo
Save it as
AGENTS.md
in your repo root — or
~/.codex/AGENTS.md
to make it available globally. Prefer a one-liner? Run
dhq setup codex
in your repo instead.
Deploy
Codex reads the file automatically. Just ask it to deploy — it installs and authenticates the CLI if needed, then runs the deployment for you.
Deploy my-app to production
What the Skill Knows
Built from the same reference the DeployHQ CLI ships to coding agents.
Install & Authenticate
Walks your agent through installing the dhq binary and logging in — or using environment variables in CI — before it touches your infrastructure.
Deploy & Roll Back
Create deployments, watch them complete, read step logs when something breaks, and roll back to a previous release.
Projects & Servers
Create and configure projects, connect repositories, and manage SSH, FTP, and S3 deployment targets.
Config & Env Vars
Manage environment variables, config files, build commands, exclusions, and deployment checks.
JSON for Agents
Every command returns structured JSON with suggested next steps, so your agent never has to guess an endpoint.
Full API Escape Hatch
When a command doesn't exist, the skill knows how to call any of the 144+ DeployHQ API endpoints directly.
Using Claude Code, Cursor, or Windsurf Instead?
The tabs above cover Claude and Codex. If you work in another terminal-based coding agent, the CLI sets you up directly.
Run the setup command inside your repo and the DeployHQ CLI installs the right integration for your agent automatically — a skill for Claude Code, a project rule for Cursor, or a Windsurf integration.
dhq setup claude
dhq setup cursor # or: windsurf
Frequently Asked Questions
What is the DeployHQ Agent Skill?
It's a downloadable bundle of instructions your AI agent loads when it's relevant. It teaches the agent how to use the dhq command-line tool to deploy code, manage servers, and roll back releases. We ship two builds: a .skill bundle for Claude and an AGENTS.md file for OpenAI Codex.
Do I need a paid plan?
Claude Skills are available on claude.ai and the Claude Desktop app, and Codex reads the AGENTS.md file from your repo. You don't need a DeployHQ account just to install the skill, but you'll need one (free plans available) to actually deploy.
How do I install it?
For Claude: download the .skill file, then go to Settings → Capabilities → Skills and upload it. For Codex: download the AGENTS.md file and save it in your repo root (or ~/.codex/AGENTS.md for global), or run `dhq setup codex` in your repo — Codex reads it automatically.
Does this work with Claude Code, Cursor, or Windsurf?
Yes. Those terminal-based agents have a better path: run `dhq setup claude` (or cursor, windsurf) inside your project and the skill is installed directly into the agent's config. The downloadable skill here is aimed at chatting with Claude on claude.ai or Desktop, or running OpenAI Codex.
Is it safe?
The skill only contains instructions and reference docs — no secrets. It tells your agent how to use the dhq CLI, which uses your own DeployHQ credentials stored locally on your machine or in your CI environment.
Is it free?
Yes. The skill and the DeployHQ CLI are free. You need a DeployHQ account to deploy — free plans are available.
Let your agent handle the deploy
Download the skill, add it to your agent, and ship from a conversation.
Free to install • Works with Claude & Codex
Explore More Features
Discover all the tools that make DeployHQ the easiest way to deploy your code.
Zero Downtime Deployments
→One-Click Rollback
→Turbo Deployments
→Build Pipelines
→Build Cache
→Scheduled Deployments
→Deployment Availability
→Docker Builds
→Deployment Checks
→Deployment Targets
→Automatic Deployment
→Deployment Templates
→Deploy Behind Firewalls
→SSH Deployment
→Deployment Zones
→Team & Permissions
→Single Sign-On
→Custom Actions
→Server Management
→CLI & Agents
→Powerful Integrations
→Get started today for just $9/month
That's unlimited deployments and 3 projects.