💀 Deadswitch — Digital Will Executor for Developers

Your code deserves closure.

Deadswitch is an automated digital will for your GitHub repositories. If you go inactive for a configurable period (default: 90 days), Deadswitch executes your pre-defined final wishes.

No one wants their repos to rot in silence. Deadswitch ensures your code finds a new home — or at least gets a proper goodbye.

Quick Start

# Install
pip install deadswitch

# Arm the switch
cd your-repo
deadswitch init

# Check your pulse
deadswitch check <your-github-username>

# Push to activate
git add . && git commit -m "arm deadswitch" && git push

How It Works

1. You run deadswitch init in your repo
2. It creates a GitHub Action that runs daily
3. The action checks your last GitHub activity
4. If you've been inactive > N days (default 90)...
5. Your digital will executes automatically

Will Presets

Preset	What Happens
unmaintained	Adds unmaintained badge + opens "needs maintainer" issue
opensource	Makes private repos public with MIT license
archive	Archives repos with a farewell README commit
full	Everything: archive, notify, open-source, and farewell

Commands

deadswitch init              # Set up digital will
deadswitch init --days 30    # Shorter threshold
deadswitch init --preset full # Full will
deadswitch check <username>  # Check someone's pulse
deadswitch status            # View current config
deadswitch trigger           # Execute will NOW (careful!)

Configuration

After deadswitch init, your repo gets:

.deadswitch.json              # Your digital will config
.github/workflows/
  deadswitch.yml              # The GitHub Action

Edit .deadswitch.json to customize:

{
  "deadswitch": {
    "inactivity_days": 90,
    "preset": "unmaintained"
  }
}

Philosophy

"The graveyards are full of indispensable men." — Charles de Gaulle

Every developer has repos they've abandoned. Deadswitch isn't morbid — it's responsible. It's the open-source equivalent of a living will. Your code contributed something. Don't let it die in silence.

Deadswitch ensures:

• Transparency: Contributors know a project is unmaintained
• Continuity: Someone can pick up the torch
• Closure: Your code gets a proper ending

Requirements

• Python 3.10+
• A GitHub repository
• A heart (optional)

License

MIT © 2026 Gracestack

---

💀 Built with morbid curiosity by Gracestack