Skill

digitalocean

Agent-native CLI for DigitalOcean — droplet / database / load-balancer CRUD plus resource sync into a local SQLite store for offline inspection and repeatable agent workflows. Polls selected resources and emits change events as NDJSON. Compact JSON output, live/local source selection, group-by summaries. Destructive operations gated behind --yes.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use digitalocean

Choose if

You're managing DigitalOcean infrastructure from an agent loop and want a CLI with local SQLite sync (so repeat queries don't re-hit the API), NDJSON change-event streaming, group-by summaries, and a --yes gate on destructive ops. Prefer this over `doctl` when the workflow is agent-replayable or benefits from offline inventory queries.

Avoid if

You need to manage cloud surfaces beyond DigitalOcean (AWS / GCP / Azure) — this skill is DigitalOcean-scoped. Also avoid for one-shot interactive ops where doctl is already wired and the agent doesn't need offline inventory or change-event streaming.

Risk Flags

  • HIGH scope The CLI performs destructive operations (droplet delete, database delete, etc.) — README requires --yes for confirmation. Agents must wire the --yes gate carefully or risk irreversible teardown of production resources.
  • MEDIUM auth API credential is set via environment variable; tokens stored locally in the config. README does not document encryption-at- rest for the local config — agents must protect ~/.config/ contents like any other credential file.
  • LOW data_quality Local SQLite store is a snapshot; agents needing realtime state must use the live source selection or re-sync first. Stale reads against the local mirror are silent unless --live is passed.

Cost

Type: Usage based · Free tier: The CLI binary is MIT-licensed and free to install. DigitalOcean itself has limited free credits for new accounts but core droplet/database/LB usage is billed.

Hidden costs

  • The CLI is free; the upstream DigitalOcean API bills against your DigitalOcean account (droplets, databases, load balancers, egress).

Install

Default

npx -y @mvanhorn/printing-press install digitalocean
# Set the DigitalOcean API token (mandatory):
export DIGITALOCEAN_TOKEN=<your-token>

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+ (source install)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT