opencode-trash-guard

An OpenCode plugin that intercepts dangerous rm -rf commands and rewrites them to use trash for safer file deletion.

Why?

rm -rf permanently deletes files with no recovery. trash moves files to the system Trash instead, allowing recovery if needed. This plugin protects you from accidental data loss when using AI coding agents.

Installation

Add to your OpenCode config (~/.config/opencode/opencode.json or .opencode/opencode.json):

{
  "plugin": ["opencode-trash-guard"]
}

How it works

By default (rewrite mode), when the AI tries to run rm -rf, the plugin:

1. Intercepts the command before execution
2. Rewrites it to use trash instead
3. Shows feedback so the model learns to use trash directly

Works regardless of OpenCode's permission settings (even in auto-approve mode).

Configuration

Set environment variables to customize behavior:

| Variable | Values | Default | Description | |----------|--------|---------|-------------| | TRASH_GUARD_MODE | rewrite, deny | rewrite | Rewrite to trash or block entirely | | TRASH_GUARD_LEVEL | normal, strict | strict | What patterns to catch | | TRASH_GUARD_ALLOWLIST | comma-separated | - | Patterns to skip (e.g., node_modules,dist) | | TRASH_GUARD_COMMAND | path | trash | Custom trash binary |

Detection levels

normal:

• rm -rf <path>
• rm -fr <path>
• rm -r -f <path>
• rm --recursive --force <path>

strict (default, catches more):

• All of the above
• rm -r <path> (recursive without force)
• rm *, rm *.js (wildcards)

Trash Command

The plugin requires a trash command. Most systems have one:

| Platform | Command | Notes | |----------|---------|-------| | macOS 15+ | /usr/bin/trash | Built-in ✓ | | Linux | gio trash | Pre-installed on most desktops | | macOS <15 | brew install trash | Via Homebrew |

Example

When the AI runs:

rm -rf ./old-build

The plugin rewrites it to:

trash ./old-build

And shows feedback:

⚠️ trash-guard: Rewrote destructive rm command to use trash
💡 Tip: Use 'trash <path>' directly for safer deletion

License

MIT

Links

• GitHub
• OpenCode