How to Use i-have-adhd with Pi or OMP: Installation and Configuration Guide

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 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 file, ensuring consistent behavior across platforms.

Installing i-have-adhd on Pi

Pi discovers the repository as a native package through its extensions mechanism.

# 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

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

# 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

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

# 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

# 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

# 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	Canonical rule set loaded by both runtimes
extensions/	Pi-specific extension entry point
plugins/	OMP plugin manifest for marketplace registration
INSTALL.md	Platform-specific installation instructions

The SKILL.md file at 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 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 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.

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