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

To completely uninstall UditAkhourii/adhd, remove the npm package adhd-agent using npm uninstall and delete the 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) 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 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:

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:

npm uninstall adhd-agent

Run this command from the project root containing your node_modules folder. This updates your 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 file located at 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:

rm -rf ~/.codex/skills/adhd

This deletes the copied 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:

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

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:

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 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. 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 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. The skill file (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.

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