nessie

リモートエグゼキューターをセットアップ

Nessieのエージェントと連携するコンピューターを、インストール、ペアリング、管理できます。

エグゼキューターは、お客様が管理するコンピューターをNessieに接続します。使用すべきファイルとプログラムを持つOSアカウントの下にインストールしてください。Node.jsやソースコードのチェックアウトは必要ありません。

macOS

CLIには、Apple Siliconを搭載したmacOS 15以降が必要です：

brew install unlikeotherai/tap/nessie-executor

Nessieのデスクトップアプリ、またはローカルの権限ウィンドウを備えたスタンドアロン版のエグゼキューターは、次のとおりです：

brew install --cask unlikeotherai/tap/nessie
brew install --cask unlikeotherai/tap/nessie-executor-app

使用したいインターフェースを選んでください。ペアリングごとに、スーパーバイザーを一つだけ実行します。エグゼキューターアプリでは、Settings → Open Nessie Executor when I log inで自動起動を制御します。

DebianとUbuntu

x86_64のDebian 12以降、またはUbuntu 22.04以降では、署名付きのAPTリポジトリを使用してください：

sudo apt-get update
sudo apt-get install -y curl ca-certificates
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.nessie.works/nessie-executor.asc | sudo tee /etc/apt/keyrings/nessie-executor.asc >/dev/null
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/nessie-executor.asc] https://packages.nessie.works/apt stable main" | sudo tee /etc/apt/sources.list.d/nessie-executor.list >/dev/null
sudo apt-get update
sudo apt-get install nessie-executor

Fedora、Rocky Linux、AlmaLinux向け

x86_64のFedora、またはRocky Linux / AlmaLinux 9以降では、署名付きのRPMリポジトリを使用してください：

sudo curl -fsSL https://packages.nessie.works/nessie-executor.repo -o /etc/yum.repos.d/nessie-executor.repo
sudo dnf install nessie-executor

Linuxのバックグラウンドサービスにはsystemdが必要です。パッケージにはランタイムが含まれています。APTまたはDNFは、依存関係としてGitとtmuxもインストールします。

Windowsのエグゼキューター

WinGetを使って、署名付きのスタンドアロン版エグゼキューターをインストールしてください：

winget install --exact --id UnlikeOtherAI.NessieExecutor

スタートメニューまたはトレイからNessie Executorを開いてください。新しいチームの接続は、ログインしているWindowsアカウントとして実行されます。インストーラーは、独立したサービスアカウント用のスーパーバイザーも提供します。対話型のターミナルプログラムは、そのログイン認証情報が利用できるユーザーセッションの接続でのみ実行されます。

チームとペアリングする

sudoを使わず、通常のアカウントでCLIを実行してください：

nessie-executor login --api nessie --workspace "/path/to/work"

ご自身のNessieサーバーを使う場合は、nessieを、そのHTTPSのAPI URLに置き換えてください。デスクトップ版エグゼキューターのAdd teamでも、同じ手順が始まります。

  1. コンピューターに表示される八桁のコードをコピーしてください。
  2. Nessieで、Admin › Computers › Add a computerを開きます。コードを貼り付け、組織、チーム、アクセス範囲を選択し、フィンガープリントを確認してください。
  3. コンピューターで、申告された組織とチームを確認してください。
  4. エグゼキューターがオンラインであることを確認し、Nessieでその機能を確認したうえで、意図したエージェントにアクセス権を付与してください。

コードは10分で期限切れになり、一度だけ使えます。別のチームとペアリングするには、loginまたはAdd teamを繰り返してください。接続ごとに、独自のマシンキー、フォルダー、コマンドのルール、起動サービスがあります。

nessie-executor teams
nessie-executor permissions --executor <executor-id>
nessie-executor permissions --executor <executor-id> --allow-all --deny "git push *"
nessie-executor permissions --executor <executor-id> --allow "git *,pnpm *"

すべてのコマンドは、構造的な安全性の確認を条件に、初期設定で許可されています。ローカルの拒否リストは、許可リストより優先されます。フォルダーとコマンドの権限は、このコンピューターにのみ保存され、Nessieから変更することはできません。Nessieでは、チーム内で誰とどのエージェントがこの接続を使えるかを管理します。権限を変更する前に、ローカルのデーモンを停止し、変更後にもう一度起動してください。

エージェントは、これらのコマンドのルールで許可される範囲で、このコンピューターの対話型ターミナルから、Codex、Gemini、Claude、シェル、そのほかのインストール済みプログラムを起動することもできます。ほかの設定はありません。こうしたプログラムは、同じアカウントでインストールされ、ログイン済みである必要があります。macOSとLinuxではtmuxが必要です。ターミナルのプログラムは、OSアカウントと同じアクセス権を持ち、そのフォルダーはサンドボックスではありません。サンドボックス化されたcommand.runには、別途ゲストランタイムが必要です。

起動、ステータス、アップデート

対話型のloginは、ペアリングを確定した後に自動起動を有効にします。macOSでは、launchdエージェントが、ログイン時にそのチームを起動します。Linuxでは、systemdのユーザーサービスとlingering設定により、ログアウトや再起動をまたいで接続が維持されます。

nessie-executor status
nessie-executor enable <executor-id>
nessie-executor disable <executor-id>

disableは、ペアリングと権限を削除せずにサービスを停止します。フォアグラウンドのセッションで実行する場合は、まずそのサービスを無効にしてから、nessie-executor daemon --executor <executor-id>を使ってください。明示的な--state-dirを指定して作成したペアリングは、フォアグラウンドで監視されます。

macOSのCLIのログは~/Library/Logs/NessieExecutor/<executor-id>.logにあります。Linuxのログはjournalctl --user -u nessie-executor@<executor-id>で確認できます。

パッケージマネージャーでアップグレードします：

brew upgrade nessie-executor
sudo apt-get update && sudo apt-get install --only-upgrade nessie-executor
sudo dnf upgrade nessie-executor

Windowsではwinget upgrade --exact --id UnlikeOtherAI.NessieExecutorを使います。アップグレード後は、CLIのサービスごとにdisable、続いてenableを実行して再起動してください。CLIのペアリングキーとローカルの権限は~/.local/state/nessie-executor/にあります。デスクトップアプリは、状態をアカウントのアプリケーションデータフォルダーに保存します。どちらもインストールされたパッケージの外にあるため、アップグレードしても保持されます。

ソフトウェアを削除するには、CLIのサービスをすべて無効にするか、アプリのログイン時の設定をオフにしてアプリを終了し、同じパッケージマネージャーでアンインストールしてください。アンインストールしてもペアリングの状態は保持されます。アクセスを取り消すには、NessieでエグゼキューターをDisconnectまたはDeleteしてください。ローカルファイルを削除するだけでは、サーバー側の記録は取り消されません。

ローカルの設定の詳細は、ローカルでの設定項目をご覧ください。