# How to Uninstall UditAkhourii/adhd: Complete Removal Guide for npm Package and Agent Skills

> Learn how to uninstall UditAkhourii/adhd completely. This guide details removing the npm package and agent skills for a clean uninstallation.

- Repository: [Udit Akhouri/adhd](https://github.com/UditAkhourii/adhd)
- Tags: how-to-guide
- Published: 2026-07-30

---

**To completely uninstall UditAkhourii/adhd, remove the npm package `adhd-agent` using `npm uninstall` and delete the [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) file from your agent's skills directory.**

The `UditAkhourii/adhd` repository distributes two distinct components that require separate removal steps: the **npm package** (`adhd-agent`) providing the CLI and library code, and the **skill file** ([`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md)) that AI agents load into their context. According to the source code analysis, no background processes or hidden runtime components exist beyond these two artifacts, making uninstallation straightforward once both elements are addressed.

## Uninstall the npm Package (adhd-agent)

The primary distribution method for the CLI is the `adhd-agent` package published to npm. The [`package.json`](https://github.com/UditAkhourii/adhd/blob/main/package.json) defines the binary entry point on lines 8-10, creating the `adhd` command in your environment. Removing this package deletes the compiled files in `dist/` and the global binary.

### Global Installation

If you installed the tool globally using `npm install -g adhd-agent`, execute the global uninstall command:

```bash
npm uninstall -g adhd-agent

```

This removes the `adhd` binary from your system path and deletes the package files from your global npm directory.

### Local/Project Installation

For local installations within a specific project directory:

```bash
npm uninstall adhd-agent

```

Run this command from the project root containing your `node_modules` folder. This updates your [`package.json`](https://github.com/UditAkhourii/adhd/blob/main/package.json) dependencies and removes the local package files.

### Alternative Package Managers

If you used Yarn or pnpm instead of npm, use their respective removal commands:

- **Yarn**: `yarn remove adhd-agent`
- **pnpm**: `pnpm remove adhd-agent`

## Remove the Skill File from Agent Directories

The [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) file located at [`skills/adhd/SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/skills/adhd/SKILL.md) in the repository serves as the skill definition that agents like Codex or Claude Code load. Uninstalling this component requires deleting the file from wherever you copied it during installation.

### Codex

For OpenAI Codex, the default skill path is `~/.codex/skills/adhd`. Remove the directory completely:

```bash
rm -rf ~/.codex/skills/adhd

```

This deletes the copied [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) and any associated metadata Codex uses to load the skill.

### Claude Code

Anthropic's Claude Code loads skills from `~/.claude/skills/adhd`. Execute the removal command:

```bash
rm -rf ~/.claude/skills/adhd

```

This path mirrors the installation instructions found in the README's manual setup section.

### Claude.ai Web/Desktop

For the Claude web interface or desktop applications, skills are managed through the Settings UI. Navigate to **Settings → Skills**, locate the adhd skill in your uploaded skills list, and click delete. No terminal commands are required for browser-based installations.

### Other Agents (Cline, Continue, Aider, Roo Code)

Projects like Cline, Continue, or Roo Code typically require pasting the contents of [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) directly into custom prompts or rules. To uninstall:

- Open your agent's settings or `.rules` file
- Delete the text block containing the adhd skill definition
- Save the configuration file

If you created a custom directory (e.g., `.agents/skills/adhd`), remove it using:

```bash
rm -rf <your-path>/adhd

```

## Clean Up Local Repository Clones (Optional)

If you cloned the `UditAkhourii/adhd` repository locally for inspection or development, remove the source code:

```bash
rm -rf path/to/adhd

```

For example: `rm -rf ~/projects/adhd`. This step is purely optional and only necessary if you maintain a local copy of the source code that you no longer need.

## Summary

- **Uninstall the npm package** using `npm uninstall -g adhd-agent` (global) or `npm uninstall adhd-agent` (local) to remove the CLI binary and `dist/` compiled files
- **Delete skill files** from agent-specific directories: `~/.codex/skills/adhd` for Codex, `~/.claude/skills/adhd` for Claude Code, or via Settings UI for web-based agents
- **Remove repository clones** optionally using `rm -rf` on your local clone path
- **No hidden components** exist beyond the npm package and [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) copies, ensuring complete removal after these steps

## Frequently Asked Questions

### What files are safe to delete when uninstalling adhd?

You can safely delete the `adhd` directory under `~/.codex/skills/` or `~/.claude/skills/`, as well as any local clone of the `UditAkhourii/adhd` repository. The npm uninstall command automatically removes files in `dist/` and the `adhd` binary defined in [`package.json`](https://github.com/UditAkhourii/adhd/blob/main/package.json). No system-level configuration files or registry entries are created during installation.

### How do I verify the adhd CLI is fully removed?

Run `which adhd` (macOS/Linux) or `where adhd` (Windows) in your terminal. If the command returns no path, the binary has been successfully removed. Additionally, running `adhd --version` should return a "command not found" error, confirming the npm package `adhd-agent` no longer exists in your global or local `node_modules`.

### Do I need to restart my code editor after removing the skill?

Yes, restart your editor or reload the AI agent window to clear cached skill contexts. While deleting [`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md) from `~/.codex/skills/adhd` or `~/.claude/skills/adhd` removes the file from disk, agents like Claude Code and Codex may retain the skill in memory until the next session initialization.

### What is the difference between the npm package and the skill file?

The **npm package** (`adhd-agent`) provides the command-line interface and library code compiled to the `dist/` directory, as configured in the `bin` field of [`package.json`](https://github.com/UditAkhourii/adhd/blob/main/package.json). The **skill file** ([`SKILL.md`](https://github.com/UditAkhourii/adhd/blob/main/SKILL.md)) contains instructions and context that help AI agents understand how to use the adhd workflow. The npm package executes functionality, while the skill file configures agent behavior, which is why both must be removed to completely uninstall the project.