Plugin commands reference changedplugins/cli-reference
Nearest release: v2.1.294, published an hour after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 8 Oct 2026 02:24 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 8 Oct 2026 03:07 UTC.
Upstream edited
Recorded here
Lines+25added
Lines−6removed
From line
66
where the diff opens
First seen
25 Sep 2026
this site's first read of the page
Recorded edits15to this page, all time
#### JSON result for marketplace commands
The whole hunk
from line 66, old and new numbered
/
from line 66
6666
6767### plugin install
6868
69Install a plugin from a marketplace you've added. `i` is an alias for `install`.
69Install a plugin from one of your marketplaces. `i` is an alias for `install`.
7070
7171```bash theme={null}
7272claude plugin install <plugin> [options]
from line 119
119119
120120A usage error, such as an invalid `--scope`, prints no result line and exits `1` with the reason on stderr.
121121
122#### JSON result for marketplace commands
123
124On `plugin marketplace add`, `plugin marketplace remove`, and `plugin marketplace update`, `--json` prints one JSON object on the last line of stdout with `command`, `outcome`, and `message` fields. The following is the result of `claude plugin marketplace remove your-marketplace --json`:
125
126```json theme={null}
127{"command":"marketplace-remove","outcome":"ok","marketplace":"your-marketplace","message":"Successfully removed marketplace: your-marketplace"}
128```
129
130The `command` value is `marketplace-add`, `marketplace-remove`, or `marketplace-update`. The fields below appear only when they apply:
131
132* `marketplace`: the name of the marketplace the command acted on
133* `failureCode`: a code for why the command failed, such as `invalid_source`
134
135`plugin marketplace add` and `plugin marketplace remove` can print no result line when the argument is the [reserved name](/docs/en/plugins/marketplace-reference#reserved-names) `anthropic-plugin-directory`, so check the exit code for that name.
136
122137#### Accept a displayed install command
123138
124139When a `--json` run displays a marketplace-declared command and doesn't run it, the `failed` result also carries a `shownCommand` object. Its fields include the command as displayed, the plugin it belongs to, and the command's `sha256`.
from line 663
648663| `--scope <scope>` | Settings file to declare the marketplace in: `user`, `project`, or `local`. Defaults to `user` |
649664| `--sparse <paths...>` | Limit the git checkout to these directories, for monorepos. `github` and `git` sources only |
650665| `--claudeai` | Read the argument as the name of a [marketplace hosted on claude.ai](/docs/en/plugins/install#add-from-claude-ai) instead of a source. Requires Claude Code v2.1.273 or later |
666| `--json` | Print whether the command succeeded, and its message, as one JSON object on the last line of stdout, in the [JSON result format](#plugin-json-result). Has no effect with `--claudeai`. Requires Claude Code v2.1.287 or later |
651667
652668`<source>` takes any of the forms in the table below, and its form decides the source type and how Claude Code fetches the marketplace. For the resulting source object, see the [marketplace reference](/docs/en/plugins/marketplace-reference).
653669
from line 754
738754| Flag | Description |
739755| :- | :- |
740756| `--scope <scope>` | Remove the declaration from one settings scope: `user`, `project`, or `local`. Without it, Claude Code removes the declaration from every scope |
757| `--json` | Print whether the command succeeded, and its message, as one JSON object on the last line of stdout, in the [JSON result format](#plugin-json-result). Requires Claude Code v2.1.287 or later |
741758
742759Remove a marketplace from every scope:
743760
from line 771
754771Refresh one marketplace, or every marketplace, from its source to fetch new plugins and versions. A marketplace added with a branch or tag `ref` updates to the latest commit of that ref, not the repository's default branch.
755772
756773```bash theme={null}
757claude plugin marketplace update [name]
774claude plugin marketplace update [name] [options]
758775```
759776
760The command takes no flags beyond `--help`.
777| Flag | Description |
778| :- | :- |
779| `--json` | Print whether the command succeeded, and its message, as one JSON object on the last line of stdout, in the [JSON result format](#plugin-json-result). Without a name, the command refuses `--json` and exits `1`. Requires Claude Code v2.1.287 or later |
761780
762781Refresh one marketplace:
763782
from line 784
765784claude plugin marketplace update your-marketplace
766785```
767786
768Claude Code prints `Successfully updated marketplace: your-marketplace`. When you omit the name, it prints a count such as `Successfully updated 2 marketplaces`. With no marketplaces added, it prints `No marketplaces configured` and exits `0`.
787Claude Code prints `Successfully updated marketplace: your-marketplace`. When you omit the name, it prints a count such as `Successfully updated 2 marketplaces`.
769788
770789<h2 id="plugin-in-a-session">
771790 /plugin in a session
No line in this hunk matches that.