Deploy Your Agent

Deploy agents, skills, and commands from Claude Code or the web UI

Deploying an agent turns it into a cloud service that runs on webhooks, schedules, or manual triggers. Once deployed, your agent can create PRs, send notifications, and process data automatically.

Using Claude Code? Run /datagen:deploy-agent for a guided deployment workflow.

Push to GitHub

Your agent needs to be in a GitHub repository before deploying.

git add .claude/
git commit -m "Add agent definition"
git push origin main

If you don’t have a remote yet:

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/your-username/your-repo.git
git push -u origin main

---

Deploy from Claude Code

Run the deploy command inside Claude Code:

/datagen:deploy-agent

The plugin will:

1. Scan your agent’s dependencies (scripts, tools, secrets)
2. Connect your GitHub repo via the DataGen GitHub App
3. Push required secrets to DataGen
4. Create a webhook endpoint
5. Optionally set up cron schedules

After deployment, you get a webhook URL to trigger your agent externally.

---

Deploy from the Web UI

Step 1: Connect Your GitHub Repository

1. Go to the Agents Page

   Navigate to the Agents page in DataGen.

2. Click Connect Repository

   Click Connect Repository to start the setup.

   
3. Install GitHub App

   Click Install GitHub App and authorize DataGen to access your repositories.

4. Select Your Repository

   Choose the GitHub account/organization and select the repositories you want to connect.

Step 2: Deploy an Agent

DataGen automatically discovers agents, skills, and commands from your repository’s .claude/ directory.

1. Select Your Agent

   Click on the agent you want to deploy from the list.

   
2. Configure Secrets

   Select which secrets your agent needs. You need either an Anthropic API key or a Claude Code subscription token.

   Option A: Anthropic API Key — Add ANTHROPIC_API_KEY in DataGen Secrets.

   Option B: Claude Code Subscription (Recommended) — Run claude setup-token in your terminal, then add the token as CLAUDE_CODE_OAUTH_TOKEN in DataGen Secrets.

   
3. Configure Options

   • Create Pull Request — Enable if you want the agent to submit changes as PRs
   • Entry Prompt — Set a system-level instruction for every execution
4. Deploy

   Click Deploy Agent to create your deployment.

5. Copy Webhook URL

   After deployment, copy the webhook URL for external integrations.

   

---

After Deployment

Once deployed, your agent:

• Has a unique webhook URL for triggering via HTTP POST
• Appears in the Agents dashboard with run statistics
• Can be configured with schedules, channels, and additional secrets

Troubleshooting

Agent not appearing after connecting repo

Make sure your agent file is at .claude/agents/your-agent.md and has been pushed to the main branch.

Agent fails with API key error

Ensure you’ve configured the required secrets (Anthropic API key or Claude Code OAuth token) and selected them during deployment.

GitHub App not connecting

Verify you have admin access to the repository. Try disconnecting and reconnecting the repo.

Next Step

Monitor Agent Runs

View execution logs, tool calls, and agent output