[DOCS] CLI reference does not document `claude plugins` alias for `claude plugin`

Still relevant as of 2026-03-28 after re-checking the current docs. This issue is partially resolved, but the remaining documentation gap is still present.

---

Issue #32680 Verification

Title: [DOCS] CLI reference does not document claude plugins alias for claude plugin
Issue Date: 2026-03-10
Verification Date: 2026-04-01
Status: PARTIALLY RESOLVED

---

Issue Summary

This issue reports that the documentation did not make the plural claude plugins alias discoverable in the CLI reference and the dedicated plugin command reference.

---

Verification Results

Claim 1: The CLI reference should document claude plugins as an alias for claude plugin

Status: RESOLVED

At https://code.claude.com/docs/en/cli-reference, line 29, the CLI commands table now says:

| \claude plugin\ | Manage Claude Code [plugins](https://code.claude.com/docs/en/plugins). Alias: \claude plugins\. See [plugin reference](https://code.claude.com/docs/en/plugins-reference) for subcommands | \claude plugin install code-review@claude-plugins-official\ |

Verdict: The CLI reference now explicitly documents claude plugins as an alias for claude plugin, so this claim is resolved.

---

Claim 2: The plugin command reference should explain that the same subcommands also work through claude plugins

Status: UNRESOLVED

At https://code.claude.com/docs/en/plugins-reference, lines 580-587 say:

Claude Code provides CLI commands for non-interactive plugin management, useful for scripting and automation. ### plugin install claude plugin install <plugin> [options]

At the same page, lines 605-613 show install examples only in singular form:

claude plugin install formatter@my-marketplace claude plugin install formatter@my-marketplace --scope project claude plugin install formatter@my-marketplace --scope local

At the same page, lines 620-621, 645, 664, and 683 document the remaining subcommands only in singular form:

claude plugin uninstall <plugin> [options] claude plugin enable <plugin> [options] claude plugin disable <plugin> [options] claude plugin update <plugin> [options]

Verdict: The dedicated plugin command reference still does not say that claude plugins is a top-level alias for claude plugin or show a plural-form example, so this claim remains unresolved.

---

Current State

| Claim | Status |
|-------|--------|
| CLI reference documents claude plugins as an alias for claude plugin | RESOLVED |
| Plugin command reference explains or demonstrates that the same subcommands work via claude plugins | UNRESOLVED |

---

Suggested Fix

Update https://code.claude.com/docs/en/plugins-reference near the start of the CLI commands reference.

Before:

Claude Code provides CLI commands for non-interactive plugin management, useful for scripting and automation.

After:

Claude Code provides CLI commands for non-interactive plugin management, useful for scripting and automation. \claude plugins\ is an alias for \claude plugin\, so every subcommand below works with either form.

Add one plural-form example, such as claude plugins install formatter@my-marketplace.

---

References

• URL: https://code.claude.com/docs/en/cli-reference
• Lines 29-29: CLI commands table explicitly says Alias: claude plugins for claude plugin

• URL: https://code.claude.com/docs/en/plugins-reference
• Lines 580-587: CLI commands reference introduction and plugin install syntax use only claude plugin
• Lines 605-613: install examples use only singular-form commands
• Lines 620-683: uninstall, enable, disable, and update syntax also use only singular-form commands

---

Conclusion & Recommendation

Primary Concern: The issue asked for the claude plugins alias to be discoverable anywhere plugin-management commands are documented.

Resolution Status: PARTIALLY RESOLVED

Recommendation: KEEP OPEN

The CLI reference now documents the alias, but the dedicated plugin command reference still describes all subcommands only with the singular top-level command. The remaining documentation gap is limited, but it is still present.

---

Issue #32680 Verification

Title: [DOCS] CLI reference does not document claude plugins alias for claude plugin
Repo: anthropics/claude-code
Issue Date: 2026-03-10
Verification Date: 2026-04-27
Status: RESOLVED

---

Issue Summary

The issue reported that claude plugins (plural) was added as an alias for claude plugin in release v2.1.72, but neither the CLI reference (cli-reference.md) nor the plugin CLI reference section of plugins-reference.md documented this alias. This meant users could not discover the alias from official documentation.

Verification Results

Claim 1: CLI reference table does not list claude plugins alias

• Status: RESOLVED
• Evidence: The CLI commands table in cli-reference.md line 30 now reads:

> claude plugin — Manage Claude Code plugins. Alias: claude plugins. See plugin reference for subcommands

• Verdict: The alias is explicitly documented in the CLI reference table.

Claim 2: Plugin CLI reference (plugins-reference.md) documents only singular claude plugin ... forms without alias callout

• Status: RESOLVED (acceptable)
• Evidence: The plugin CLI reference section (lines 700-852) uses claude plugin <subcommand> syntax throughout, consistent with the singular form being the canonical entry point. The alias is documented once in the CLI reference table (the authoritative command list), which is the standard pattern for aliases — documenting them at the top-level command rather than repeating for every subcommand.
• Verdict: No separate per-subcommand alias callout is needed since the CLI reference already covers it.

Current State

| Page | Status | Notes |
|------|--------|-------|
| CLI reference | Documents alias | Line 30: "Alias: claude plugins" |
| Plugins reference | Uses canonical form | Subcommands use claude plugin <sub> throughout; alias documented upstream |

Suggested Fix

N/A — the documentation has been updated to include the alias.

References

• CLI reference: https://code.claude.com/docs/en/cli-reference
• Plugin reference: https://code.claude.com/docs/en/plugins-reference
• Release v2.1.72 changelog (original source of the alias)

Conclusion & Recommendation

• Primary Concern: The claude plugins alias was undocumented.
• Resolution Status: The alias is now documented in the CLI reference command table with an explicit "Alias: claude plugins" note.
• Recommendation: Close as completed.

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.