Docs: plugin install vs disable vs uninstall lifecycle and enabled-state ground truth
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 68/100
- Type d'issue
- Documentation
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- sqlite
- Domaine
- cli, documentation
Piste de recherche
Commencez par localiser la documentation du plugin et examiner les points d’entrée /plugins et /plugin uninstall, ainsi que ~/.config/Cursor/User/globalStorage/state.vscdb et ~/.cursor/cli-config.json. Documentez le cycle de vie de l’installation, de la désactivation et de la désinstallation, identifiez les clés d’état d’activation et incluez les instructions demandées pour la CLI et le dépannage lors d’une nouvelle session.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
There is no single doc that explains install vs disable vs uninstall for Cursor marketplace plugins, or where enabled state actually lives on disk. This causes repeated misdiagnosis (especially CLI-first users) when disabled plugins still appear under /plugins or when slash commands from a disabled plugin persist in autocomplete.
Related: #130 (opt-out / deactivate skills globally).
Problem
Users (and agents troubleshooting plugin state) commonly assume:
- If
~/.cursor/plugins/cache/cursor-public/<slug>/exists → plugin is enabled - If
/pluginslists a plugin → plugin is enabled - Moving/deleting cache dirs → valid way to disable
None of these match observed behavior on Cursor CLI (agent 2026.06.19, Linux).
Observed semantics
| Action | Disk effect | Agent effect |
|---|---|---|
| Install (marketplace) | Creates/updates cache under ~/.cursor/plugins/cache/cursor-public/<slug>/ |
Plugin ID added to enabled list |
Disable (toggle in /plugins detail or Settings) |
Cache retained | Plugin ID removed from enabled list |
Uninstall (/plugin uninstall <name>) |
Removed from installed scope | Must reinstall from marketplace |
Ground truth for enabled plugins
SQLite: ~/.config/Cursor/User/globalStorage/state.vscdb
cursor.plugins.installedIds.no-team
cursor.plugins.installedIds.no-workspace # workspace-scoped overrides
Value is a JSON array of numeric marketplace plugin IDs.
Naming confusion: key says installedIds but value represents enabled IDs only — not "all plugins ever installed."
CLI ~/.cursor/cli-config.json does not store plugin enable state.
UX gaps (product — filing on forum too)
- CLI
/pluginsmixes marketplace browse + installed list; disabled (cached-off) plugins appear without an ENABLED / DISABLED badge. - Slash menu can retain stale entries in
agentData.cacheStorage.agentEnvironment.slashMenuItems.*(same vscdb); staff track this class of bug on forum #161008. /resumesessions may keep prior plugin context; new session required after toggling plugins.
Requested doc changes (this repo or cursor.com/docs)
- Lifecycle table (install / disable / uninstall) with filesystem + vscdb effects.
- Explicit note:
plugins/cache/= downloaded artifacts; not enable state. - CLI section:
/pluginsis browse + manage; verify enable state via Settings or vscdb keys above. - Troubleshooting: after disable, start new agent session; slash menu cache may need fresh session (not
/resume). - Link to forum threads for product UX bugs (uninstall button redirect, slash menu cache).
Environment
- OS: Linux (Ubuntu)
- CLI:
agent2026.06.19-20-24-33 - Example:
compound-engineering(ID 680) CACHED-OFF but cache present;cursor-team-kit(677) ENABLED — only distinguishable via vscdb, not/pluginsUI.
Note
cursor/cursor has issues disabled; forum is the right channel for IDE/CLI product bugs. This issue is scoped to documentation / plugin-spec clarity so plugin authors and power users stop fighting the cache directory.
- Langage dominant
- TypeScript
- Étoiles
- 9.7k
- Forks
- 919
- Merge moyen
- 14 h 37 min
- PR mergées (30 j)
- 66
Préparer son environnement
Ce projet ne fournit ni conteneur de développement, ni Dockerfile, ni guide de contribution : l'installation est à votre charge. Commencez par son README, et consultez notre guide de la première contribution pour les étapes générales.
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de cursor/plugins
-
pstack: Comment Sicko agent name has a space and Grok rejects the spawnPeut-être pris @lab1207 l’a pris il y a 3 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
cursor/plugins#483 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
create-plugin README documents a /create-plugin command that does not existPeut-être pris @lab1207 l’a pris il y a 3 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
cursor/plugins#475 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
principle-test-behavior-not-implementation: listed matchers do not all pass when imports return undefinedPeut-être pris @Yi-111-a l’a pris il y a 4 jours. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
cursor/plugins#474 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
cursor-sdk auth.md: non-null assertion described as a runtime missing-variable checkPeut-être pris @lab1207 l’a pris il y a 3 jours. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 92/100
cursor/plugins#473 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
watch-pr: review threads are fetched without pagination (first 100 only)Peut-être pris @Yi-111-a l’a pris il y a 3 jours. Ouverte
Difficulté 2/5 Une demi-journée Accessibilité débutants 84/100
cursor/plugins#471 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de cursor/plugins
Issues similaires
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
solana-foundation/solana-com#2245 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
`document.cookie` with `max-age=0` does not delete the cookiePeut-être pris @BartInTheField l’a pris aujourd’hui. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
capricorn86/happy-dom#2460 ·
Les mainteneurs répondent en général sous 2 jours