# How to Update the i-have-adhd Plugin: A Complete Guide for All AI Coding Environments

> Update the i-have-adhd plugin easily. Learn how to use your AI environment's update command or reinstall from GitHub to get the latest features.

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

---

**To update the i-have-adhd plugin, either run your AI environment's built-in update command (e.g., `claude plugin marketplace update i-have-adhd`) or uninstall and reinstall the plugin from the GitHub repository to pull the latest commit.**

The **i-have-adhd** plugin is distributed through the `ayghri/i-have-adhd` repository as a collection of Git-tracked files, including a **skill definition** ([`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)), a **plugin manifest** ([`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json)), and **installation instructions** ([`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)). Because the plugin contains no runtime state, updating it simply requires fetching the newest version of these files and reloading them in your AI coding environment.

## Understanding the Plugin Architecture

The plugin's structure consists of three core components that live in the repository root:

- **[`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json)** — The minimal manifest that environments like Antigravity and Claude Code use to identify and load the plugin.
- **[`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)** — The actual skill definition containing the ADHD-friendly ruleset and behavioral instructions.
- **[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)** — Centralized documentation for installation and update procedures across all supported platforms.

Since these are static files under version control, updating the plugin means ensuring your local environment points to the latest commit on the `main` branch.

## Update Methods Overview

There are two primary strategies to update the i-have-adhd plugin, depending on your environment's capabilities:

**Update Command** — Use this when your AI coding environment exposes a dedicated update operation. This method pulls the latest commit and refreshes the plugin without removing configuration.

**Re-install** — Use this universal method when your environment lacks a specific update command, or when you want to guarantee a clean installation. This removes the old version before pulling fresh code from `https://github.com/ayghri/i-have-adhd`.

## Platform-Specific Update Commands

Below are the exact commands for each supported AI coding environment. All commands assume you have the respective CLI installed and authenticated.

### Antigravity (agy)

Antigravity does not provide a dedicated update command, so you must uninstall and reinstall:

```bash
agy plugin uninstall i-have-adhd
agy plugin install https://github.com/ayghri/i-have-adhd

```

### Claude Code

Claude Code supports direct marketplace updates:

```bash
claude plugin marketplace update i-have-adhd

```

### Qwen Code

Update the extension using the built-in command:

```bash
qwen extensions update i-have-adhd

```

### Codex

Upgrade via the marketplace command:

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

```

### Gemini CLI

Gemini offers two installation routes. For the **command route** (opt-in), re-download the TOML file:

```bash
curl -fsSL https://raw.githubusercontent.com/ayghri/i-have-adhd/main/skills/i-have-adhd/agents/gemini.toml \
  -o ~/.gemini/commands/i-have-adhd.toml

```

For the **extension route** (always-on), use:

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

```

### Pi

Update the native package directly from the repository URL:

```bash
pi update https://github.com/ayghri/i-have-adhd

```

### Generic npm-Style Managers

For environments like Cursor or OpenCode that use npm-style skill management:

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

```

## Universal Re-install Method

If you prefer a clean slate or your environment lacks a specific update command, the uninstall-then-install pattern works universally across all platforms:

```bash

# Replace <manager> with your environment's CLI name

<manager> plugin uninstall i-have-adhd
<manager> plugin install https://github.com/ayghri/i-have-adhd

```

This method guarantees you are running the exact code present in the repository's `main` branch, as it removes any cached or stale versions before fetching fresh files.

## Verifying Your Update

After updating, confirm you are running the latest version by listing your installed plugins:

- **Antigravity**: `agy plugin list`
- **Claude Code**: `claude plugin list`
- **Qwen Code**: `qwen extensions list`

If the output shows the latest commit hash or the current version number from [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json), the update succeeded.

## Summary

- The i-have-adhd plugin consists of static files ([`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json), [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)) tracked in the `ayghri/i-have-adhd` repository.
- **Update commands** (e.g., `claude plugin marketplace update`) pull the latest commit without uninstalling.
- **Re-installation** (uninstall then install) works universally when dedicated update commands are unavailable.
- Always verify updates by checking the installed version against the repository's `main` branch.

## Frequently Asked Questions

### How do I know if I need to reinstall or can use an update command?

Check if your AI environment supports a dedicated update operation. According to the [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) in the source repository, Claude Code, Qwen Code, Codex, and Pi support native update commands, while Antigravity and Gemini CLI command routes require full reinstallation. When in doubt, the reinstall method works universally across all environments.

### Will updating the plugin delete my custom settings or conversation history?

No. The plugin files ([`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md), [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json)) contain no runtime state or user data. Updating or reinstalling only replaces the skill definition files, leaving your environment's conversation history and configuration intact.

### What is the difference between the Gemini CLI command route and extension route?

The **command route** loads the plugin only when explicitly invoked, requiring you to manually update the TOML file via `curl`. The **extension route** keeps the plugin always active and supports the standard `gemini extensions update` command. Both methods reference the same source files in `ayghri/i-have-adhd` but differ in activation timing and update mechanics.

### Can I automate updates for the i-have-adhd plugin?

Yes. Since the plugin resides in a standard GitHub repository, you can script the update process using the platform-specific commands above. For example, create a shell alias that runs `agy plugin uninstall i-have-adhd && agy plugin install https://github.com/ayghri/i-have-adhd` daily, or use your environment's built-in auto-update features if available.