kiriya

kiriya

Windows、Linux、macOS で同じように動作する、日常の開発作業向けのコマンドラインツールボックスです。

kiriya（ကိရိယာ、ビルマ語で「ツール」）を使えば、del と rm、netstat -ano と lsof -i、clip と pbcopy を覚えたり、作業ごとに使い捨てのスクリプトを書いたりする必要がなくなります。ランタイム依存関係のない単一の Node.js プログラムです。すべてのコマンドが --json に対応しており、 convert json --get を使えば、別のツールを使わずにその出力から値を取り出せます。複数ファイルを変更する場合は事前に計画を表示し、削除したファイルはゴミ箱に移動します。元に戻せない操作は、確認を入力するまで実行されません。AI エージェントは、同じルールのもと、MCP 経由で同じコマンドを利用できます。

インストール

kiriya の実行には Node.js 22.13 以降が必要です。

npm install --global kiriya

次に、このマシンで利用できることを確認します。

kiriya doctor

すべてのリリースは、来歴情報とともに CI から公開されるため、 npm audit signatures を実行すれば、インストールしたパッケージをどのワークフローがビルドしたか確認できます。以下の各モジュールは、Node.js 22、24、および最新リリースを使用して、Windows、Linux、macOS でテストされています。

はじめにではその先の使い方を説明しています。CONTRIBUTING.mdでは、ソースからのビルド方法を紹介しています。

クイックスタート

kiriya doctor                                   # what this machine offers kiriya
kiriya port who 3000                            # which process holds port 3000
kiriya files find --name "*.log" --older 30d    # the same search in every shell
kiriya files delete dist --dry-run              # the plan, before anything changes
kiriya git status ~/code --json                 # every repository under a folder, as JSON

使い方を調べる

ヘルプは3段階まで用意されており、各段階で次に進む先が示されるため、推測する必要はありません。

kiriya --help              # the modules, and the options every command accepts
kiriya help files          # one module: its commands, and what each one takes
kiriya help files delete   # one command: its arguments, options and examples

kiriya files delete --help には、3行目と同じ内容が表示されます。中間の段階では、各コマンドのオプション名がその下に一覧表示されるため、モジュールの機能全体を1画面で確認できます。

Commands
  delete   Send files and folders to the trash, or remove them for good with --permanent
           --permanent --dry-run --yes --confirm --all
  find     Find files and folders by name, extension, type, size, age or emptiness
           --name --ext --type --larger --smaller --newer --older --empty --all --limit

各モジュールには、すべてのコマンド、引数、オプション、それぞれの機能、および元に戻せるかどうかを網羅したリファレンスガイドも用意されています。

モジュール

モジュール	機能
archive	ZIP と tar.gz アーカイブを作成・展開します。zip、tar、7-Zip をインストールしなくても、どの OS でも同じ方法で使えます。
clip	Unicode を保持したまま、どの OS でもテキストをクリップボードにコピーして貼り付けられます。
completion	bash、zsh、fish、PowerShell で、kiriya のモジュール、コマンド、オプション、値をタブ補完できます。
config	読み込むプラグインなど、kiriya 独自の設定をユーザーごとに 1 つのファイルで管理します。
convert	このマシン上だけで、テキストを base64、hex、URL エンコーディング、JSON、JWT、時刻、ケース間で変換できます。
docker	現在のフォルダーのプロジェクトで docker compose を実行し、エンジンのクリーンアップを事前に確認できます。
doctor	このマシンが kiriya に提供するランタイム、設定、ゴミ箱、クリップボード、git、docker、プラグインを確認します。
env	環境変数、PATH、.env ファイルをどの OS でも同じ方法で読み取ります。
files	ファイルとフォルダーの作成、検索、読み取り、内容検索、比較、コピー、移動、名前変更、削除をどの OS でも同じ方法で行えます。
gen	OS の安全な乱数ソースから、ランダムな識別子、パスワード、トークンを生成します。
git	フォルダー内のすべてのリポジトリで、Git の状態確認、fetch、pull、switch を行えます。
net	ローカルアドレス、TCP 接続確認、DNS ルックアップをどの OS でも同じ方法で行えます。
open	ファイルやフォルダーを既定のアプリケーションで開くか、Web アドレスをブラウザーで開きます。
port	TCP ポートをリッスンしているプロセスの確認や終了、空きポートの検索をどの OS でも同じ方法で行えます。
proc	プロセスの一覧表示、検索、終了や、プロセスのツリー表示をどの OS でも同じ方法で行えます。
secrets	フォルダー内のファイルにコミットされたシークレットを検索します。トークン、秘密鍵、パスワードが平文で残っていないか確認できます。
self-update	レジストリに新しい kiriya があるか確認し、--apply を指定してインストールします。
sys	このマシンと、その上の開発ツールについて、どの OS でも同じ方法で情報を表示します。
wait	ポートがリッスンを開始する、Web アドレスが応答する、またはファイルが現れるまで、どの OS でも同じ方法で待機します。

AI エージェント

kiriya mcp は、Model Context Protocol を介してこれらのコマンドを AI エージェントに提供します。追加の許可がない限り、何も変更しないコマンドのみを提供し、元に戻せない作業の前には確認を求めます。MCP サーバーでは、クライアントへの追加方法を説明しています。

ドキュメント

対象	参照先
kiriya の使い方	はじめに · 使い方 · モジュール
ガイド	MCP サーバー · タブ補完 · プラグイン
コントリビューション	CONTRIBUTING.md · アーキテクチャ · 設計
すべて	ドキュメントのインデックス

プロジェクト

変更履歴 · セキュリティポリシー · 行動規範 · MIT ライセンス