opencode-upkeep-and-maintenance

What problem does it solve?

OpenCode’s sidebar can drift from the actual git working tree, leaving stale snapshot references behind. This skill provides a safe, auditable workflow to restore alignment between the sidebar state and the repository, with built-in safeguards such as backups and explicit user approvals.

Core Features & Use Cases

• Safety-first maintenance workflow: backup the database, require explicit user consent, and validate the target session status before any actions.
• Reset Sidebar Baseline: realign the sidebar with the current repo state when drift is detected.
• Session Pruning and Playbooks: identify and prune ephemeral or obsolete sessions to reclaim space while preserving important history.
• Cache and Plugin Hygiene: provide guidance for clearing caches and avoiding stale artifacts that impact OpenCode behavior.
• Audit-ready workflows: maintain an action trail with confirmations for reproducible maintenance.

Quick Start

Backup the OpenCode database, obtain explicit user approval to disable native rollbacks, verify the target session is idle, and run oc-refresh-diff <session-id> to reset the baseline.