Can i‑have‑adhd Be Used with Gemini? Yes—Here's How to Enable ADHD‑Friendly Output in the Gemini CLI

Yes, i‑have‑adhd includes a native Gemini CLI integration that automatically reformats responses for ADHD readers using a declarative extension and custom command.

The i‑have‑adhd repository by ayghri provides a dedicated Gemini integration that shapes every Gemini response to be more accessible for users with attention differences. This integration requires no code changes—only copying configuration files into your Gemini setup.

How the Gemini Integration Works

The integration relies on three coordinated components that tell Gemini how to structure its output.

gemini-extension.json—Extension Registration

The file gemini-extension.json registers i‑have‑adhd as an official Gemini extension. It points Gemini to GEMINI.md for behavioral documentation.

skills/i-have-adhd/agents/gemini.toml—Command Definition

This TOML file defines the /i-have-adhd slash command. When invoked, Gemini loads the prompt from this file, which wraps the canonical rules from SKILL.md.

GEMINI.md and SKILL.md—Behavioral Rules

GEMINI.md provides human‑readable setup instructions and imports skills/i-have-adhd/SKILL.md. The skill file contains 10 ADHD‑friendly response rules that enforce:

• Leading with the next concrete action
• Numbering multi‑step work
• Restating the current state
• Suppressing tangential content
• Providing precise time estimates

Installing i‑have‑adhd for Gemini

Follow these steps to activate the integration.

Step 1: Copy the Command Definition

# Create the Gemini commands directory if it doesn't exist

mkdir -p ~/.gemini/commands

# Copy the TOML command file

cp /path/to/i-have-adhd/skills/i-have-adhd/agents/gemini.toml \
   ~/.gemini/commands/i-have-adhd.toml

Step 2: Verify the Extension Files

Ensure these files are present in your i‑have‑adhd installation:

File	Purpose
gemini-extension.json	Registers extension with Gemini CLI
skills/i-have-adhd/agents/gemini.toml	Defines /i-have-adhd command
GEMINI.md	Human-readable description and setup guide
skills/i-have-adhd/SKILL.md	Core 10 rules for ADHD‑friendly formatting

Using the /i-have-adhd Command in Gemini

Once installed, invoke the command in any Gemini session.

Command Invocation

/i-have-adhd

After activation, all subsequent responses follow the ADHD‑friendly format.

Example Interaction

/i-have-adhd
> Create a new README for the project.
1. Open the repository root in your editor. (≈ 30 seconds)
2. Add a top-level heading with the project name. (≈ 1 minute)
3. Write a short description of the purpose. (≈ 2 minutes)
4. Save the file.
Next: Run `git add README.md && git commit -m "Add README"` to version it.

Notice the output structure: numbered steps, time estimates in parentheses, and a clear "Next" action at the end.

Key Files and Their Roles

Understanding the source layout helps with customization or troubleshooting.

skills/i-have-adhd/agents/gemini.toml

This file contains the prompt injection that Gemini loads. It references SKILL.md via relative path, keeping the behavioral rules modular and maintainable.

skills/i-have-adhd/SKILL.md

The canonical source of truth for ADHD‑friendly formatting. Modify this file to adjust the 10 rules, and changes propagate automatically through the Gemini command.

GEMINI.md

Serves dual purpose: documentation for humans and import bridge for the extension system. It uses standard Markdown includes to pull in SKILL.md.

Benefits of the Declarative Approach

The i‑have‑adhd Gemini integration uses zero executable code. The declarative JSON/TOML/Markdown architecture means:

• No runtime dependencies beyond Gemini CLI itself
• Easy auditing—all behavior is visible in plain text files
• Simple version control—track changes to rules as you would any documentation
• Cross-platform compatibility—works wherever Gemini CLI runs

Summary

• i‑have‑adhd can be used with Gemini via a native CLI extension
• Install by copying gemini.toml to ~/.gemini/commands/
• Activate with the /i-have-adhd slash command in any session
• Output follows 10 rules from SKILL.md: action‑first, numbered steps, time estimates, and suppressed tangents
• The integration is declarative—no code compilation or dependencies required

Frequently Asked Questions

Does i‑have‑adhd require a separate Gemini API key?

No. The integration works through the standard Gemini CLI configuration. As long as your Gemini CLI is already authenticated, the /i-have-adhd command inherits those credentials. No additional API keys or authentication steps are needed.

Can I customize the 10 ADHD‑friendly rules in Gemini?

Yes. Edit skills/i-have-adhd/SKILL.md and restart your Gemini session. Because gemini.toml loads rules dynamically from this file, changes take effect immediately without recompiling or reinstalling the extension.

Will i‑have‑adhd work with other LLM tools besides Gemini?

The repository includes integrations for multiple agents. While the gemini.toml file is specific to Gemini CLI, parallel files exist for other platforms. Check skills/i-have-adhd/agents/ for additional tool configurations.

What happens if I forget to run /i-have-adhd in a session?

Gemini will use its default output format. The command must be invoked each session to activate ADHD‑friendly formatting. Consider adding /i-have-adhd to your Gemini startup configuration if you want it always enabled.

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