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

> Find easy i-have-adhd installation instructions for Claude, Codex, Zed, Gemini, Copilot and more. Integrate ADHD-focused AI output skills today.

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

---

**The i‑have‑adhd repository provides platform‑specific commands in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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)](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)](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)](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md):

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)). This activates ADHD formatting on every new Claude session without typing the slash command.

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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:

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)).

## Hermes Installation

Hermes uses a dedicated `skills` subcommand (lines 1‑11, 31‑35 of [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/SOUL.md) or a project‑level [`AGENTS.md`](https://github.com/ayghri/i-have-adhd/blob/main/AGENTS.md) (lines 12‑30 of [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)).

## Gemini CLI Installation

Gemini CLI supports two distinct installation routes (lines 60‑84 of [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

**Command‑only (opt‑in):**

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

```

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

**Extension (always‑on):**

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/.github/copilot-instructions.md) in your repository (lines 12‑28 of [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

```bash
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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)):

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) | Master installation guide with verified commands for all agents | [[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) |
| [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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)](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) |
| [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) | Extension‑specific documentation for Gemini CLI | [[`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md)](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) |
| [`gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/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)](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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), loaded automatically at session start. The Gemini extension route is always‑on by design.