pp-etherpad

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/etherpad/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/". -->

# Etherpad — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `etherpad-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 etherpad --cli-only
   ```
2. Verify: `etherpad-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/productivity/etherpad/cmd/etherpad-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.

## Command Reference

**anonymize-author** — Manage anonymize author

- `etherpad-pp-cli anonymize-author` — anonymizes an author across all their edits

**append-chat-message** — Manage append chat message

- `etherpad-pp-cli append-chat-message` — appends a chat message

**append-text** — Manage append text

- `etherpad-pp-cli append-text` — appends text to a pad

**check-token** — Manage check token

- `etherpad-pp-cli check-token` — returns ok when the current API token is valid

**compact-pad** — Manage compact pad

- `etherpad-pp-cli compact-pad` — compacts a pad's revision history, keeping recent revisions only

**copy-pad** — Manage copy pad

- `etherpad-pp-cli copy-pad` — copies a pad with full history and chat

**copy-pad-without-history** — Manage copy pad without history

- `etherpad-pp-cli copy-pad-without-history` — copies a pad without history or chat

**create-author** — Manage create author

- `etherpad-pp-cli create-author` — creates a new author

**create-author-if-not-exists-for** — Manage create author if not exists for

- `etherpad-pp-cli create-author-if-not-exists-for` — this functions helps you to map your application author ids to Etherpad author ids

**create-diff-html** — Manage create diff html

- `etherpad-pp-cli create-diff-html` — returns an HTML diff between two revisions of a pad

**create-group** — Manage create group

- `etherpad-pp-cli create-group` — creates a new group

**create-group-if-not-exists-for** — Manage create group if not exists for

- `etherpad-pp-cli create-group-if-not-exists-for` — this functions helps you to map your application group ids to Etherpad group ids

**create-group-pad** — Manage create group pad

- `etherpad-pp-cli create-group-pad` — creates a new pad in this group

**create-pad** — Manage create pad

- `etherpad-pp-cli create-pad` — creates a new (non-group) pad. Note that if you need to create a group Pad, you should call createGroupPad

**create-session** — Manage create session

- `etherpad-pp-cli create-session` — creates a new session. validUntil is an unix timestamp in seconds

**delete-group** — Manage delete group

- `etherpad-pp-cli delete-group` — deletes a group

**delete-pad** — Manage delete pad

- `etherpad-pp-cli delete-pad` — deletes a pad

**delete-session** — Manage delete session

- `etherpad-pp-cli delete-session` — deletes a session

**get-attribute-pool** — Manage get attribute pool

- `etherpad-pp-cli get-attribute-pool` — returns the attribute pool of a pad

**get-author-name** — Manage get author name

- `etherpad-pp-cli get-author-name` — Returns the Author Name of the author

**get-chat-head** — Manage get chat head

- `etherpad-pp-cli get-chat-head` — returns the chatHead (chat-message) of the pad

**get-chat-history** — Manage get chat history

- `etherpad-pp-cli get-chat-history` — returns the chat history

**get-html** — Manage get html

- `etherpad-pp-cli get-html` — returns the text of a pad formatted as HTML

**get-last-edited** — Manage get last edited

- `etherpad-pp-cli get-last-edited` — returns the timestamp of the last revision of the pad

**get-pad-id** — Manage get pad id

- `etherpad-pp-cli get-pad-id` — returns the read-write pad ID for a given read-only pad ID

**get-public-status** — Manage get public status

- `etherpad-pp-cli get-public-status` — return true of false

**get-read-only-id** — Manage get read only id

- `etherpad-pp-cli get-read-only-id` — returns the read only link of a pad

**get-revision-changeset** — Manage get revision changeset

- `etherpad-pp-cli get-revision-changeset` — returns the changeset at a given revision of a pad

**get-revisions-count** — Manage get revisions count

- `etherpad-pp-cli get-revisions-count` — returns the number of revisions of this pad

**get-saved-revisions-count** — Manage get saved revisions count

- `etherpad-pp-cli get-saved-revisions-count` — returns the number of saved revisions of a pad

**get-session-info** — Manage get session info

- `etherpad-pp-cli get-session-info` — returns information about a session

**get-stats** — Manage get stats

- `etherpad-pp-cli get-stats` — returns server-wide statistics

**get-text** — Manage get text

- `etherpad-pp-cli get-text` — returns the text of a pad

**list-all-groups** — Manage list all groups

- `etherpad-pp-cli list-all-groups` — returns the IDs of all groups on this server

**list-all-pads** — Manage list all pads

- `etherpad-pp-cli list-all-pads` — list all the pads

**list-authors-of-pad** — Manage list authors of pad

- `etherpad-pp-cli list-authors-of-pad` — returns an array of authors who contributed to this pad

**list-pads** — Manage list pads

- `etherpad-pp-cli list-pads` — returns all pads of this group

**list-pads-of-author** — Manage list pads of author

- `etherpad-pp-cli list-pads-of-author` — returns an array of all pads this author contributed to

**list-saved-revisions** — Manage list saved revisions

- `etherpad-pp-cli list-saved-revisions` — returns the list of saved revisions of a pad

**list-sessions-of-author** — Manage list sessions of author

- `etherpad-pp-cli list-sessions-of-author` — returns all sessions of an author

**list-sessions-of-group** — Manage list sessions of group

- `etherpad-pp-cli list-sessions-of-group` — returns all sessions of a group

**move-pad** — Manage move pad

- `etherpad-pp-cli move-pad` — moves a pad — copy then delete the original

**pad-users** — Manage pad users

- `etherpad-pp-cli pad-users` — returns the list of users that are currently editing this pad

**pad-users-count** — Manage pad users count

- `etherpad-pp-cli pad-users-count` — returns the number of user that are currently editing this pad

**restore-revision** — Manage restore revision

- `etherpad-pp-cli restore-revision` — restores a pad to a specific revision

**save-revision** — Manage save revision

- `etherpad-pp-cli save-revision` — saves a revision of a pad

**send-clients-message** — Manage send clients message

- `etherpad-pp-cli send-clients-message` — sends a custom message of type msg to the pad

**set-html** — Manage set html

- `etherpad-pp-cli set-html` — sets the text of a pad with HTML

**set-public-status** — Manage set public status

- `etherpad-pp-cli set-public-status` — sets a boolean for the public status of a pad

**set-text** — Manage set text

- `etherpad-pp-cli set-text` — sets the text of a pad


### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
etherpad-pp-cli which "<capability in your own words>"
```

`whic