pp-digitalocean

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/cloud/digitalocean/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Digitalocean — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `digitalocean-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install digitalocean --cli-only
   ```
2. Verify: `digitalocean-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds
- **`workflow archive`** — Sync DigitalOcean resources into a local SQLite store for offline inspection and repeatable agent workflows.

  _Gives agents a durable local inventory before planning cloud changes._

  ```bash
  digitalocean-pp-cli workflow archive --full --json
  ```
- **`search`** — Search synced DigitalOcean data locally, with live/local source selection for agent-friendly retrieval.

  _Lets agents locate relevant resources before choosing a narrower command._

  ```bash
  digitalocean-pp-cli search "production" --data-source local --json --limit 20
  ```

### Operational summaries
- **`analytics`** — Summarize locally synced resource data with count and group-by operations.

  _Turns resource listings into operational summaries an agent can reason about._

  ```bash
  digitalocean-pp-cli analytics --type droplets --group-by region --json
  ```
- **`tail`** — Poll selected resources and emit change events as NDJSON for shell and agent pipelines.

  _Provides a safe one-shot or continuous change feed without bespoke scripts._

  ```bash
  digitalocean-pp-cli tail --resource droplets --interval 30s --json
  ```

## Command Reference

**1-clicks** — Manage 1 clicks

- `digitalocean-pp-cli 1-clicks create` — Create
- `digitalocean-pp-cli 1-clicks list` — List

**account** — Provides information about your current account.

- `digitalocean-pp-cli account create` — Create
- `digitalocean-pp-cli account delete` — Delete
- `digitalocean-pp-cli account get` — Get
- `digitalocean-pp-cli account list` — List
- `digitalocean-pp-cli account list-keys` — List keys
- `digitalocean-pp-cli account update` — Update

**actions** — Actions are records of events that have occurred on the resources in your account.
These can be things like rebooting a Droplet, or transferring an image to a new region.

An action object is created every time one of these actions is initiated. The action
object contains information about the current status of the action, start and complete
timestamps, and the associated resource type and ID.

Every action that creates an action object is available through this endpoint. Completed
actions are not removed from this list and are always available for querying.

**Note:** You can pass the following HTTP header with the request to have the API return
the `reserved_ips` stanza instead of the `floating_ips` stanza:

- `Accept: application/vnd.digitalocean.reserveip+json`

- `digitalocean-pp-cli actions get` — Get
- `digitalocean-pp-cli actions list` — List

**add-ons** — Add-ons are third-party applications that can be added to your DigitalOcean account.
They are available through the [DigitalOcean Marketplace](https://marketplace.digitalocean.com/).
Add-ons can be used to enhance the functionality of your existing resources or to provide
additional services.

The Add-Ons API allows you to manage these resources, including creating, listing, and retrieving
details about specific add-on resources.

- `digitalocean-pp-cli add-ons create` — Create
- `digitalocean-pp-cli add-ons delete` — Delete
- `digitalocean-pp-cli add-ons get` — Get
- `digitalocean-pp-cli add-ons get-addons` — Get addons
- `digitalocean-pp-cli add-ons list` — List
- `digitalocean-pp-cli add-ons list-addons` — List addons
- `digitalocean-pp-cli add-ons update` — Update
- `digitalocean-pp-cli add-ons update-addons` — Update addons

**apps** — App Platform is a Platform-as-a-Service (PaaS) offering from DigitalOcean that allows
developers to publish code directly to DigitalOcean servers without worrying about the
underlying infrastructure.

Most API operations are centered around a few core object types. Following are the
definitions of these types. These definitions will be omitted from the operation-specific
documentation.

For documentation on app specifications (`AppSpec` objects), please refer to the
[product documentation](https://docs.digitalocean.com/products/app-platform/reference/app-spec/)).

- `digitalocean-pp-cli apps create` — Create
- `digitalocean-pp-cli apps create-metrics` — Create metrics
- `digitalocean-pp-cli apps create-propose` — Create propose
- `digitalocean-pp-cli apps delete` — Delete
- `digitalocean-pp-cli apps get` — Get
- `digitalocean-pp-cli apps get-tiers` — Get tiers
- `digitalocean-pp-cli apps list` — List
- `digitalocean-pp-cli apps list-regions` — List regions
- `digitalocean-pp-cli apps list-tiers` — List tiers
- `digitalocean-pp-cli apps update` — Update

**async-invoke** — Manage async invoke

- `digitalocean-pp-cli async-invoke` — Create

**batches** — Manage batches

- `digitalocean-pp-cli batches create` — Create
- `digitalocean-pp-cli batches create-files` — Create files
- `digitalocean-pp-cli batches get` — Get
- `digitalocean-pp-cli batches list` — List

**billing** — The billing endpoints allow you to retrieve your account balance, invoices,
billing history, and insights.

**Balance:** By sending requests to the `/v2/customers/my/balance` endpoint, you can
retrieve the balance information for the requested customer account.

**Invoices:** [Invoices](https://docs.digitalocean.com/platform/billing/invoices/)
are generated on the first of each month for every DigitalOcean
customer. An invoice preview is generated daily, which can be accessed
with the `preview` keyword in place of `$INVOICE_UUID`. To interact with
invoices, you will generally send requests to the invoices endpoint at
`/v2/customers/my/invoices`.

**Billing History:** Billing history is a record of billing events for your account.
For example, entries may include events like payments made, invoices
issued, or credits granted. To interact with invoices, you
will generally send requests to the invoices endpoint at
`/v2/customers/my/billing_history`.

**Billing Insights:** Day-over-day changes in billing resource usage based on nightly invoice items,
including total amount, region, SKU, and description for a specified date range.
It is important to note that the daily resource usage may not reflect month-end billing totals when totaled for
a given month as nightly invoice items do not necessarily encompass all invoicing factors for the entire month.
  `v2/billing/{account_urn}/insights/{start_date}/{end_date}` where account_urn is the URN of the customer
account, can be a team (do:team:uuid) or an organization (do:teamgroup:uuid). The date range specified by
start_date and end_date must be in YYYY-MM-DD format.


**byoip-prefixe