インストール

Zshell は Apple の公証を受けていません。ホームページのダウンロード欄に、現在のリリースが必要とする macOS の最小バージョンを表示しています。

ダウンロードリンクをコピー

ホームページから .dmg をダウンロードします。現在の 0.1.11 リリースには Universal、Apple Silicon、Intel 向けのパッケージがあり、Gitee ミラーも利用できます。 ディスクイメージを開き、Zshell を「アプリケーション」にドラッグしてください。

初回起動時に macOS がアプリをブロックすることがあります。一度起動を試みてから、システム設定 → プライバシーとセキュリティ → このまま開く（Open Anyway）を選び、Zshell を開くことを確認します。Homebrew からのインストールも同様です。

Homebrewリンクをコピー

brew install wzz6423/tap/zshell

Cask は wzz6423/homebrew-tap にあり、Mac のプロセッサに合う ZIP をインストールします。 インストール後の更新には Sparkle を使います。Homebrew から明示的に更新する場合や、古いバージョンを最新にする場合は、次を実行します。

brew upgrade --cask --greedy-auto-updates zshell

更新リンクをコピー

直接ダウンロードした場合も Homebrew から入れた場合も、更新には Sparkle を使用します。 中国本土では Gitee、次に GitHub、それ以外では GitHub、次に Gitee を試します。取得できる場合は接続元 IP の国情報を使い、取得に失敗した場合は macOS の地域設定を使います。 フィードやダウンロードに失敗すると、もう一方の配信元で 1 回再試行します。 国情報の取得には ipinfo.io/country を使い、タイムアウトは 5 秒、メモリ内のキャッシュは 30 分です。 このリクエストにより接続元の公開 IP が同サービスに伝わりますが、Zshell は IP を保存しません。自動確認をオフにすると、バックグラウンドでの国情報取得も停止します。

インストール前に署名付きフィードと更新パッケージを検証し、インストール済みのアーキテクチャを維持します。Rosetta 上で動く Intel 版は Apple Silicon 版へ移行します。

設定 → 更新（Updates）（Cmd+,）で自動確認と更新を自動ダウンロード（Automatically download updates）を設定できます。 ダウンロードは初期状態ではオンで、自動確認が有効な場合に使えます。ダウンロードをオンにすると、独立した更新を自動インストール（Automatically install updates）が現れます。インストールは初期状態ではオフです。 インストールをオフにしている場合、更新はバックグラウンドでダウンロードされ、Zshell を終了するときに適用されます。両方をオンにすると、準備できた更新を自動インストールして Zshell を再起動します。 再起動中に実行中のターミナルプロセスは停止し、Zshell が開き直すとワークスペースが復元されます。 ダウンロードをオフにするとインストールのスイッチが隠れ、自動再起動も行いません。ただし選択内容は保持され、次にダウンロードを有効にしたときに戻ります。両方の選択はアプリの再起動後も保持されます。 更新があると、プロジェクトサイドバー下部のフィードバックボタンの左に更新アイコンが表示されます。クリックすると更新や進捗を開いたり、保留中の再起動を再試行したりできます。 手動で確認するには更新を確認…（Check for Updates…）を選びます。上記の Homebrew コマンドからも明示的に更新できます。

おすすめのツールリンクをコピー

設定 → おすすめ（Recommendations）では、ターミナル、ネットワーク、開発、ユーティリティ、Zisla などのデスクトップツールを探せます。 このページを開いている間に、インストール済みツールと利用可能な更新を確認します。 各ツールのインストール（Install）や更新（Update）、未導入のおすすめをまとめて入れる未インストールを導入（Install Missing）、Homebrew 管理ツールの更新をまとめて適用するすべて更新（Update All）を使用できます。

ツールのインストールには Homebrew を使います。Homebrew がない場合は導入手順へのリンクが表示されます。確認だけで勝手にインストールや更新を行うことはありません。 Homebrew 以外から入れたツールには Homebrew 管理外（Outside Homebrew）と表示されます。 Homebrew を使用（Use Homebrew）は Homebrew 管理のコピーをインストールしますが、シェルの PATH によっては既存のコピーが引き続き優先されます。 インストール状況を変えたあとは再読み込み（Refresh）で確認し直せます。Zshell 自体は設定 → 更新で管理します。

Finder からフォルダを開くリンクをコピー

Zshell は New Zshell Project Here という macOS サービスを登録します。 Finder で 1 つ以上のフォルダを選び、右クリックしてサービスサブメニューから選択すると、各フォルダがプロジェクトになり、その場所でターミナルが起動します。

メニューにない場合は、システム設定 → キーボード → キーボードショートカット → サービス → ファイルとフォルダで有効にします。 macOS が新しいサービスを表示するには、アプリを一度起動する必要があります。

アンインストールリンクをコピー

設定 → 自動化 → AI が有効な場合は、アプリを削除する前にオフにしてください。Zshell がインストールしたエージェント連携を削除できます。

「アプリケーション」から zshell.app を削除します。設定も初期化したい場合は次を実行します。

rm -rf ~/.config/zshell

ウィンドウ配置、サイドバー幅、セッションのスナップショットは macOS の環境設定ストアにあります。

defaults delete sh.zshell