Plugin commands reference changedplugins/cli-reference
Nearest release: v2.1.287, published 5 hours before 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 1 Oct 2026 22:58 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 1 Oct 2026 23:07 UTC.
Upstream edited
Recorded here
Lines+17added
Lines−1removed
From line
533
where the diff opens
First seen
25 Sep 2026
this site's first read of the page
Recorded edits9to this page, all time
### plugin test
The whole hunk
from line 533, old and new numbered
/
from line 533
533533* The tag already exists
534534* The working tree is dirty
535535
536### plugin test
537
538Run the tests for a [mod](/docs/en/plugins/mods/overview), a plugin whose code registers event handlers. The command needs no session, sign-in, or network. For how to write a test, see [Test a mod](/docs/en/plugins/mods/test).
539
540```bash theme={null}
541claude plugin test [directory]
542```
543
544The `[directory]` is the mod's directory, defaulting to the current directory. The command runs every file under it whose name ends in `.test.ts` or `.test.tsx`, and exits with status 1 when a test fails.
545
546Run the tests for a mod in `./first-mod`:
547
548```bash theme={null}
549claude plugin test ./first-mod
550```
551
536552### plugin validate
537553
538554Validate a plugin manifest, a marketplace manifest, or the skills, agents, and commands in a directory, and exit with a code a CI job can act on. For the create, test, and edit workflow, see [Create a plugin](/docs/en/plugins/create). For what the validator checks in each manifest, see the [plugin manifest reference](/docs/en/plugins/manifest-reference) and the [marketplace reference](/docs/en/plugins/marketplace-reference).
from line 766
750766
751767A `<plugin>` is a plugin `name` or `name@marketplace`.
752768
753The table below lists every session form. The shell subcommands `init`, `update`, `details`, `prune`, `eval`, and `eval init` have no session form.
769The table below lists every session form. The shell subcommands `init`, `update`, `details`, `prune`, `eval`, `eval init`, and `test` have no session form.
754770
755771| Command | Aliases | What it does |
756772| :- | :- | :- |
No line in this hunk matches that.