Install

← back to README

ADHD ships three ways: as an agent skill (works in Claude Code, Cursor, Antigravity, Codex, and ~50 more), as a CLI, and as a Node/TS library.

One command, every agent

npx skills add UditAkhourii/adhd

The skills CLI detects which agent you are using and drops skills/adhd/SKILL.md into the right place. Supports Claude Code, Claude.ai, Antigravity, Cursor, Codex, Cline, Continue, Aider, Gemini CLI, Windsurf, Cody, Roo, Augment, OpenCode, Kilo, Kimi, Qwen, Trae, Replit, Warp, and ~40 more.

Restart your agent. The skill auto-triggers on brainstorm, ideate, design, naming, refactor, and "give me a few ways to" intents. Or invoke it explicitly: /adhd "design a rate limiter that survives a leader election".

Useful flags:

npx skills add UditAkhourii/adhd -g            # install globally instead of per-project
npx skills add UditAkhourii/adhd -a claude-code -a cursor   # target specific agents
npx skills add UditAkhourii/adhd --copy        # copy files instead of symlinking
npx skills add UditAkhourii/adhd --list        # see what skills the repo offers

Codex (OpenAI)

If the universal command auto-detects Codex correctly, you are done. Some Codex builds have stricter skill-discovery rules — force the target and install globally if you hit trouble:

npx skills add UditAkhourii/adhd -a codex -g

Or install manually into Codex's skills directory:

mkdir -p ~/.codex/skills/adhd
curl -fsSL https://raw.githubusercontent.com/UditAkhourii/adhd/main/skills/adhd/SKILL.md \
  -o ~/.codex/skills/adhd/SKILL.md

Restart Codex. Invoke with /adhd "your problem".

Note on description length: the ADHD SKILL.md ships with a single-line description (≤600 chars) specifically because some Codex builds truncate or fail on multi-line YAML block-scalar descriptions. The full pre-flight gate logic lives in the body of the skill rather than the frontmatter for this reason. If you ever author your own skill and Codex refuses to load it, this is the first thing to check.

Manual install (if you do not have npx)

The skill file is at skills/adhd/SKILL.md. Curl it into your agent's skill directory:

# Claude Code (global)
mkdir -p ~/.claude/skills/adhd
curl -fsSL https://raw.githubusercontent.com/UditAkhourii/adhd/main/skills/adhd/SKILL.md \
  -o ~/.claude/skills/adhd/SKILL.md

# Claude Code (per-project)
mkdir -p .claude/skills/adhd
curl -fsSL https://raw.githubusercontent.com/UditAkhourii/adhd/main/skills/adhd/SKILL.md \
  -o .claude/skills/adhd/SKILL.md

# Cursor (project rules)
curl -fsSL https://raw.githubusercontent.com/UditAkhourii/adhd/main/skills/adhd/SKILL.md >> .cursorrules

For Claude.ai web/desktop: open project settings → Skills → Add skill → upload skills/adhd/SKILL.md.

For Cline, Continue, Aider, Roo Code, and other agents: paste the body of SKILL.md (skip the YAML frontmatter) into your agent's system prompt or rules field.

Programmatic install (Agent SDK)

import { query } from "@anthropic-ai/claude-agent-sdk";
import { readFileSync } from "node:fs";

const skill = readFileSync("./skills/adhd/SKILL.md", "utf8");

for await (const m of query({
  prompt: "design a retry strategy for a CLI whose LLM hangs for 90s",
  options: {
    systemPrompt: { type: "preset", preset: "claude_code", append: skill },
    allowedTools: ["Task"],
  },
})) {
  // …
}

As a CLI (terminal usage, no agent needed)

npm install -g adhd-agent
adhd "design a rate limiter that survives a leader election"

Auth: picks up ANTHROPIC_API_KEY from the environment, or inherits auth from a local Claude Code install.

As a library (inside your own agent)

npm install adhd-agent

import { run } from "adhd-agent";
const result = await run({ problem: "...", framesPerRun: 5, topK: 3 });

See api.md for the full library and CLI reference.

From source

git clone https://github.com/UditAkhourii/adhd.git
cd adhd && npm install && npm run build