* fix(trash): keep install metadata when restoring from the trash Uninstall pruned a skill's, tracked repo's or agent's entry from the central .metadata.json, and only the files went to the trash, so a restore brought back a remote install as a local one: update and check no longer knew its source (#679). Uninstall now saves the entries it prunes, with their audit acceptances and target overrides, beside the trash entry, re-keyed to the trash name so they match where restore puts the item. uninstall.Restore and RestoreAgent merge them back after the files return, and every restore path (CLI, trash TUI, dashboard) goes through them; the dashboard passes its cached store so it does not go stale. The saved copy is taken with the same rule RemoveByNames uses and copies each entry, so legacy repo-group entries are kept and re-keying never touches the live store. In project mode uninstall also drops the skill's .gitignore rule and lock pin, so a skill restore reconciles the project skills afterwards. trash.Delete removes an entry with its saved metadata, and replaces the direct RemoveAll calls in delete, empty and the 7-day cleanup. Items trashed before this change have no saved metadata and still restore as local. * fix(trash): keep live records of another path when restoring metadata A legacy store keys a grouped skill by its basename, so the saved copy of frontend/foo was keyed "foo". If a different skill was installed as root-level foo while frontend/foo sat in the trash, restoring it replaced the root skill's record and lost its source. Extract now writes full source-relative keys (legacy repo-group entries keep theirs, since their Group is not their path), and Merge keeps a live entry whose key names a different path instead of overwriting it. Merge is shared by skill and agent restore, so both are covered.
5.5 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
trash
Manage uninstalled skills and agents in the trash directory.
skillshare trash list # Interactive TUI (in TTY)
skillshare trash list --no-tui # Plain text output
skillshare trash restore my-skill # Restore from trash
skillshare trash restore my-skill -p # Restore in project mode
skillshare trash delete my-skill # Permanently delete from trash
skillshare trash empty # Empty the trash
skillshare trash agents list # List trashed agents
skillshare trash agents restore tutor # Restore an agent from trash
skillshare trash --all list # List trashed skills + agents
When to Use
- Recover a skill or agent you recently uninstalled (within 7 days)
- Permanently delete trashed items to free space
- Check what's in the trash before it auto-expires
Interactive TUI
In a TTY, trash list opens an interactive list of trashed items, newest first. Select one or more to restore them or delete them permanently, or empty the whole trash; each asks first. Opening an item shows its files, so you can check it before restoring. The keys are listed at the bottom of the screen. When using --all or without a kind filter, skills and agents are listed together.
If some items fail, for example restoring a skill whose name already exists in source, the rest are still processed and the result lists what failed.
Use --no-tui to skip the TUI and print plain text instead:
skillshare trash list --no-tui # Plain text output
skillshare trash list --no-tui | less # Pipe to pager manually
Kind Filter
By default, trash operates on skills. Use the agents positional keyword to target agents, or --all to include both:
skillshare trash list # Skills only (default)
skillshare trash agents list # Agents only
skillshare trash --all list # Both skills and agents
skillshare trash agents restore tutor # Restore a trashed agent
skillshare trash agents empty # Empty agent trash only
Subcommands
list (alias: ls)
Show all items currently in the trash. Launches the interactive TUI in a terminal, or prints plain text with --no-tui or in non-TTY:
skillshare trash list
skillshare trash agents list
skillshare trash --all list --no-tui
Plain text output:
Trash
my-skill 1.2 KB · 2d ago
old-helper 800 B · 5d ago
2 items, 2.0 KB
Each item is removed for good 7 days after it was trashed
restore
Restore the most recent trashed version back to the source directory:
skillshare trash restore my-skill
skillshare trash agents restore tutor
✓ Restore my-skill → ~/.config/skillshare/skills · trashed 2d ago
Next
skillshare sync link it into your targets again
For agents, the restore hint will suggest skillshare sync agents instead.
Restore also brings back what the install recorded: a skill, tracked repo or agent installed from GitHub or another remote keeps its source, so update and check still work. Items trashed by an older version come back as local.
A trashed source link is listed as link → <target> and restored as a link (or junction) again, never as a copy of its target. A skill trashed from behind a followed link (_dev-skills/foo) is restored into the real checkout when follow_source_links is on; the restore fails and keeps the trash entry when the setting is off or a nested link below the checkout leads elsewhere.
If an item with the same name already exists in source, restore will fail. Uninstall the existing item first or use a different name.
delete (alias: rm)
Permanently delete a single item from the trash:
skillshare trash delete my-skill
skillshare trash agents delete tutor
✓ Permanently deleted my-skill
empty
Permanently delete all items from the trash (with confirmation prompt):
skillshare trash empty
skillshare trash agents empty
! This will permanently delete 3 items from trash
? Continue? [y/N] y
✓ Emptied trash: 3 items permanently deleted · 0.1s
Backup vs Trash
These two safety mechanisms protect different things:
| backup | trash | |
|---|---|---|
| Protects | target directories (sync snapshots) | source skills and agents (uninstall) |
| Location | ~/.local/share/skillshare/backups/ |
~/.local/share/skillshare/trash/ (skills), .../trash/agents/ (agents) |
| Triggered by | sync, target remove |
uninstall |
| Restore with | skillshare restore <target> |
skillshare trash restore <name> |
| Auto-cleanup | manual (backup --cleanup) |
7 days |
Options
| Flag | Description |
|---|---|
agents |
Positional keyword — operate on agents instead of skills |
--all |
Include both skills and agents |
--no-tui |
Disable interactive TUI, use plain text output |
--project, -p |
Use project-level trash (.skillshare/trash/) |
--global, -g |
Use global trash |
--help, -h |
Show help |
Auto-Cleanup
Expired trash items (older than 7 days) are automatically cleaned up when you run uninstall or sync. No cron or scheduled task is needed.