A collection of guides, tips, and configuration scripts for AI coding agents, development tools, and system setups. This repository documents best practices, workarounds, and configurations discovered through real-world usage of AI assistants and development environments.

Critical safety hook for Claude Code to prevent data loss

After an AI agent accidentally destroyed hours of uncommitted work by running git checkout -- on multiple files, this guide was created to provide a mechanical enforcement system to prevent such incidents.

What it does:

• Blocks destructive git/filesystem commands before execution
• Uses Claude Code's PreToolUse hook system
• Protects against git checkout --, git reset --hard, rm -rf, and more
• Includes automated installation script for project-local or global setup

Key Features:

• Runs before bash commands execute (can block dangerous operations)
• Provides clear feedback explaining why commands are blocked
• Maintains allowlist for safe command variants
• Zero false positives on normal workflows

Quick Install:

See the full installation guide for the automated setup script that can be used for both project-local and global installation.

⚠️ Important: Restart Claude Code after installation for hooks to take effect.

Configuration guide for Beads project management tool

Comprehensive setup instructions for using Beads in a repository, including sync branch configuration, common commands, and troubleshooting.

Key Topics:

• Initial setup with dedicated sync branches to avoid worktree conflicts
• Sync commands reference (bd sync, bd sync --from-main, etc.)
• Configuration management (bd config)
• Troubleshooting worktree errors and sync issues
• Health checks with bd doctor

Quick Setup:

git branch beads-sync main
git push -u origin beads-sync
bd config set sync.branch beads-sync

Resolving PATH conflicts between native and bun/npm installations

After installing Claude Code natively via curl, users may encounter version conflicts when older bun/npm installations remain in PATH. This guide diagnoses and fixes the issue.

Symptoms:

• claude --version shows old version despite fresh install
• "Auto-update failed" errors
• claude doctor shows "Currently running: unknown"

The Fix:

• Use explicit paths in shell aliases (~/.local/bin/claude)
• Update the update alias to use native updater
• Remove stale symlinks from bun/npm installations
• Comparison of native vs package manager installs for Claude Code, Codex, and Gemini CLI

Complete guide for remote desktop streaming with Moonlight and Sunshine

Documents a working setup for streaming from a powerful Linux workstation (threadripperje with dual RTX 4090s) to a Mac client using Moonlight with AV1 encoding.

Configuration:

• Server: Sunshine on Hyprland (Wayland) with NVENC encoding
• Client: Custom Moonlight build with AV1 support
• Resolution: 3072x1728@30fps via AV1 codec
• Clipboard sync scripts and desktop switching utilities

Common Issues Covered:

• Display sleep/wake problems
• GPU AV1 support errors
• Fullscreen escape methods
• Clipboard synchronization workarounds
• NVIDIA persistence mode setup

Quick Reference Commands:

ml      # Start Moonlight streaming
trj     # SSH into remote server
wu      # Wake up remote display
cptl    # Copy clipboard to Linux
cpfm    # Copy clipboard from Mac

This repository is useful for:

• AI Agent Users: Configure safety guardrails and optimize tool usage
• DevOps Engineers: Learn from real-world tool configurations and workarounds
• Remote Workers: Set up high-performance remote desktop streaming
• Development Teams: Implement project management tools like Beads
• System Administrators: Document complex multi-tool configurations

1. Browse the guides in the table of contents above
2. Identify the tools you're using (Claude Code, Beads, Moonlight, etc.)
3. Follow the relevant guide for setup and configuration
4. Check troubleshooting sections if you encounter issues

If you use AI coding agents, start with the Destructive Git Command Protection guide. The hook system can prevent data loss from accidental destructive commands. This is especially important if multiple agents or developers work on the same codebase.

Each guide follows a consistent structure:

• Problem Statement: What issue does this solve?
• Quick Reference: Tables and commands for fast lookup
• Configuration: Complete setup instructions
• Troubleshooting: Common issues and solutions
• Examples: Real-world usage patterns

Tools and technologies covered:

• AI Agents: Claude Code, Codex, Gemini CLI
• Version Control: Git, with safety hooks and best practices
• Project Management: Beads
• Remote Desktop: Moonlight, Sunshine, Hyprland
• Package Managers: bun, npm, native installers
• Operating Systems: macOS, Linux (Ubuntu/Arch)
• Hardware: NVIDIA GPUs, multi-monitor setups

This repository contains documentation and configuration files. Use freely for personal or commercial projects.

• Claude Code Documentation
• Beads Project
• Moonlight Game Streaming
• Sunshine Streaming Server

Last Updated: December 2025