zeabur

Zeabur Agent Skills

Agent skills for Zeabur CLI operations, deployment, and troubleshooting. Works with Claude Code, OpenAI Codex, and other agents supporting the SKILL.md format.

Current version: 1.21.3

Installation

Claude Code

claude plugin marketplace add zeabur/agent-skills && claude plugin install zeabur@zeabur

Update to latest version:

claude plugin marketplace update zeabur && claude plugin update zeabur@zeabur

OpenAI Codex

In the Codex app, search for "Zeabur" in the plugin directory and click Add to Codex.

In the Codex CLI, run /plugins and select "Install plugin" to browse and install.

Local testing

# Claude Code
claude --plugin-dir /path/to/agent-skills

# Codex
codex --plugin-dir /path/to/agent-skills

Skills

| Skill | Description | Use When | |-------|-------------|----------| | zeabur-deployment-logs | View and filter service logs | Checking logs or seeing env-id required errors | | zeabur-domain-url | Handle service domain and URL configuration | Services need public URLs or trailing slash issues | | zeabur-migration | Resolve database migration blocking issues | Service stuck "Waiting for migrations" | | zeabur-port-mismatch | Fix proxy connection issues from port mismatches | Proxy shows dial tcp timeout or connection refused | | zeabur-project-create | Create new Zeabur projects | Creating a new project or deploying templates | | zeabur-restart | Restart individual services | Restarting services or --env-id required error | | zeabur-server-list | List, get, reboot, and SSH into dedicated servers | Checking server status, IP, rebooting, or SSH access | | zeabur-server-catalog | Browse available server providers/regions/plans | User asks what servers are available to rent | | zeabur-server-rent | Rent a new dedicated server, and install ZeaburOS on it | User wants to buy or provision a server, or make one able to host Zeabur projects | | zeabur-cluster-scale | Scale dedicated Kubernetes clusters (LKE/EKS) via node pools | User wants to add/remove nodes or resize a cluster | | zeabur-service-list | List all services and get service IDs | Needing service IDs or checking existing services | | zeabur-startup-order | Fix connection errors from startup order | Service fails with connection refused to database/redis | | zeabur-template | Template knowledge base for creating, validating, and troubleshooting | Creating or editing Zeabur template YAML, converting docker-compose | | zeabur-template-backup | Backup templates to git repository | Saving a template locally with standardized format | | zeabur-template-deploy | Deploy templates via CLI | Automating template deployments | | zeabur-update-service | Update service config without full redeploy | Modifying env vars or updating single service | | zeabur-deploy | Deploy local projects or from GitHub | User says "deploy this" or wants Git-based CI/CD deployment | | zeabur-variables | Manage environment variables via CLI | Managing env vars or handling empty variable issues | | zeabur-ai-hub | Manage AI Hub account, keys, balance, and usage | AI Hub status, API keys, add balance, usage, auto-recharge | | zeabur-email | Manage Zeabur Email (ZSend) service | Email domains, API keys, webhooks, ZSend | | zeabur-domain-register | Search, purchase, renew, and manage registered domains | Buying domains, checking availability, renewal | | zeabur-domain-dns | Manage DNS records for registered domains | Adding/updating/deleting DNS records | | zeabur-auth | Login, logout, and check auth status | User says "login", "登入", "logout", "登出" | | zeabur-domain-registrant | Manage registrant profiles for domain registration | Creating/updating contact info for domains |

Changelog

1.21.3

• Improved zeabur-domain-url — documented the WONDER_MESH_SERVER_REQUIRES_GATEWAY rejection for services on Wonder Mesh provider servers: stop retrying domain create, don't bind the domain to the app or gateway service directly, and send the user to the service's Domains tab in the Dashboard, which runs the gateway attach flow (binding to app-gateway in wonder-mesh-gateway-{wonderNetID})

1.21.2

• Improved zeabur-server-rent — the ZeaburOS install is now one copy-pasteable block (authenticate, install, wait) instead of three fragments an agent had to assemble, with jq parsing rather than grepping raw JSON

1.21.1

• Fixed zeabur-server-list and zeabur-server-ssh — Zeabur CLI 0.21.0 reports each server's OS, so the skills now read it directly instead of saying the CLI cannot report it (which sent agents SSHing into every machine to work it out)
• Improved zeabur-project-create — only offer servers running ZeaburOS as deploy targets

1.21.0

• Improved zeabur-server-rent — renting now asks which OS the user wants, and can install ZeaburOS on the machine afterwards (previously it could only point the user at the dashboard)
• Improved zeabur-server-ssh — check hasK3s up front to tell a ZeaburOS server from a plain Ubuntu one, instead of inferring it from a failed kubectl call
• Updated zeabur-server-list, zeabur-deploy, and zeabur-project-create to match

1.20.1

• Fixed zeabur-server-rent, zeabur-server-ssh, zeabur-server-list, zeabur-deploy, and zeabur-project-create — renting a server now provisions a standard VPS with no Zeabur services, so the skills no longer assume a rented server can host projects or that kubectl is present, and they explain how to convert a server to ZeaburOS

1.20.0

• Added zeabur-cluster-scale — list, scale, add, and remove node pools on dedicated Kubernetes clusters (LKE/EKS) via the GraphQL API, with explicit priced confirmation before every change

1.16.0

• Improved zeabur-email — added Send an Email section with REST API endpoint and usage examples
• Refactored all skills — inlined cross-skill references into relevant context, removed standalone "See Also" sections for better readability

1.15.0

• Added zeabur-auth — login, logout, and auth status check. Runs login directly so the CLI auto-opens the browser for the user

1.14.0

• Improved zeabur-deploy — emphasize saving service ID after first deploy to prevent duplicate services on redeploy
• Improved zeabur-template-deploy — added marketplace deploy via -c template code (no custom YAML needed)
• Fixed zeabur-server-catalog — corrected JSON example (uppercase provider codes, USD pricing, GB memory, egress field)

1.12.0

• Added zeabur-domain-register — search, purchase, renew, and manage registered domains (.com, .net, .org, .io, .dev, .app, .co, .me, .xyz)
• Added zeabur-domain-dns — full DNS record CRUD (list, create, update, delete) with domain-name-based lookup
• Added zeabur-domain-registrant — manage registrant profiles (contact info required for domain purchases)

1.11.2

• Updated zeabur-port-mismatch skill with CLI diagnostic commands (service network, service port-forward)

1.11.1

• Added post-deployment testing guide for TCP services in zeabur-template skill
• Clarified PORT_FORWARDED_HOSTNAME and PORT_FORWARDED_PORT variable descriptions

1.11.0

• Added zeabur-ai-hub — manage AI Hub tenant status, API keys, balance top-up, auto-recharge, and monthly usage
• Added zeabur-email — manage Zeabur Email (ZSend) domains, API keys, webhooks, and service status

1.10.0

• Add TCP service guide to zeabur-template skill: portForwarding, TCP port type, and when NOT to use HTTP/domainKey
• Add portForwarding field to template skeleton
• Add TCP vs HTTP rule to Critical Rules section

1.9.0

• Require asking user to pick server when creating project, not auto-selecting
• Removed --domain flag from deploy skill docs
• Strengthened project-create skill invocation: must invoke skill, not CLI directly

1.8.1

• Strengthen deploy skill to MUST invoke zeabur-project-create skill (not CLI directly) when creating a new project, whether or not projects already exist

1.8.0

• Deploy now only requires --project-id for non-interactive mode — --service-id is optional (omit to auto-create a new service)
• Removed -i=false from deploy examples — --json mode handles non-interactive automatically

1.7.0

• Removed --create and --region flags from deploy skill — redirect to zeabur-project-create instead
• Deprecated old region codes (hnd1, tpe1) — regions must now use server-<server-id> from server list
• Added --json flag to all CLI command examples across deploy and project-create skills

1.6.0

• Added CLI domain management guide (list, create, delete) with non-interactive flags
• Documented -g (generated) vs custom domain behavior and region-based suffixes
• Added deploy prerequisite: require project identification before deploy

1.5.0

• Added cross-references ("See also") to all 17 skills for better discoverability
• Refactored zeabur-template with progressive disclosure — moved database configs, complexity levels, and hard-won lessons to references/
• Standardized workflow section naming across all skills
• Fixed zeabur-template-deploy filename casing (skill.md → SKILL.md)

1.4.0

• Added zeabur-deploy — deploy local projects directly (zeabur deploy) or from GitHub (service deploy --template GIT)
• Supports both direct upload and Git-based deployment with auto-redeploy on push

1.3.0

• Removed zeabur-context skill — use direct --project-id instead
• Removed --env-id from all skills (now auto-resolved by CLI)
• Added Node.js install guidance to npx notice in all skills
• Dynamic server selection for project create & enforce npx zeabur@latest

1.2.0

• Updated zeabur-server-list — added SSH into servers with automatic password authentication

1.1.0

• Added zeabur-server-list — list, get, and reboot dedicated servers
• Added zeabur-server-catalog — browse available providers, regions, and plans with filters
• Added zeabur-server-rent — rent a new server with payment error guidance

1.0.0

• Initial release with service, project, template, and troubleshooting skills

License

MIT