acidgenomics/koopa
Use koopa to install apps, manage shell activation, and troubleshoot the koopa environment in any project.
What the koopa plugin's agent guard hooks block or ask about, why, and the correct alternative for each. Use when a koopa hook blocked or asked about a command or a file write, when a deny message names a script such as block_uv.py or guard_rm.py, or when the user asks what the koopa plugin guards do and how to configure them.
Claude Code permission system internals, protected paths, permission modes, allow/ask/deny rule precedence, and the PreToolUse permissionDecision hook contract. Use when debugging unexpected permission prompts, understanding why Edit(.claude/**) or Bash(*) allow rules have no effect on .claude/ writes, reasoning about acceptEdits vs plan vs bypassPermissions mode tradeoffs, or a headless claude -p call that hangs with no output.
Command syntax for koopa, a shell bootloader that installs apps into its own prefix instead of the system package manager. Use when a task calls for installing a CLI tool, updating apps, or listing what koopa manages, so you reach for koopa install/koopa update/koopa list instead of brew, apt, or pip install --user.
Why a tool resolves inside the koopa prefix instead of Homebrew or the system, how to check that, and how koopa activation behaves in non-interactive and agentic sessions. Use when a command resolves to an unexpected binary, when PATH order looks wrong, or when working inside an SSH/CI/agent harness session that needs koopa's tools on PATH, when asking which shell an agent runs, or what KOOPA_BUCKET is.
Rewrite git history safely with git filter-repo. Use when removing secrets or sensitive files from commits, rewriting author/committer emails across history, de-duplicating doubled commits, or any commit-level surgery.
Diagnose and recover from common git branch/state accidents, wrong-branch reset, git alias side effects, untracked-file checkout collisions, and stash cleanup. Use when a git command moved the wrong branch pointer, a checkout was blocked by untracked files, or stash noise is showing in the prompt.
Guide for maintaining and optimizing Claude Code configuration (CLAUDE.md, rules files, hooks, and skills). Use when auditing instruction bloat, deciding where a new rule belongs, or pruning stale content.
Python virtual environment lessons, why moving a project directory breaks .venv/bin/activate's hardcoded absolute path, and why direnv's PATH_add is relocation-proof where source activate is not. Use when a console-script entry point becomes "command not found" after moving a project directory, when writing or debugging a .envrc that activates a Python venv, or when deciding between PATH_add and source activate under direnv's strict_env.
Org-mode todo.org conventions for project task tracking. Use when the user pastes a ** TODO heading, asks about project TODOs or plans, or when deciding where to track tasks or mark work complete.
Diagnostic commands for a koopa installation (system checks, environment info, install logs, and stale app-version cleanup). Use when a koopa-managed tool misbehaves, an install failed, or you need a full report of koopa's version, prefix, and platform before debugging further.
Workflow orchestration guidance, plan mode etiquette, subagent discipline, session hygiene, and git commit conventions. Use when asked about plan mode, how to structure multi-step work, when to use subagents, or when making a git commit.