Show HN: ターミナル用のコマンドパレットを構築しました – 6.2MB、純粋なGo、fzfなし
Show HN: I built a command palette for the terminal – 6.2MB, pure Go, no fzf (github.com)
要約
開発者がターミナルで日常的に使用するコマンドを素早く検索・実行できる「decoreba」というコマンドパレットが紹介されています。このツールは、6.2MBの単一バイナリで、依存関係がなく、Go標準ライブラリのみで構築されています。インライン表示、あいまい検索、タイポトレランス、使用頻度や時間経過によるランキング、複数ステップのワークフロー、AIエージェントとの連携機能などを備えています。
全文翻訳
decoreba
また必要になるであろうターミナルコマンドのための、手動コマンド保管庫。
仕事で、非常に特定のパラメータを持つコマンドが必要なのに、どこにも保存するのを忘れてしまうことがよくありました。tmuxを使い始めたときも、Googleでコマンドを検索し続けていました。
Decorebaは、それらのコマンドを検索可能な保管庫に保存します。覚えておく価値のあるエントリを追加し、後で必要になったときにターミナルから見つけ出します。
これはコマンドのための、Windows + Vの永続版のようなものだと考えてください。何を入れるかを自分で決めるため、保管庫はあなたがこれまで入力したすべてのコマンドを集めることなく、有用な状態を保ちます。シェル履歴やfzfは、保存しなかったコマンドに対しては依然としてうまく機能します。Decorebaは、保存されたコンテキスト、ノート、ワークフローとともに、もう一つの検索場所を提供します。
クイックスタート
npmでインストールします:
npm install -g decoreba
decoreba version
このnpmパッケージは、Linux、macOS、Windows用のバイナリを提供します。Homebrewやソースからビルドしてインストールすることもできます:
# Homebrew
brew tap matheuzgomes/decoreba
brew install decoreba
# Go 1.25+
go install github.com/matheuzgomes/decoreba/cmd/decoreba@latest
覚えておきたいコマンドを保存します:
decoreba add
再入力せずに、シェル履歴で利用可能な最新のコマンドを保存するには:
decoreba add --last
Decorebaはシェル履歴を読み込み、自身の呼び出しをスキップするため、保存したいコマンドの直後にadd --lastを実行できます。フォームは保存前にコンテキストとタイトルを尋ねます。
フォームは、コンテキスト、タイトル、コマンド、タグ、ノートを尋ねます。例:
Context: tmux
Title: 現在のウィンドウの名前を変更する
Command: tmux rename-window {{name}}
後で検索します:
decoreba tmux rename
結果を選択してEnterキーを押すとコピーされます。確認後に実行するにはCtrl+Xを押します。
仕組み
Decorebaは、小さく意図的なループに従います:
- 保存する価値のあるコマンドを選択します。
- Decorebaはコマンドとそのコンテキストを1つのJSONファイルに保存します。
- コンテキスト、タイトル、コマンド、またはタグで検索します。
- インラインパレットが選択されたコマンドをコピーするか、確認後に実行します。
パレットはプロンプトの下に開き、完了すると消えます。ターミナルをフルスクリーンのインターフェースに置き換えたり、バックグラウンドサービスを必要としたりしません。
コマンドには、毎回値が変わるプレースホルダーを含めることができます:
docker logs --tail {{lines:100}} {{container}}
Decorebaは、コマンドをコピーまたは実行するときにこれらの値を尋ねます。
保存されたコマンドには、複数のタイトルの付いたステップを含めることもできます。一度に1つのステップを実行するにはEnterを押し、確認後に残りのステップを実行するにはCtrl+Xを押します。失敗したステップはワークフローで表示されたままになります。
シェルから使用する
BashまたはZshの補完を生成します:
source <(decoreba completion bash)
source <(decoreba completion zsh)
Fishの場合:
decoreba completion fish > ~/.config/fish/completions/decoreba.fish
BashまたはZshウィジェットと補完をまとめてインストールします:
decoreba init
decoreba init --yes
シェル統合をロードした後、コマンドを入力中にCtrl+Oを押します。Decorebaは、コマンドライン上の既存のテキストを検索クエリとして使用します。Enterを押すと、選択されたコマンドがプロンプトに戻されます。Fishは補完をサポートしますが、このウィジェットはサポートしません。
生成されたスクリプトを検査したい場合は、ウィジェットを直接ロードできます:
source <(decoreba shell bash)
source <(decoreba shell zsh)
その他のコマンド
decoreba # すべてのコンテキストを検索
decoreba git undo # git内で検索
decoreba list # コンテキストとコマンド数を一覧表示
decoreba list docker # docker内のコマンドを一覧表示
decoreba add # コマンドを追加(インタラクティブ)
decoreba add --last # 最後に実行したシェルコマンドを追加
decoreba edit <id> # IDまたはIDプレフィックスで編集
decoreba rm <id> # IDまたはIDプレフィックスで削除
decoreba stats # 保管庫の統計を表示
decoreba export # コマンドを標準出力にエクスポート
decoreba import [file] # 標準入力、ファイル、pet、またはnaviからインポート
decoreba help # 完全なコマンドリストを表示
decorebaを使う理由
コマンドが存在することは覚えているが、正確なフラグ、構文、またはパラメータを覚えていない場合に使用します。保存されたコンテキストとノートは、正しいコマンドを認識するのに役立ちます。ワークフローを使用すると、1つの操作に複数のステップが必要な場合に、関連するコマンドをまとめておくことができます。
シェル履歴やfzfは、すでにすべて入力したものを検索したい場合に使用します。Decorebaは、意図的により小さなコマンドコレクションを保持したい場合に使用します。
意図的な制限
Decorebaはコマンドを自動的に保存しません。有用なコレクションは自分で選択したものであるため、また自動キャプチャはプライバシーとセキュリティに関する疑問を提起するため、エントリは手動で追加します。これにより、保存しなかったコマンドは保管庫に表示されません。
オプションの同期
保管庫は1つのJSONファイルです。自分でマシン間で移動したり、プライベートなGitHub Gist経由で同期したりできます:
decoreba sync init
decoreba sync push
decoreba sync pull
decoreba sync status
同期には、gistスコープを持つクラシックGitHubトークンであるDECOREBA_GIST_TOKENが必要です。アップロードされた保管庫をAES-256-GCMで暗号化するには--encryptを使用します。
同期はオプションのトランスポートです。ローカルワークフローには必要ありません。
petまたはnaviからのインポート
以前にpetまたはnaviを使用していた場合、それらのコマンドをdecorebaにインポートできます:
decoreba import pet --path ~/.config/pet/snippet.toml
decoreba import navi --path ~/.config/navi/cheats/
すでに保管庫に存在するコマンドはスキップされます。何も変更せずにインポートされる内容を確認するには--dry-runを追加します。
オプションのMCPサーバー
MCPサーバーは、stdinとstdoutを介してAIエージェントに保管庫を公開します。これを通じてコマンドを検索、読み取り、追加、編集、削除、実行できます。
decoreba mcp
書き込みおよび削除操作にはconfirm: trueが必要です。危険なコマンドパターンはデフォルトでブロックされ、変更は最初にバックアップされます。MCPを使用しない場合は、このセクションを無視できます。
データと設定
コマンドは1つのcommands.jsonファイルに保存されます:
| システム | パス |
|---|---|
| Linux | $XDG_CONFIG_HOME/decoreba/commands.json |
| macOS | ~/Library/Application Support/decoreba/commands.json |
| Windows | %AppData%\\\decoreba\\\[commands.json |
設定ディレクトリをオーバーライドするにはDECOREBA_CONFIGを設定します。NO_COLORと--no-colorはANSIカラーを無効にします。
開発
ソースワークフローにはGo 1.25以降とmakeが必要です。
git clone https://github.com/matheuzgomes/decoreba
cd decoreba
go test ./...
make build