Version updated for https://github.com/GhrammR/the-janitor to version v6.5.0.

• This action is used across all versions by ? repositories.

Action Type

This is a Docker action.

Go to the GitHub Marketplace to find the latest changes.

Action Summary

The Janitor is a GitHub Action that automates the detection and removal of dead code, such as unused functions, classes, and files, across Python, Rust, JavaScript/TypeScript, and C++ codebases. It leverages a static analysis pipeline and test simulations to safely clean up unnecessary code while minimizing false positives, helping teams reduce technical debt and improve codebase maintainability. Additionally, it provides features like duplicate logic detection, code health monitoring, and optional compliance attestation for enterprise environments.

Release notes

The Janitor: Automated Dead Symbol Detection & Code Cleanup

Current Version: v6.5.0

Stop paying for code you don’t use.

The Janitor creates a Shadow Tree to verify deletion safety, then surgically removes dead code at the symbol level — functions, classes, and entire orphan files — across Python, Rust, JavaScript/TypeScript, and C++ codebases.

Don’t guess your technical debt. The Janitor generates a verifiable Code Health Badge so your team can surgically monitor the decay of the monolith before it impacts production.

How It Works

1. Scan — Static reference graph + 6-stage heuristic pipeline identifies every dead symbol.
2. Simulate — Shadow Tree overlays links to the dead files. Your test suite runs against the simulated deletion.
3. Remove — Tests pass? Dead code is removed bottom-to-top (byte-precise, UTF-8 hardened). Tests fail? Full rollback, zero corruption.

Quick Start

# Free: detect dead code
janitor scan ./src

# Free: find duplicate functions (structural clone detection)
janitor dedup ./src

# Free: simulate + remove (no token required)
janitor clean ./src --force-purge

Language Support

False-Positive Protection

17-variant protection system. Heuristics cover:

• FastAPI route decorators, dependency injection, lifespan teardown
• Pydantic validators, forward references, alias generators
• SQLAlchemy metaprogramming, hybrid properties, polymorphic mappers
• pytest fixtures, conftest.py, test fingerprinting
• Qt auto-connection slots, ORM lifecycle methods
• Plugin directories (Scrapy, Celery, Django management commands)
• Grep shield: Aho-Corasick scan of all non-Python files

Pricing

Automated Cleanup is Free. Integrity Proof is the Standard.

Get Certified → thejanitor.lemonsqueezy.com

CI Integration

- uses: GhrammR/the-janitor@v5
  with:
    path: ./src
    args: scan --verbose

For automated cleanup in CI (free):

- uses: GhrammR/the-janitor@v5
  with:
    args: clean --force-purge
    path: ./src

For signed attestation in CI (Lead Specialist tier):

- uses: GhrammR/the-janitor@v5
  with:
    args: clean --force-purge --token ${{ secrets.JANITOR_TOKEN }}
    path: ./src

Commands

License

Business Source License 1.1 (BSL 1.1) — Source Available. Converts to MIT on 2030-02-15.

Scan, cleanup, badge, and dashboard are permanently free. Integrity attestation (PQC-Signed Audit Logs, CI/CD Compliance Attestation) requires a Lead Specialist token.

• GhrammR
• GitHub Actions