# How to Uninstall the i-have-adhd Plugin: Complete Guide for Every Agent

> Learn how to uninstall the i-have-adhd plugin from any agent. Follow our complete guide to remove it from your marketplace registry and delete local skill files.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: how-to-guide
- Published: 2026-08-02

---

**Uninstall the i-have-adhd plugin by removing it from your agent's marketplace registry and deleting the local skill files—commands vary by agent (Claude Code, Codex, Gemini, Hermes, and others).**

The i-have-adhd plugin is distributed as an **agent-specific extension** that works across multiple AI coding assistants including Claude, Codex, Gemini, Hermes, and Antigravity. Because each agent maintains its own **marketplace** or **skills manager**, uninstallation requires agent-specific commands. This guide covers the exact steps for every supported platform, sourced directly from the repository's [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) and [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) files.

## Two-Step Uninstall Process

Every agent follows the same underlying pattern:

1. **Remove the plugin from the agent's marketplace** — Deregisters the remote reference so the agent stops checking for updates.
2. **Delete locally installed files** — Clears the skill's code from your filesystem.

The plugin's [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) specifies `disable-model-invocation: true`, meaning skills can remain dormant unless explicitly invoked—full deregistration is required to prevent accidental activation.

## Claude Code Uninstallation

Claude Code provides the most granular control with separate disable and uninstall options.

```bash

# Remove from marketplace and uninstall completely

claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd

# Optional: disable without removing files

claude plugin disable i-have-adhd

```

The `disable` command is useful when you want to preserve the plugin for later reactivation without re-downloading.

## Codex Uninstallation

Codex combines removal into a single effective command:

```bash
codex plugin remove i-have-adhd
codex plugin marketplace remove i-have-adhd

```

Codex removes both the registry entry and local files automatically—no additional cleanup required.

## Gemini CLI Uninstallation

Gemini supports **two installation routes**, so match your uninstall method to how you originally installed:

**Command route (TOML-based):**

```bash
rm ~/.gemini/commands/i-have-adhd.toml

```

**Extension route:**

```bash
gemini extensions uninstall i-have-adhd

```

## Hermes Uninstallation

Hermes uses **tap-based** skill management:

```bash
hermes skills uninstall i-have-adhd

# If you added the ayghri tap originally

hermes skills tap remove ayghri/i-have-adhd

```

Local files are stored under `~/.hermes/skills/` and cleaned automatically.

## Antigravity (agy) Uninstallation

```bash
agy plugin uninstall i-have-adhd

```

Post-uninstall, you can reinstall from any URL if needed—useful for testing forks or custom versions.

## Generic Agents: Cursor, OpenCode, Amp, and Others

These agents use the `npx skills` CLI:

```bash

# Project-scoped removal

npx skills remove i-have-adhd

# Global removal

npx skills remove i-have-adhd -g

```

Skills are removed from `~/.cursor/skills/`, `~/.agents/skills/`, or equivalent agent-specific directories.

## Pi Uninstallation

```bash
npx skills remove i-have-adhd
rm -rf ~/.pi/agent/skills/i-have-adhd

```

Pi requires explicit filesystem cleanup after registry removal.

## GitHub Copilot Uninstallation

```bash
npx skills remove i-have-adhd

# Manual cleanup if you copied files directly

rm -rf ~/.copilot/skills/i-have-adhd

```

**Critical:** Copilot loads skills at editor startup. Fully close and restart VS Code after removal to ensure the skill is no longer active.

## Key Source Files in the Repository

Understanding these files helps troubleshoot edge cases:

| File | Location | Purpose |
|------|----------|---------|
| [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) | Repository root | Central uninstall documentation (lines 30-33) |
| [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | `skills/i-have-adhd/` | Skill metadata with `disable-model-invocation: true` |
| [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) | Repository root | Minimal manifest for marketplace registration |

As implemented in `ayghri/i-have-adhd`, the [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) and [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) work together to define how agents discover, register, and execute the plugin's capabilities.

## Troubleshooting Common Issues

**Plugin reappears after restart**
- Ensure you removed both the marketplace entry AND local files.
- For Copilot: restart the entire editor, not just the window.

**"Command not found" errors**
- Verify your agent CLI is installed and in your `PATH`.
- Some commands require the agent to be running (e.g., `claude` daemon).

**Partial uninstall leaving residual behavior**
- Check `~/.[agent]/skills/` manually for leftover folders.
- Reinstall then immediately uninstall through official commands to reset state.

## Summary

- **i-have-adhd plugin uninstallation** requires agent-specific marketplace commands followed by local file deletion.
- **Claude Code** offers `disable` as an alternative to full removal.
- **Gemini users** must identify whether they used the command or extension installation route.
- **GitHub Copilot** requires editor restart after removal.
- All uninstall steps are documented in the repository's [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) and enforced through [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) metadata.

## Frequently Asked Questions

### What happens if I only disable the plugin instead of uninstalling it?

Disabling prevents automatic activation but preserves files for quick re-enable. According to [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), the `disable-model-invocation: true` setting keeps the skill dormant. However, the marketplace entry remains, so the agent may still query for updates. Full uninstallation requires both marketplace removal and file deletion.

### Can I reinstall i-have-adhd after uninstalling?

Yes. Uninstallation is fully reversible. For Antigravity and generic agents, you can reinstall from the original repository or any fork. The [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md) includes a "Tune it" section showing how to replace the upstream copy before reinstalling customized versions.

### Why does GitHub Copilot need a full editor restart?

Copilot loads skills into the VS Code extension host at startup. Unlike agents with dynamic skill reloading, Copilot's architecture caches skill manifests in memory. A full editor restart clears this cache and forces fresh discovery of available skills.

### Where are the skill files stored on my system?

Location varies by agent: `~/.cursor/skills/`, `~/.copilot/skills/`, `~/.hermes/skills/`, `~/.pi/agent/skills/`, or `~/.gemini/commands/`. The `npx skills` CLI abstracts these paths, but manual cleanup requires knowing your specific agent's directory structure.