Remove a marketplace

stable

Delete a registered marketplace and its plugin state from the local registry, by ID with a confirmation prompt or interactively from a picker.

Author: Poul Kjeldager
Usage: pks marketplace remove [ID] [options]
Category: infrastructure

Examples

$ pks marketplace remove my-marketplace

Remove by ID with a confirmation prompt

$ pks marketplace remove --yes

Pick interactively, then remove without confirming

pks marketplace remove deletes a marketplace entry, along with its plugin list and every enabled or disabled choice you made on it, from the local registry. The deletion is permanent — there is no undo and no backup copy.

1. Prerequisites

  • The marketplace ID, unless you want the interactive picker. Run pks marketplace list to find it.
  • An interactive terminal, unless you pass both an ID and --yes.

2. Remove by ID

pks marketplace remove my-marketplace

A confirmation prompt appears. It defaults to No, so pressing Enter cancels rather than confirms.

3. Remove interactively

Omit the ID and pks shows a selection list of every registered marketplace:

pks marketplace remove

Choose the entry, then confirm.

4. Remove without confirming

--yes skips the confirmation prompt:

pks marketplace remove my-marketplace --yes

--yes skips only the confirmation. Combined with no ID, the interactive picker still runs:

pks marketplace remove --yes

5. Verify

pks marketplace list

The entry is gone from the table.

6. Re-render Claude Code settings

Removing an entry changes what pks claude managed-settings produces, but does not itself update any Claude Code file. Re-render and redistribute:

pks claude managed-settings

Options

FlagDescription
--yesSkip the confirmation prompt.
ArgumentRequiredDescription
IDnoMarketplace ID to remove. Omit to pick interactively.

Troubleshooting

The command hangs in CI. Running without an ID falls through to an interactive selection prompt, which has no terminal to read from. In automation always pass both the ID and --yes.

Enter did nothing but the marketplace is still there. The confirmation prompt defaults to No. Answer yes explicitly, or pass --yes.

The plugin curation is gone. Removal deletes the entry's full plugin and enabled-state record. Re-adding the source registers a fresh entry with default state; the previous selection is not recoverable.

Removing the wrong entry. IDs are the marketplace name from the fetched document, or the --label override. Confirm against pks marketplace show <ID> before removing.

Next steps