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

> Easily update the i-have-adhd VS Code plugin. Learn to use your AI coding environment's update command or reinstall from GitHub for the latest features. Keep your coding assistant current.

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

---

**Update the i-have-adhd plugin by either running your AI coding environment's native update command or reinstalling the plugin from the GitHub repository to pull the latest commits from the main branch.**

The **i-have-adhd** plugin, hosted in the `ayghri/i-have-adhd` repository, distributes ADHD-friendly coding rules as a version-controlled set of files rather than a compiled binary. Because the plugin consists of 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)), updating it requires refreshing these files to match the latest repository state.

## Understanding the Plugin Architecture

The plugin contains no runtime state or persistent data, making updates safe and atomic. The three core files define the entire behavior:

- **[`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json)** — Identifies the plugin to host environments
- **[`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)** — Contains the actual ADHD-friendly ruleset
- **[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)** — Documents installation and update procedures for all supported platforms

Since these files live in a standard GitHub repository, updating the plugin means aligning your local copy with the latest commit in the `main` branch.

## Update Methods: Re-install vs. Native Command

Two approaches exist depending on your environment's capabilities.

### Re-install Method

Uninstall the current version, then install fresh from `https://github.com/ayghri/i-have-adhd`. This guarantees you run the exact code currently in the main branch. Use this when your environment lacks a dedicated update command.

### Native Update Command

Run the environment's built-in update operation to refresh the plugin without full removal. This pulls the latest commit and refreshes the plugin metadata.

## Platform-Specific Update Commands

### Antigravity (agy)

Since agy lacks a dedicated update command, use the re-install pattern:

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

```

### Claude Code

Use the marketplace update command:

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

```

### Qwen Code

Update via the extensions command:

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

```

### Codex

Upgrade through the marketplace:

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

```

### Gemini CLI

Two routes exist: command route (opt-in) and extension route (always-on).

For the **command route**, re-download the TOML configuration:

```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**:

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

```

### Pi

Update the native package directly:

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

```

### Generic NPM-Style Managers

For environments like Cursor or OpenCode using npx-based skill management:

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

```

## Verifying the Update

After updating, confirm success by listing installed plugins:

- `agy plugin list`
- `claude plugin list`
- `qwen extensions list`

Check for the latest commit hash or version number to ensure the environment references the current `main` branch.

## Summary

- The i-have-adhd plugin updates by refreshing files in `skills/i-have-adhd/` and [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) from the repository
- Use the **re-install method** (uninstall then install) for environments without native update commands like Antigravity
- Use **native update commands** for Claude Code, Qwen Code, Codex, and Pi to pull latest commits without removal
- Gemini CLI supports both extension updates and manual TOML file replacement for command routes
- Verify updates by checking plugin lists for current commit hashes

## Frequently Asked Questions

### Does updating the i-have-adhd plugin preserve my custom settings?

Yes. Because the plugin stores no runtime state in [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) or [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), updating only replaces the rule definitions and manifest. Your environment-specific configurations remain intact while the core skill files refresh.

### Why does Antigravity require a full reinstall instead of an update command?

Antigravity's plugin manager currently lacks a dedicated update operation. The uninstall-then-install pattern ensures the `skills/i-have-adhd/` directory and [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) match the latest commit from `https://github.com/ayghri/i-have-adhd` without merge conflicts or stale file issues.

### How do I know if my update succeeded?

Run your environment's list command (e.g., `claude plugin list` or `agy plugin list`). If the plugin displays the latest commit hash from the repository's main branch or the current version number, the update succeeded and you are running the newest ruleset.

### Can I update the plugin manually by pulling the Git repository?

Yes. Since the plugin is a standard GitHub repository, you can manually pull the latest changes to your local clone. However, you must still trigger your AI environment's reload mechanism or reinstall to ensure it reads the updated [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) and [`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json) files into memory.