/trash

sidebar_position: 4

trash

trash ディレクトリ内のアンインストール済み Skill と agent を管理します。

skillshare trash list                    # インタラクティブ TUI（TTY 内）
skillshare trash list --no-tui           # プレーンテキスト出力
skillshare trash restore my-skill        # trash から復元
skillshare trash restore my-skill -p     # project モードで復元
skillshare trash delete my-skill         # trash から完全に削除
skillshare trash empty                   # trash を空にする
skillshare trash agents list             # trash 内の agent を一覧表示
skillshare trash agents restore tutor    # trash から agent を復元
skillshare trash --all list              # trash 内の Skill と agent を一覧表示

使うタイミング

• 最近アンインストールした Skill や agent を復元する（7 日以内）
• trash 内の項目を完全に削除して容量を空ける
• 自動失効する前に trash の中身を確認する

インタラクティブ TUI

TTY 内では、`trash list` は複数選択、フィルタリング、インライン復元／削除操作を備えたインタラクティブ TUI を起動します。各項目には種別バッジが表示されます: Skill は `[S]`、agent は `[A]` です。

Trash (global) — 5 items

  [ ] [S] my-skill    (512 B, 2d ago)
  [x] [S] old-tool    (1.2 KB, 5d ago)
  [ ] [A] tutor       (2.0 KB, 3d ago)
  [ ] [S] another     (128 B, 1d ago)

  ─────────────────────────────────────────
  Name:         old-tool
  Type:         Skill
  Trashed:      2026-02-27 14:30:05
  Size:         1.2 KB
  Path:         ~/.local/share/skillshare/trash/old-tool_...

  ── SKILL.md ──────────────────────────────
  ---
  name: old-tool
  description: A helpful tool
  ---
  # old-tool
  ...

  ↑↓ navigate  / filter  space select  r restore(1)  d delete(1)  D empty  q quit

`--all` を使う場合、または種別フィルタを指定しない場合、TUI は Skill と agent を統合し、日付順（新しい順）にソートされた 1 つのリストにまとめます。

キーバインド

| キー | 動作 | |-----|--------| | `↑`/`↓` | 項目を移動 | | `←`/`→` | ページを変更 | | `/` | フィルタモードに入る（名前の部分一致） | | `Space` | 現在の項目の選択を切り替え | | `a` | 表示中の全項目の選択を切り替え | | `r` | 選択した項目を復元（確認あり） | | `d` | 選択した項目を完全に削除（確認あり） | | `D` | trash をすべて空にする（選択を無視、確認あり） | | `Ctrl+d`/`Ctrl+u` | 詳細パネルを下／上にスクロール | | `q`/`Ctrl+C` | 終了 |

確認モードでは: `y`/`Enter` で確定、`n`/`Esc` でキャンセルします。

バッチ操作

複数の項目が選択されている場合、`r` と `d` はすべての項目に対して動作します。一部の項目が失敗した場合（例: 復元しようとした Skill と同じ名前が既に source に存在する場合）、TUI は残りの項目の処理を続行し、結合された結果を表示します。

Restored 2 item(s)  Failed: my-skill: already exists

`--no-tui` を使うと TUI をスキップし、代わりにプレーンテキストを出力します。

skillshare trash list --no-tui           # プレーンテキスト出力
skillshare trash list --no-tui | less    # 手動でページャーにパイプする

種別フィルタ

デフォルトでは、trash は **Skill** に対して動作します。agent を対象にするには `agents` 位置引数キーワードを、両方を含めるには `--all` を使用してください。

skillshare trash list                    # Skill のみ（デフォルト）
skillshare trash agents list             # agent のみ
skillshare trash --all list              # Skill と agent の両方
skillshare trash agents restore tutor    # trash 内の agent を復元
skillshare trash agents empty            # agent の trash のみを空にする

サブコマンド

list（エイリアス: `ls`）

trash 内の全項目を表示します。ターミナルではインタラクティブ TUI を起動し、`--no-tui` を指定した場合や非 TTY の場合はプレーンテキストを出力します。

skillshare trash list
skillshare trash agents list
skillshare trash --all list --no-tui

プレーンテキスト出力:

Trash
  my-skill      (1.2 KB, 2d ago)
  old-helper    (800 B, 5d ago)

2 item(s), 2.0 KB total
Items are automatically cleaned up after 7 days

restore

trash 内の最新バージョンを source ディレクトリに復元します。

skillshare trash restore my-skill
skillshare trash agents restore tutor

✓ Restored: my-skill
ℹ Trashed 2d ago, now back in ~/.config/skillshare/skills
ℹ Run 'skillshare sync' to update targets

agent の場合、復元時のヒントには代わりに `skillshare sync agents` が提案されます。

同じ名前の項目が既に source に存在する場合、復元は失敗します。先に既存の項目をアンインストールするか、別の名前を使用してください。

delete（エイリアス: `rm`）

trash から単一の項目を完全に削除します。

skillshare trash delete my-skill
skillshare trash agents delete tutor

✓ Permanently deleted: my-skill

empty

trash 内のすべての項目を完全に削除します（確認プロンプトあり）。

skillshare trash empty
skillshare trash agents empty

⚠ This will permanently delete 3 item(s) from trash
Continue? [y/N]: y
✓ Emptied trash: 3 item(s) permanently deleted

Backup vs Trash

この 2 つの安全機構は、それぞれ異なるものを保護します。

| | backup | trash | |---|---|---| | **保護対象** | target ディレクトリ（sync のスナップショット） | source の Skill と agent（アンインストール） | | **保存場所** | `~/.local/share/skillshare/backups/` | `~/.local/share/skillshare/trash/`（Skill）、`.../trash/agents/`（agent） | | **トリガー** | `sync`, `target remove` | `uninstall` | | **復元方法** | `skillshare restore <target>` | `skillshare trash restore <name>` | | **自動クリーンアップ** | 手動（`backup --cleanup`） | 7 日 |

オプション

| フラグ | 説明 | |------|-------------| | `agents` | 位置引数キーワード — Skill の代わりに agent を対象にする | | `--all` | Skill と agent の両方を含める | | `--no-tui` | インタラクティブ TUI を無効化し、プレーンテキスト出力を使用 | | `--project, -p` | project レベルの trash を使用（`.skillshare/trash/`） | | `--global, -g` | グローバルな trash を使用 | | `--help, -h` | ヘルプを表示 |

自動クリーンアップ

期限切れの trash 項目（7 日以上経過したもの）は、`uninstall` または `sync` を実行すると自動的にクリーンアップされます。cron やスケジュールされたタスクは不要です。

関連項目

• [uninstall](/docs/reference/commands/uninstall) — Skill を削除（trash へ移動）
• [backup](/docs/reference/commands/backup) — target ディレクトリをバックアップ
• [restore](/docs/reference/commands/restore) — バックアップから target を復元