Zi

Zshプラグイン、スニペット、コマンドラインツールを管理します。

クイックスタート  ·  ドキュメント  ·  リリース  ·  ディスカッション

ZiはZ-Shellエコシステムのプラグインマネージャーで、以前はzpluginおよびzinitとして知られていました。

機能

• 応答性の高い起動: Turboモードで最初のプロンプトの後までプラグインの読み込みを遅延させます。
• 柔軟なソース: プラグイン、スクリプト、補完、リリース成果物を読み込みます。
• 読み込みの制御: ice修飾子を使用してダウンロード、ビルド、更新を設定します。
• ツール管理: rootアクセスなしでコマンドラインツールをインストールします。
• 拡張機能: Ziアネックスを通じて機能を追加します。

要件

Zshを使用し、GitがPATH上で利用可能である必要があります。クイックスタートインストーラーはcurlとPOSIXシェルも使用します。インストールするプラグインやツールには、それぞれ独自の依存関係がある場合があります。

クイックスタート

1. Ziのインストール

公式インストーラーはデフォルトのローダープロファイルでZiをインストールし、.zshrcに短い管理対象ソースエントリを1つ追加します（正規のインストールページを参照）：

sh -c "$(curl -fsSL get.zshell.dev)" --

[!IMPORTANT] リモートインストールスクリプトを実行する前に、インストーラーのソースと公開されているSHA-256チェックサムを確認してください。

2. 最初のプラグインを追加する

インストーラーの管理対象ソースエントリの後に、以下のコマンドを.zshrcに追加します。この例では、Oh My Zshスニペット、コマンド候補、高速構文ハイライトを読み込みます：

# ~/.zshrc
zi snippet OMZ::plugins/git/git.plugin.zsh
zi light zsh-users/zsh-autosuggestions
zi light z-shell/F-Sy-H

snippetはスタンドアロンスクリプトを読み込みます。lightはプラグインを読み込みます。初回の読み込み時に、不足しているリポジトリやスニペットがダウンロードされます。

3. Zshの再読み込み

exec zsh -il

zi -hを実行すると、利用可能なコマンドを確認できます。代替インストーラー、手動セットアップ、補完、インストール後の手順については、完全なインストールガイドを参照してください。

タスク別に学ぶ

• プラグインとスニペットの読み込み: 概要。
• 依存関係の読み込み方法を選択する: ice修飾子。
• パスと動作の設定: 設定ガイド。
• 更新、検査、アンロード: コマンドリファレンス。
• プラグインとアネックスの検索: エコシステムカタログ。
• シェル起動の理解: 公式Zsh起動ファイルリファレンス。

自動インストーラーやターミナルインターフェースについては、セットアップ統合コントラクト（plan/applyフェーズ、結果、イベント処理を含む）を使用してください。

コミュニティとサポート

• 使用方法に関する質問はZ-Shell Discussionsでお尋ねください。
• 再現可能な不具合はZi issuesから報告してください。
• リリースと変更履歴はリリースページで確認できます。
• より広範なZ-Shell organizationもご覧ください。

コントリビューション

コントリビューションを歓迎します。issueやプルリクエストを作成する前に、ブランチモデルとリリースプロセスについてコントリビューションガイドをお読みください。チェックアウトの検証に使用される構文チェックと集中的なリグレッションチェックについては、Zshワークフローを参照してください。開発作業はnextブランチを対象とし、mainには本番リリースが含まれます。

セキュリティ

脆弱性を非公開で報告するには、Z-Shellセキュリティポリシーに従ってください。修正が利用可能になる前に、公開issueで脆弱性を開示しないでください。

ライセンス

ZiはMIT Licenseの下で利用可能です。