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

> Learn how to use i-have-adhd with Gemini! This guide shows you how to enable ADHD-friendly output in the Gemini CLI for clearer, more accessible responses.

- Repository: [Ayoub Ghriss/i-have-adhd](https://github.com/ayghri/i-have-adhd)
- Tags: how-to-guide
- Published: 2026-08-31

---

**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`](https://github.com/ayghri/i-have-adhd/blob/main/gemini-extension.json)—Extension Registration

The file [`gemini-extension.json`](https://github.com/ayghri/i-have-adhd/blob/main/gemini-extension.json) registers **i‑have‑adhd** as an official Gemini extension. It points Gemini to [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) for behavioral documentation.

### [`skills/i-have-adhd/agents/gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md).

### [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) and [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md)—Behavioral Rules

[`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) provides human‑readable setup instructions and imports [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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

```bash

# 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`](https://github.com/ayghri/i-have-adhd/blob/main/gemini-extension.json) | Registers extension with Gemini CLI |
| [`skills/i-have-adhd/agents/gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/agents/gemini.toml) | Defines `/i-have-adhd` command |
| [`GEMINI.md`](https://github.com/ayghri/i-have-adhd/blob/main/GEMINI.md) | Human-readable description and setup guide |
| [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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

```text
/i-have-adhd

```

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

### Example Interaction

```text
/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/agents/gemini.toml)

This file contains the prompt injection that Gemini loads. It references [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/SKILL.md) via relative path, keeping the behavioral rules modular and maintainable.

### [`skills/i-have-adhd/SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/gemini.toml) to `~/.gemini/commands/`
- Activate with the `/i-have-adhd` slash command in any session
- Output follows 10 rules from [`SKILL.md`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/skills/i-have-adhd/SKILL.md) and restart your Gemini session. Because [`gemini.toml`](https://github.com/ayghri/i-have-adhd/blob/main/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`](https://github.com/ayghri/i-have-adhd/blob/main/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.