housekeep

Automates Git repository maintenance tasks like pruning stale worktrees and branches.

86|20|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/optave/ops-codegraph-tool --skill housekeep-optave
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: housekeep
Source: https://github.com/optave/ops-codegraph-tool/tree/main/.claude/skills/housekeep
Command: npx skills add https://github.com/optave/ops-codegraph-tool --skill housekeep-optave

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill centralizes and automates the repetitive maintenance tasks that keep a code repository healthy, reducing drift, stale worktrees, and clutter that slow development workflows.

Core Features & Use Cases

  • Safe, idempotent housekeeping phases that prune stale worktrees, remove dirt files, and verify repo health without affecting tracked data.
  • Sync operations with main, clean dirt, prune merged branches, and generate a local health report for developers and operators.

Quick Start

Run housekeep to clean stale worktrees, remove dirt files, sync with main, prune branches, and verify repo health.

Frequently Asked Questions about housekeep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prune stale worktrees and clean up local git repositories?

To prune stale worktrees and clean up local git repositories, you can automate maintenance tasks that remove dirt files, sync with main, and verify repo health safely. This process uses idempotent phases with dry-run support and guardrails to prevent deleting tracked files.

What is the best way to automate branch hygiene across multiple worktrees in a codebase?

Automating branch hygiene across multiple worktrees involves running a centralized maintenance process that prunes merged branches, removes dirt files, and syncs operations with the main branch. This keeps the codebase healthy and reduces workflow drift without affecting tracked data.

Can I safely remove dirt files from my codebase without deleting tracked git data?

Yes, you can safely remove dirt files from your codebase without deleting tracked git data by using maintenance scripts equipped with guardrails. These automated phases are idempotent and feature dry-run support to ensure only untracked clutter is removed.

How do I generate a local health report for my git repository?

You generate a local health report for your git repository by running an automated maintenance routine that verifies repo health, syncs with main, and prunes merged branches. The resulting report highlights stale worktrees and overall codebase status.

Does automated repo cleanup work with multiple local worktrees at once?

Automated repo cleanup works effectively with multiple local worktrees by applying idempotent housekeeping phases across the entire codebase. It prunes stale worktrees and cleans dirt files while maintaining strict guardrails to prevent accidental deletion of active worktrees or tracked files.