How to Install i-have-adhd on Claude Code Using the Multi-Runtime Install Pattern

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

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#claude-code), the tag follows the pattern name@branch.

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

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:

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

According to 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) at session initialization.

To disable always-on mode without uninstalling, simply remove the flag file:

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.

# 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) – 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) – Stores metadata (name, version, description) that Claude Code reads to identify the plugin during the marketplace add operation.
• hooks/always-on.mjs – Implements the SessionStart lifecycle hook that automatically loads 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) – 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 and rules in 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 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, 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.

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