# How to Install i-have-adhd on Claude Code Using the Multi-Runtime Install Pattern > Learn the multi-runtime install pattern for i-have-adhd on Claude Code. Register the repo, install with branch-specific tag, and use the /i-have-adhd command for seamless integration. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-09-12 --- **The multi-runtime install pattern for i-have-adhd on Claude Code requires registering the repository in the marketplace, installing the plugin using the branch-specific tag `i-have-adhd@i-have-adhd`, and invoking the skill via the `/i-have-adhd` slash command, with an optional flag file to enable automatic loading via SessionStart hooks.** The `ayghri/i-have-adhd` repository provides a specialized skill designed to optimize AI interactions for ADHD workflows. It implements a standardized multi-runtime install pattern shared across Claude Code, Codex, and OpenCode agents, allowing consistent deployment across different AI coding environments. This guide breaks down the specific implementation details found in the source code to get you running on Claude Code. ## Understanding the Multi-Runtime Pattern The **multi-runtime install pattern** is a unified workflow that decouples plugin registration from activation. According to the repository's [[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md), this pattern consists of three core phases: marketplace registration (making the plugin discoverable), installation by tag (binding a specific version), and invocation (loading the ruleset into the session). This architecture enables the same repository to function across multiple agent runtimes without code changes. ## Step-by-Step Claude Code Installation ### Register the Repository in the Marketplace First, add the remote repository to your local Claude Code marketplace index. This command registers the plugin metadata so Claude Code can fetch and validate the package. ```bash claude plugin marketplace add ayghri/i-have-adhd ``` This step writes the repository location to Claude Code's internal registry, allowing the agent to resolve the plugin name to a GitHub source. ### Install the Plugin by Tag Install the plugin using the specific tag format that matches the repository's default branch. As documented 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#claude-code), the tag follows the pattern `name@branch`. ```bash claude plugin install i-have-adhd@i-have-adhd ``` The tag `i-have-adhd@i-have-adhd` references the default branch name, ensuring you install the latest stable version of the ruleset located 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). ### Invoke the Skill Manually After installation, load the ADHD-friendly ruleset for your current session by typing the slash command: ``` /i-have-adhd ``` This command injects the formatting and behavioral guidelines defined in the skill's ruleset into the active conversation context. ## Enabling Always-On Mode For automatic loading without manual invocation, the repository provides a **SessionStart hook** mechanism. When the flag file exists, Claude Code triggers the hook script to preload the ruleset for every new session. Create the flag file to enable automatic activation: ```bash touch ~/.claude/.i-have-adhd-always ``` According to [`hooks/always-on.mjs`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.mjs), this file implements the `SessionStart` hook that checks for `~/.claude/.i-have-adhd-always`. If detected, the hook automatically injects the content of [[`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) at session initialization. To disable always-on mode without uninstalling, simply remove the flag file: ```bash rm ~/.claude/.i-have-adhd-always ``` ## Plugin Management and Uninstallation To completely remove the skill from your Claude Code environment, execute the uninstall commands in sequence. First, remove the plugin installation, then deregister it from the marketplace, and finally clean up the always-on flag if present. ```bash # Uninstall the plugin claude plugin uninstall i-have-adhd # Remove from marketplace index claude plugin marketplace remove i-have-adhd # Clean up flag file (if exists) rm -f ~/.claude/.i-have-adhd-always ``` ## Key Source Files and Architecture Understanding the file structure confirms how the multi-runtime pattern is implemented: - **[[`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md)** – Contains the complete Claude Code installation sequence, including marketplace commands and the always-on flag instructions. - **[[`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json)](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json)** – Stores metadata (name, version, description) that Claude Code reads to identify the plugin during the marketplace add operation. - **[`hooks/always-on.mjs`](https://github.com/ayghri/i-have-adhd/blob/main/hooks/always-on.mjs)** – Implements the `SessionStart` lifecycle hook that automatically loads [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) when the flag file is detected. - **[[`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)** – The core ruleset file containing the ADHD-specific formatting instructions and behavioral guidelines applied to Claude Code output. ## Summary - The **multi-runtime install pattern** uses a three-phase workflow: marketplace registration, tag-based installation, and manual or automatic invocation. - Register the plugin using `claude plugin marketplace add ayghri/i-have-adhd`, then install with `claude plugin install i-have-adhd@i-have-adhd`. - Invoke manually with `/i-have-adhd` or enable automatic loading by creating `~/.claude/.i-have-adhd-always`, which triggers the `SessionStart` hook in `hooks/always-on.mjs`. - The plugin metadata in [`.claude-plugin/plugin.json`](https://github.com/ayghri/i-have-adhd/blob/main/.claude-plugin/plugin.json) and rules in [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) are fetched according to the tag matching the default branch. ## Frequently Asked Questions ### What is the multi-runtime install pattern for i-have-adhd? The multi-runtime install pattern is a standardized deployment workflow shared across Claude Code, Codex, and OpenCode agents. It requires adding the repository to a local marketplace index, installing a specific version using a branch-based tag (e.g., `i-have-adhd@i-have-adhd`), and invoking the skill via slash command or automatically via SessionStart hooks. This pattern ensures consistent behavior across different AI agent runtimes without requiring separate builds for each platform. ### How does the always-on mode work in Claude Code? The always-on mode relies on a flag file and a lifecycle hook. When you create `~/.claude/.i-have-adhd-always`, the `SessionStart` hook defined in `hooks/always-on.mjs` detects this file at the beginning of every new Claude Code session. The hook then automatically injects the ruleset from [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) into the conversation context, eliminating the need to manually type `/i-have-adhd` for each session. ### Why is the installation tag formatted as `i-have-adhd@i-have-adhd`? The tag format follows the convention `repository-name@branch-name`. According to the source documentation in [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md), using `i-have-adhd@i-have-adhd` ensures Claude Code fetches the plugin from the repository's default branch (also named `i-have-adhd`), guaranteeing you receive the latest stable version of the ADHD interaction ruleset. ### How do I completely uninstall i-have-adhd from Claude Code? To fully remove the skill, run `claude plugin uninstall i-have-adhd` to delete the plugin files, followed by `claude plugin marketplace remove i-have-adhd` to remove the marketplace entry. If you enabled always-on mode, also delete the flag file by running `rm ~/.claude/.i-have-adhd-always` to prevent the SessionStart hook from attempting to load missing resources.