explaingit

natebjones-projects/clean-my-ai-harness

Analysis updated 2026-05-18

12Audience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A read only reviewer that inspects your AI coding assistant's hidden setup files and only changes what you explicitly approve.

Mindmap

mindmap
  root((repo))
    What it does
      Audits AI setup files
      Reports risks and drag
      Applies only approved changes
    Tech stack
      Python
      Claude skill
      Codex skill
    Use cases
      Setup audit
      Safe cleanup
      Rollback support
    Audience
      Claude and Codex users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a read only audit of the hidden configuration and custom instructions behind your Claude or Codex setup.

USE CASE 2

Approve or reject individual cleanup recommendations in plain chat before anything changes.

USE CASE 3

Receive a plain English changelog and rollback path after applying approved changes.

USE CASE 4

Spot AI setup files that add friction without actually protecting your work.

What is it built with?

Python

How does it compare?

natebjones-projects/clean-my-ai-harness0xdea/ttyinject-rs0xhossam/uncanny
Stars121212
LanguageRustC
Setup difficultyeasymoderatehard
Complexity2/54/55/5
Audiencedeveloperresearcherresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Choose the zip matching your AI tool (Claude or Codex) and follow the INSTALL.md inside it.

Free to use, modify, and share, including commercially, except you cannot sell this tool itself or a competing version of it.

In plain English

Clean My AI Harness is a tool that inspects the hidden configuration files, custom instructions, and setup around your AI coding assistant, then shows you what is protecting your work and what is just adding friction, so you can safely clean it up. The first time you run it, nothing changes. It only produces a report, and you have to approve any changes yourself before the tool touches anything. There are two separate editions, one for Claude, covering Claude.ai and Claude Code, and one for Codex, covering OpenAI's Codex, and you download whichever zip file matches the AI tool you actually use. Each zip includes its own install instructions. For the Claude edition, you enable code execution and file creation, then upload the zip as a skill through the Customize menu. The Codex edition needs Python 3.10 or newer and gets copied into a specific skills folder in your home directory. Once installed, you open the project you want reviewed and ask the assistant to review its AI setup, starting in a read only mode that only shows what it would change. The output is a single visible report file that lists what shapes your AI's behavior, what protects your work, what is creating unnecessary drag, and what the cleaner recommends changing. You can approve specific numbered items in plain chat, such as approving items one and three while leaving item two alone, and the tool then writes a plain English summary of exactly what changed along with a way to roll the changes back. On safety, the README states that the cleaner treats every file it inspects as untrusted, never follows instructions hidden inside those files, and makes no changes until you explicitly approve each one. The license lets you use, modify, and share it freely, including in commercial work, with the one restriction being that you cannot resell the tool itself or a competing version of it.

Copy-paste prompts

Prompt 1
Review the AI setup for this project. Start read-only and show me what you would keep or change.
Prompt 2
Approve items 1 and 3 from the AI setup report and leave item 2 unchanged.
Prompt 3
Explain what WHAT-CHANGED.md means after Clean My AI Harness applies my approved changes.
Prompt 4
Help me install the Claude edition of Clean My AI Harness as a skill in Claude.ai.

Frequently asked questions

What is clean-my-ai-harness?

A read only reviewer that inspects your AI coding assistant's hidden setup files and only changes what you explicitly approve.

What license does clean-my-ai-harness use?

Free to use, modify, and share, including commercially, except you cannot sell this tool itself or a competing version of it.

How hard is clean-my-ai-harness to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is clean-my-ai-harness for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.