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

• 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 designed to identify and remove unused code (dead symbols) and duplicate logic across multiple programming languages, including Python, Rust, JavaScript/TypeScript, and C++. It automates static analysis to detect unused functions, classes, and files, simulates their removal to ensure safety, and performs byte-precise cleanup if tests pass, helping teams reduce technical debt and improve codebase maintainability. Additionally, it provides tools for code health monitoring, such as generating a Code Health Badge, and supports integrity proof and compliance for enterprise-level needs.

Release notes

The Janitor: Automated Dead Symbol Detection & Code Cleanup

Current Version: v6.1.7

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