zeabur
CLI skills for deploying, managing, and troubleshooting services on Zeabur — a cloud deployment platform. Covers the full lifecycle: project
Open source Repository Open in the app JSON README (API)
About
CLI skills for deploying, managing, and troubleshooting services on Zeabur — a cloud deployment platform. Covers the full lifecycle: project creation, service deployment, template management, domain registration & DNS, server provisioning, environment variables, logs, and common issue diagnosis.
Details
- Kind
- Plugins
- Topic
- Cloud & DevOps
- Publisher
- zeabur
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 41
- Forks
- 9
- Open pull requests
- 6
- Last push
- 2026-07-24T05:53:47Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
zeabur/zeabur-claude-plugin/zeabur
README
# 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
```bash
# 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