What problem does it solve?
This Skill provides a guided, repeatable process to configure Hetzner cloud access for a new development workstation, eliminating manual setup and token misconfigurations.
Core Features & Use Cases
- Guided onboarding for setting up the Hetzner hcloud CLI context.
- Seamless direnv integration to load HCLOUD_TOKEN and keep environments isolated.
- Verified setup workflow including token retrieval prompts and SSH-key readiness.
- Use Case: A new developer can bootstrap their workstation in minutes, enabling immediate cloud operations and server management.
Quick Start
Step 1: Install prerequisites (hcloud, direnv, nix) if not already installed.
Step 2: Create hcloud context
- Run: hcloud context create workstation
- Enter your API token when prompted
- Get token from: https://console.hetzner.cloud → Project → Access → API Tokens → Generate (Read & Write)
Step 3: Allow direnv
- Navigate to your project directory
- Run: direnv allow
This loads HCLOUD_TOKEN from your hcloud CLI context.
Step 4: Verify setup
- Run: echo $HCLOUD_TOKEN | head -c 10
- Run: hcloud server list
Step 5: SSH Key Setup
- Run: hcloud ssh-key list
- If 'devbox' key is missing: hcloud ssh-key create --name devbox --public-key-from-file ~/.ssh/id_ed25519.pub