# How to Use i-have-adhd with Pi or OMP: Installation and Configuration Guide > Install and configure i-have-adhd for Pi or Oh My Pi. Use the /i-have-adhd command to enable ADHD-friendly output and enhance your workflow. - Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd) - Tags: how-to-guide - Published: 2026-08-31 --- **Use the `/i-have-adhd` command to toggle ADHD-friendly output in Pi or Oh My Pi after installing the package via their respective extension mechanisms.** The *i‑have‑adhd* repository provides a single skill definition that formats AI responses for ADHD-friendly consumption. Both **Pi** and **Oh My Pi (OMP)** discover this repository as a native package through their extensions system, reading the canonical rules from [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) without duplicating the source text. ## How the Extension Architecture Works Each runtime uses a lightweight wrapper to load the `skills/` folder at startup. These wrappers register a session-persistent command that inserts the rule set once per conversation. - **Pi**: The wrapper lives in `extensions/` and registers the command directly. - **OMP**: The plugin registers via the OMP marketplace using the manifest in `plugins/`. Both runtimes reference the same [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file, ensuring consistent behavior across platforms. ## Installing i-have-adhd on Pi Pi discovers the repository as a native package through its extensions mechanism. ```bash # Install the package pi install https://github.com/ayghri/i-have-adhd ``` After installation, start a new Pi session. The skill becomes available immediately but requires activation. ### Activating ADHD Mode in Pi ```bash # Toggle the mode on or off /i-have-adhd # Explicit on/off control /i-have-adhd on /i-have-adhd off # Alternative disable command stop adhd mode ``` When active, the footer displays **● ADHD ON**. ### Enabling Always-On Mode for Pi Create a flag file to automatically enable ADHD mode at every session start: ```bash # Enable always-on mode touch ~/.pi/agent/.i-have-adhd-always # Disable later rm ~/.pi/agent/.i-have-adhd-always ``` This mimics the "always-on" behavior of Claude Code's `SessionStart` hook. ### Updating and Removing Pi ```bash # Update to latest version pi update https://github.com/ayghri/i-have-adhd # Complete removal pi remove https://github.com/ayghri/i-have-adhd ``` ## Installing i-have-adhd on Oh My Pi (OMP) OMP uses its plugin marketplace to discover and install the skill. ```bash # Add to marketplace and install omp plugin marketplace add ayghri/i-have-adhd omp plugin install --scope user i-have-adhd@i-have-adhd ``` ### Activating ADHD Mode in OMP ```bash # Start a new OMP session, then toggle /i-have-adhd ``` The same activation pattern applies: the command inserts the rule set once per conversation. ### Updating and Removing OMP ```bash # Update via marketplace omp plugin marketplace update i-have-adhd # Uninstall and remove from marketplace omp plugin uninstall --scope user i-have-adhd@i-have-adhd omp plugin marketplace remove i-have-adhd ``` ## Key Files and Source Locations | File | Purpose | |------|---------| | [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) | Canonical rule set loaded by both runtimes | | `extensions/` | Pi-specific extension entry point | | `plugins/` | OMP plugin manifest for marketplace registration | | [`INSTALL.md`](https://github.com/ayghri/i-have-adhd/blob/main/INSTALL.md) | Platform-specific installation instructions | The [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) file at [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) serves as the single source of truth. Neither Pi nor OMP duplicates these rules—they read directly from this location at runtime. ## Command Reference Summary | Command | Platform | Effect | |---------|----------|--------| | `/i-have-adhd` | Both | Toggle ADHD mode | | `/i-have-adhd on` | Both | Explicitly enable | | `/i-have-adhd off` | Both | Explicitly disable | | `stop adhd mode` | Both | Alternative disable | | `touch ~/.pi/agent/.i-have-adhd-always` | Pi only | Enable always-on | ## Summary - Install via `pi install` or `omp plugin marketplace add` depending on your runtime. - Activate with `/i-have-adhd` after starting a new session. - Enable always-on mode in Pi using `~/.pi/agent/.i-have-adhd-always`. - Both platforms read rules from [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) directly—no configuration file editing required. - Update or remove using native package commands for each platform. ## Frequently Asked Questions ### Does i-have-adhd work automatically after installation? No. After installing the package in Pi or OMP, you must start a new session and run `/i-have-adhd` to activate the mode. The skill registers as available but remains inactive until explicitly toggled. ### Can I make ADHD mode permanent without typing the command each time? Yes. For Pi, create the file `~/.pi/agent/.i-have-adhd-always` to enable automatic activation at every session start. OMP does not currently document an equivalent always-on flag. ### Where are the actual formatting rules stored? All rules live 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. Both Pi and OMP read this file directly through their extension systems—rules are never copied or duplicated in user configuration directories. ### What happens if I run `/i-have-adhd` multiple times? The command acts as a toggle. Each invocation switches between on and off states. The footer indicator **● ADHD ON** appears when active and disappears when disabled.