# How to Install i‑have‑adhd as a Claude Code Plugin: Complete Setup Guide

> Install i-have-adhd as a Claude Code plugin easily. Follow this guide to add the repository and set up the plugin for enhanced coding assistance.

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

---

**Install i‑have‑adhd as a Claude Code plugin by adding the repository to Claude's marketplace with `claude plugin marketplace add ayghri/i-have-adhd`, then installing with `claude plugin install i-have-adhd@i-have-adhd`.**

The **i‑have‑adhd** plugin (ayghri/i-have-adhd) provides ADHD‑friendly response rules for Claude Code through a structured **skill** system. This guide walks through the complete installation process, activation methods, and optional always‑on configuration based on the repository's source code.

## What the i‑have‑adhd Plugin Provides

Claude Code plugins extend the IDE with custom **skills** defined in [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) files. The i‑have‑adhd plugin registers a single skill located at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md). This file contains response formatting rules and front‑matter that disables automatic model invocation:

```yaml
disable-model-invocation: true

```

This flag ensures Claude only applies ADHD‑friendly formatting when you explicitly request it—either by running the `/i‑have‑adhd` slash command or by enabling the always‑on flag.

A `SessionStart` hook in [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) handles automatic activation when the flag file `~/.claude/.i-have-adhd-always` is present.

## Prerequisites

Before installing, ensure you have:

- **Claude Code CLI** installed and authenticated
- Access to the internet for marketplace operations

## Step‑by‑Step Installation

### 1. Add the Plugin to Claude's Marketplace

First, register the repository as a known plugin source:

```bash
claude plugin marketplace add ayghri/i-have-adhd

```

This command tells Claude Code where to fetch the plugin metadata. The repository's [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) declares the plugin structure that Claude reads during this step.

### 2. Install the Plugin

Install the plugin from the marketplace into your local Claude Code environment:

```bash
claude plugin install i-have-adhd@i-have-adhd

```

Claude pulls the plugin definition, registers the skill, and makes the `/i‑have‑adhd` command available in chat sessions.

### 3. Verify Installation

Open any Claude Code chat and type:

```text
/i-have-adhd

```

You should see confirmation that the skill is active. The response rules will apply to subsequent interactions in that session.

## Optional: Enable Always‑On Mode

By default, the skill is **dormant** until manually invoked. To activate ADHD‑friendly formatting automatically for every Claude Code session, create the flag file:

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

```

According to the source code in [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json), a `SessionStart` hook checks for this file at session initialization. When present, it automatically injects the skill's rules without requiring the slash command.

### Disable Always‑On Mode

To return to manual activation only, remove the flag file:

```bash
rm ~/.claude/.i-have-adhd-always

```

## Complete Command Reference

```bash

# Add plugin to marketplace

claude plugin marketplace add ayghri/i-have-adhd

# Install from marketplace

claude plugin install i-have-adhd@i-have-adhd

# Manual activation in chat

/i-have-adhd

# Enable auto-activation

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

# Disable auto-activation

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

```

## Key Source Files

Understanding the plugin structure helps with troubleshooting and customization:

| File | Purpose |
|------|---------|
| [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) | Plugin metadata declaring name, version, and skill paths |
| [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | Core response rules and `disable-model-invocation` flag |
| [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) | `SessionStart` hook for automatic activation |
| [`README.md`](https://github.com/ayghri/i-have-adhd/blob/main/README.md) (lines 24–30) | High‑level installation commands |
| [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) (lines 4–12, 38–42) | Detailed CLI instructions and flag file documentation |

## Troubleshooting

- **Command not found**: Ensure the plugin installed successfully with `claude plugin list`
- **Always‑on not working**: Verify the flag file path—`~/.claude/.i-have-adhd-always` must be in your home directory, not the project root
- **Rules not applying**: Check that [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) exists in the plugin installation; reinstall if corrupted

## Summary

- **i‑have‑adhd** installs as a Claude Code plugin via two CLI commands: `marketplace add` and `plugin install`
- The skill at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) provides ADHD‑friendly formatting with automatic invocation disabled by default
- Use `/i‑have‑adhd` for manual activation, or create `~/.claude/.i-have-adhd-always` for automatic session‑wide rules
- The `SessionStart` hook in [`hooks/hooks.json`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/hooks.json) implements always‑on behavior by checking for the flag file

## Frequently Asked Questions

### Does i‑have‑adhd require a Claude Pro subscription?

No. The plugin works with any Claude Code installation that supports the plugin marketplace. The repository's [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) documents standard CLI commands available in all Claude Code tiers.

### Why isn't the skill activating automatically after installation?

The `disable-model-invocation: true` setting in [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) prevents automatic activation. You must either run `/i‑have‑adhd` manually or create the `~/.claude/.i-have-adhd-always` flag file. This design prevents unintended formatting changes to your workflow.

### Can I use i‑have‑adhd alongside other Claude Code plugins?

Yes. Claude Code supports multiple concurrent plugins. The i‑have‑adhd skill registers under its own namespace and does not conflict with other marketplace plugins unless they define identically named slash commands.

### How do I update i‑have‑adhd to the latest version?

Re‑run the install command to pull updates from the marketplace:

```bash
claude plugin install i-have-adhd@i-have-adhd

```

Claude Code will detect version changes in [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) and apply updates automatically.