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

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), a plugin manifest (plugin.json), and installation instructions (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 — Identifies the plugin to host environments
• skills/i-have-adhd/SKILL.md — Contains the actual ADHD-friendly ruleset
• 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:

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

Claude Code

Use the marketplace update command:

claude plugin marketplace update i-have-adhd

Qwen Code

Update via the extensions command:

qwen extensions update i-have-adhd

Codex

Upgrade through the marketplace:

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:

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:

gemini extensions update i-have-adhd

Pi

Update the native package directly:

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

Generic NPM-Style Managers

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

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 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 or 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 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 and plugin.json files into memory.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}