i‑Have‑ADHD Installation Guide: How to Install on Claude, Codex, Zed, Gemini, Copilot & More

The i‑have‑adhd repository provides platform‑specific commands in INSTALL.md to add its ADHD‑focused output skill to Claude Code, Codex, Zed, Gemini CLI, GitHub Copilot, and other AI agents.

The i‑have‑adhd project by ayghri is a single Agent Skill that reshapes AI output for readers with ADHD. Because each agent uses a different plugin or skill management system, installation steps vary significantly. This guide extracts every verified command directly from the source repository, linking each step to the exact lines in [INSTALL.md](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md).

How the i‑Have‑ADHD Skill Works

The skill's core definition lives in [skills/i-have-adhd/SKILL.md](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). Its front‑matter declares the skill name, description, and disables automatic model invocation (disable-model-invocation: true). The body contains 10 concrete rules that reshape output—such as "Lead with the next action," "Number multi‑step tasks," and "Give specific time estimates."

When you type /i-have-adhd in a supported agent, these rules activate for the remainder of the session until you say "stop adhd mode." Optional always‑on configurations load the skill automatically at session start, eliminating the need for the slash command.

Claude Code Installation

Claude Code uses a marketplace‑based plugin system. The i‑have‑adhd installation requires two sequential commands as documented in lines 1‑12 of [INSTALL.md](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md):

claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Verification and management:

Action	Command
Verify install	claude plugin list
Update skill	claude plugin marketplace update i-have-adhd
Uninstall	claude plugin uninstall i-have-adhd then claude plugin marketplace remove i-have-adhd

Always‑on mode: Create the flag file ~/.claude/.i-have-adhd-always (see lines 38‑48 of INSTALL.md). This activates ADHD formatting on every new Claude session without typing the slash command.

touch ~/.claude/.i-have-adhd-always

Codex Installation

Codex follows a similar pattern but uses codex plugin add instead of install, and requires --ref main for marketplace additions (lines 13‑28 of INSTALL.md):

codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

Verification and management:

Action	Command
Verify install	codex plugin list
Update skill	codex plugin marketplace upgrade i-have-adhd
Uninstall	codex plugin remove i-have-adhd then codex plugin marketplace remove i-have-adhd

Always‑on mode: Add the "Output style" block to ~/.codex/AGENTS.md (lines 89‑108 of INSTALL.md). This file persists formatting rules across all Codex sessions.

Zed Installation

Zed offers two installation paths for i‑have‑adhd (lines 19‑33 of INSTALL.md):

GUI method: Open Agent Panel → Skills manager → Create skill from URL and paste:

https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md

Manual method: Clone the repository and copy the skill folder:

git clone https://github.com/ayghri/i-have-adhd.git
cp -r i-have-adhd/skills/i-have-adhd ~/.config/zed/skills/

Verification: Check the Skills manager or type / in the Zed agent panel to confirm i-have-adhd appears.

Update: Re‑import from the same URL or run git pull then copy the folder again.

Uninstall: Remove via the Skills manager or delete ~/.config/zed/skills/i-have-adhd.

Always‑on mode: Append the "Output style" block to ~/.config/zed/AGENTS.md (lines 48‑66 of INSTALL.md).

Hermes Installation

Hermes uses a dedicated skills subcommand (lines 1‑11, 31‑35 of INSTALL.md):

hermes skills install ayghri/i-have-adhd/skills/i-have-adhd

Verification and management:

Action	Command
Verify install	hermes skills list
Update skill	hermes skills update i-have-adhd
Uninstall	hermes skills uninstall i-have-adhd

Always‑on mode: Add the output style block to your persona's SOUL.md or a project‑level AGENTS.md (lines 12‑30 of INSTALL.md).

Gemini CLI Installation

Gemini CLI supports two distinct installation routes (lines 60‑84 of INSTALL.md):

Command‑only (opt‑in):

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

Then type /i-have-adhd in any Gemini session to activate.

Extension (always‑on):

gemini extensions install https://github.com/ayghri/i-have-adhd

Verification: gemini extensions list or ls ~/.gemini/commands

Update: gemini extensions update i-have-adhd (or re‑run the curl command for command‑only installs)

Uninstall: gemini extensions uninstall i-have-adhd and remove the .toml file if using the command route.

The extension route is automatically always‑on; no additional configuration needed.

GitHub Copilot Installation

GitHub Copilot (VS Code and CLI) uses the npx skills toolchain (lines 12‑28 of INSTALL.md):

# Project‑local install

npx skills add ayghri/i-have-adhd -a github-copilot

# Global install

npx skills add ayghri/i-have-adhd -a github-copilot -g

Verification: npx skills list or type / in the Copilot chat panel.

Update: npx skills update i-have-adhd

Uninstall: npx skills remove i-have-adhd

Always‑on mode: Add the "Output style" block to .github/copilot-instructions.md in your repository (lines 12‑28 of INSTALL.md). For global always‑on behavior, add to your user‑level Copilot instructions.

Antigravity (agy) Installation

Antigravity uses a direct URL plugin install (lines 65‑83 of INSTALL.md):

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

Verification: agy plugin list

Update: Uninstall then reinstall: agy plugin uninstall i-have-adhd followed by agy plugin install https://github.com/ayghri/i-have-adhd

Always‑on mode: Add the output style block to ~/.gemini/GEMINI.md (lines 65‑83 of INSTALL.md).

Cursor, OpenCode & Other Harnesses Installation

For harnesses without dedicated package managers, the npx skills toolchain provides universal support (lines 37‑55 of INSTALL.md):

# Workspace install

npx skills add ayghri/i-have-adhd

# Global install

npx skills add ayghri/i-have-adhd -g

# Harness‑specific (optional)

npx skills add ayghri/i-have-adhd -a cursor
npx skills add ayghri/i-have-adhd -a opencode

Verification: npx skills list

Update: npx skills update i-have-adhd

Uninstall: npx skills remove i-have-adhd

Always‑on mode: Paste the "Output style" block into your harness's persistent rules:

• Cursor: Settings → Rules → User Rules
• OpenCode: ~/.config/opencode/AGENTS.md

Key Source Files for i‑Have‑ADHD Installation

File	Purpose	Location
INSTALL.md	Master installation guide with verified commands for all agents	[INSTALL.md](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)
SKILL.md	Core skill definition with 10 ADHD output rules	[skills/i-have-adhd/SKILL.md](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)
GEMINI.md	Extension‑specific documentation for Gemini CLI	[GEMINI.md](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md)
gemini.toml	Command definition file for Gemini CLI command route	[skills/i-have-adhd/agents/gemini.toml](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/agents/gemini.toml)

Summary

• Claude Code and Codex use marketplace‑based plugin systems with plugin marketplace add followed by plugin install or plugin add.
• Zed supports both GUI URL import and manual file copying to ~/.config/zed/skills/.
• Hermes uses hermes skills install with direct repository path references.
• Gemini CLI offers curl‑based command installation or full extension installation via gemini extensions install.
• GitHub Copilot, Cursor, and OpenCode leverage the npx skills toolchain with -a flags for agent‑specific targeting.
• Antigravity uses agy plugin install with the repository URL.
• Always‑on mode everywhere requires adding the output style block to agent‑specific persistent configuration files—never the slash command workflow.

Frequently Asked Questions

What is the i‑have‑adhd skill and how does it work?

The i‑have‑adhd skill is an Agent Skill defined in SKILL.md that contains 10 formatting rules designed for readers with ADHD. When you type /i-have-adhd in a supported agent, these rules activate immediately—leading with next actions, numbering steps, providing time estimates, and breaking up dense text. The skill disables automatic model invocation, so it only runs when explicitly called or configured as always‑on.

Why do installation commands differ so much between AI agents?

Each AI agent platform implements its own plugin architecture. Claude Code and Codex use marketplace registries with CLI‑driven installs. Zed uses a skill manager with URL import. Hermes has a dedicated skills subcommand. Gemini CLI supports both extensions and standalone command files. The INSTALL.md file maps each platform's native conventions to the same underlying skill definition.

How do I make i‑have‑adhd always active without typing /i‑have‑adhd every session?

Each agent supports always‑on configuration through persistent files: ~/.claude/.i-have-adhd-always for Claude Code, ~/.codex/AGENTS.md for Codex, ~/.config/zed/AGENTS.md for Zed, and similar paths for other agents. These files contain the same output style block from SKILL.md, loaded automatically at session start. The Gemini extension route is always‑on by design.

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