How to Set Up the i-have-adhd Project Locally: Agent Skill Installation Guide

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 with installation instructions centralized in 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 – Contains the skill's name, description, persistence rules, and the 10-rule style guide
• INSTALL.md – Provides step-by-step commands for every supported agent
• README.md – Offers quick-start instructions for Claude Code and Codex
• 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.

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.

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

Verify the installation:

claude plugin list

To activate, type /i-have-adhd in any Claude chat. For always-on mode, create an empty trigger file:

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

Codex CLI

For OpenAI's Codex agent, use the marketplace commands with the --ref main flag.

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.

Zed Editor

Zed supports skills through manual directory copying. Copy the local skill folder into Zed's configuration path:

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. 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:

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

For the command-only (on-demand) mode, download the TOML configuration:

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 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, 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 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. 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 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 and 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 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 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 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.

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