# How to Set Up the i-have-adhd Project Locally: Agent Skill Installation Guide > Learn to set up the i-have-adhd project locally. Clone the repository, install the agent skill, and activate ADHD friendly coding rules with a simple command. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-07-30 --- **Clone the repository to your local machine and install the `skills/i-have-adhd` folder into your AI agent's specific directory, then activate the ADHD-friendly coding rules with the `/i-have-adhd` command.** The `ayghri/i-have-adhd` repository is a lightweight **Agent Skill** that enforces an ADHD-friendly output style across multiple AI coding assistants including Claude Code, Codex, Zed, and Gemini CLI. Because the project follows the Open Agent-Skills specification and consists entirely of configuration text, you can set up the i-have-adhd project locally without installing runtime dependencies like Node.js or Python. The entire skill is defined in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) with installation instructions centralized in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md). ## Project Structure and Prerequisites The repository contains no build scripts or package managers. You only need **Git** to clone the source and an AI agent that supports the Open Agent-Skills specification. Key files you will reference during setup: - **[`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md)** – Contains the skill's name, description, persistence rules, and the 10-rule style guide - **[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)** – Provides step-by-step commands for every supported agent - **[`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md)** – Offers quick-start instructions for Claude Code and Codex - **[`plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/plugin.json)** and **`agents/`** – Metadata required by Claude Code and Gemini CLI marketplaces ## Clone the Repository Start by cloning the repository to access the skill files. This is the universal first step for all agents. ```bash git clone https://github.com/ayghri/i-have-adhd cd i-have-adhd ``` After cloning, locate the **`skills/i-have-adhd/`** directory. This folder contains the complete skill definition that you will copy or reference during agent-specific installation. ## Agent-Specific Installation Methods ### Claude Code (On-Demand and Always-On) Install directly from the marketplace to enable the `/i-have-adhd` command. ```bash claude plugin marketplace add ayghri/i-have-adhd claude plugin install i-have-adhd@i-have-adhd ``` Verify the installation: ```bash claude plugin list ``` To activate, type **`/i-have-adhd`** in any Claude chat. For always-on mode, create an empty trigger file: ```bash touch ~/.claude/.i-have-adhd-always ``` ### Codex CLI For OpenAI's Codex agent, use the marketplace commands with the `--ref main` flag. ```bash codex plugin marketplace add ayghri/i-have-adhd --ref main codex plugin add i-have-adhd@i-have-adhd ``` Verify with `codex plugin list`. Activate the rules by typing **`$i-have-adhd`** (note the dollar sign prefix) in your chat session. To enable persistence, add the "Output style" block to `~/.codex/AGENTS.md` as described in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md). ### Zed Editor Zed supports skills through manual directory copying. Copy the local skill folder into Zed's configuration path: ```bash cp -R skills/i-have-adhd ~/.config/zed/skills/ ``` Alternatively, use the IDE interface: open **Skills Manager → Create skill from URL** and paste the direct link to [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). Restart Zed, then type **`/i-have-adhd`** in the Agent panel to apply the style rules. ### Gemini CLI Gemini offers two installation paths. For the always-on extension mode: ```bash gemini extensions install https://github.com/ayghri/i-have-adhd ``` For the command-only (on-demand) mode, download the TOML configuration: ```bash mkdir -p ~/.gemini/commands 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 ``` Verify with `gemini extensions list` or `ls ~/.gemini/commands`. Use **`/i-have-adhd`** to activate. ### Hermes, Pi, and Other Open Agent-Skills Harnesses For agents like Hermes, Pi, Antigravity, or Cursor/OpenCode, copy the `skills/i-have-adhd` folder into your agent's global or project-specific skill directory. Invoke the skill using the agent's slash-command syntax (typically `/i-have-adhd` for Hermes or `/skill:i-have-adhd` for Pi). Consult [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) for the specific directory paths used by each harness. ## Verify Your Installation After installation, restart your AI agent to ensure it indexes the new skill. Test activation by typing the command trigger in a new chat session. If the agent responds with the ADHD-friendly style guidelines defined in [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md), the local setup is complete. ## Troubleshooting Local Setup - **Skill not appearing in autocomplete** – Restart the agent. Most agents scan the skill directory only at startup. - **Always-on mode ignored** – Verify the hook file [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) exists in the skill directory and that you are using the latest plugin version via `claude plugin marketplace update i-have-adhd`. - **Command not recognized** – Ensure the folder name `i-have-adhd` matches the `name:` field in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). Mismatches prevent the agent from registering the command. ## Summary - **Clone once**: `git clone https://github.com/ayghri/i-have-adhd` to get the source files - **Locate the skill**: Use the `skills/i-have-adhd/` directory for all installations - **Zero dependencies**: The project requires no npm, pip, or cargo packages - **Agent-specific paths**: Copy or install into Claude Code, Codex, Zed, or Gemini CLI using the commands specific to each platform - **Activation**: Use `/i-have-adhd` (or `$i-have-adhd` for Codex) to trigger the style rules - **Reference**: Check [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) for the most up-to-date per-agent instructions ## Frequently Asked Questions ### Do I need Node.js or Python to set up i-have-adhd locally? No. The skill consists of pure-text configuration files defined in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) and [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md). Your AI agent interprets these rules directly without requiring additional language runtimes or package managers. ### How do I enable i-have-adhd automatically for every chat session? For **Claude Code**, create the file `~/.claude/.i-have-adhd-always`. For **Codex**, append the "Output style" configuration block to `~/.codex/AGENTS.md`. **Gemini CLI** extensions run in always-on mode by default when installed via `gemini extensions install`. Check [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) for persistence flags specific to other agents. ### Can I use i-have-adhd with Cursor or VS Code? Yes. While not explicitly listed in the primary quick-start, Cursor and similar IDEs that support the Open Agent-Skills specification can use the skill by manually copying the `skills/i-have-adhd` folder into the IDE's designated skill directory. The [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md) confirms compatibility with any harness supporting the standard spec. ### Where is the core skill configuration stored? The complete rule set is defined in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) at the repository root. This file contains the 10-point ADHD-friendly output style guide, persistence behavior rules, and the skill metadata that agents use to register the `/i-have-adhd` command.