mcpField
S
shell-history

shell-history

github.com/gkwa生産性066 回インストール1 日前に更新
リポジトリ

shell-history について

shell-historyは、atuinで最近のシェルコマンドを検索するワークフロースキルです。履歴にタイムスタンプを付けてキーワードで絞り込み、結果が見つからない場合は検索期間を広げます。

主な機能

  1. 01タイムスタンプ付きatuin履歴の検索
  2. 02grepによるキーワード絞り込み
  3. 03検索期間を最大7日まで段階的に拡張
  4. 04検索した期間の報告

活用シーン

  1. 01最近実行したコマンドの検索
  2. 02アクセスしたURLやツール実行の確認
  3. 03過去に使ったフラグや引数の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gkwa/volcanicviper --skill shell-history

インストール後、Claude Code で/shell-historyを入力して読み込まれたか確認します。

同梱ファイルtile.json

詳細

シェル履歴の検索

ユーザーがシェル履歴から何かを探したい場合は、タイムスタンプ付きの atuin を使い、grep で絞り込みます。

標準的な実行方法
atuin search --after "<N> days ago" --format "{time} {command}"

デフォルトの <N> は 1 です。

ユーザーが日数を指定した場合は、その数を使います。日数を指定する例:

  • 「過去 2 日間のシェル履歴を検索して」
  • 「3 日分の履歴を確認して」
  • 「過去 2 日間」

これにより、過去 N 日間のシェルコマンドが、タイムスタンプ付きで返されます。

キーワードによる絞り込み

次に、関連する用語(URL、ツール名、フラグなど)を grep で検索します。

各コマンドは個別の Bash 呼び出しとして実行してください。1 回の呼び出しでパイプを使ってコマンドを連結しないでください。

ステップ 1:ジョブディレクトリが利用可能な場合は、履歴を一時ファイルに保存します。利用できない場合は、/tmp 配下に一意のファイル名で保存します。

ステップ 2:そのファイル内でキーワードを grep で検索します。

検索期間の拡大

デフォルトの 1 日間の検索で有用な結果が見つからない場合は、2 日間、3 日間と順に拡大し、諦めるかユーザーに追加情報を尋ねるまで、最大 7 日間まで試します。

検索のたびに対象期間をユーザーに伝え、どこまで遡って調べたかがわかるようにします。

このスキルを使う場面
  • ユーザーが「シェル履歴を確認して」「履歴を見て」「実行したコマンドを探して」と言った場合
  • ユーザーが curl/wget でアクセスした URL や、最近実行したツールを探している場合
  • ユーザーが過去のコマンドで使ったフラグや引数を尋ねた場合

コメント