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.
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.