agend-sh

AI エージェントのための、本物のコンピューター。

永続的な Linux ワークスペース。対話型ターミナル。共有可能なプレビュー。
お気に入りの MCP エージェントを接続して、作業を任せましょう。

クイックスタート · 対話型ターミナル · エージェントを接続 · MCP ツール · agend.sh

agend は、エージェントが MCP 経由で操作できる、永続的で隔離された Linux 環境を提供します。 コードの実行、ファイルの編集、Python REPL や Vim の利用、サービスの起動、プレビュー URL の公開が可能です。自分でシェルを開くことも、エージェントの作業中に対話型ターミナルを確認することもできます。

クイックスタート

1. インストール

Linux / macOS

curl -fsSL https://agend.sh/i | sh

Windows · PowerShell

irm https://agend.sh/i.ps1 | iex

Homebrew · Linux / macOS

brew install agend-sh/tap/agend

スクリプトインストーラーは、リリース署名とアーカイブの SHA-256 チェックサムを検証します。Unix インストーラーは /usr/local/bin に書き込み、sudo を求める場合があります。Windows インストーラーは %LOCALAPPDATA%\agend\bin に書き込み、ユーザーの PATH に追加します。リリースは 3 つすべてのプラットフォームで amd64 と arm64 に対応しています。

agend version

2. サインイン

agend login

ブラウザーで認証を完了してください。メールアドレスとパスワードでアカウントを作成する場合は、代わりに次を実行します。

agend signup --email [email protected]

signup はパスワードの入力を求め、成功するとサインインします。再度 login を実行する必要はありません。

3. ワークスペースを作成する

agend env create --name my-workspace
agend ping
agend exec 'python3 --version'

作成した環境は、CLI コマンドの対象として選択されます。サイズはアカウントのデフォルトプロファイルに従います。利用可能なサイズ、クォータ、スリープポリシーを確認するには agend profiles を実行してください。別のサイズを選ぶには、返されたプロファイル ID を agend env create --profile <profile-id> に渡します。

4. エージェントを接続する

agend config claude-code

または、別のクライアントを設定します。

agend config codex cursor gemini

クライアントの MCP 統合を再起動または再読み込みして、次のプロンプトを試してください。

agend の list_environments を使って my-workspace を見つけてください。そこで対話型の Python REPL を起動し、6 × 7 を計算してから REPL を終了してください。

エージェントは環境を検出し、MCP ツールで操作します。Agend アカウントと利用可能な環境クォータが必要です。CLI だけでは、無料のローカルマシンはプロビジョニングされません。

agend-sh は公式 MCP Registryに io.github.agend-sh/agend-sh として掲載されています。Docker ベースのインストールについては、 コンテナパッケージと接続ガイドをご覧ください。 Smitheryでも利用できます。 MCPB 拡張機能に対応したクライアントについては、バンドルガイドをご覧ください。

インタラクティブなターミナル

ターミナルは入力待ちに入ったことを通知できます。 これにより、REPL やターミナルアプリを操作しているエージェントプロセスにフィードバックが返されます。

たとえば、shell_exec を次のように呼び出します。

{
  "environment": "my-workspace",
  "command": "python3 -q",
  "interactive": true
}

応答は次のようになります。

status: awaiting_input
>>>
prompt_type: interactive
input_wait: true

shell_send_raw を使って続行します。

{
  "environment": "my-workspace",
  "input": "print('hello from agend')\n"
}

status: awaiting_input
print('hello from agend')
hello from agend
>>>
input_wait: true

次に、shell_send_raw で exit()\n を送信して Python を終了します。

応答の読み方

入力待ちシグナルはイベントであり、永続的な状態の問い合わせでも、アプリケーションやサービスの準備完了を保証するものでもありません。これは、環境のゲストスタックでのサポート状況に依存します。

REPL や TUI では、interactive: true を設定し、以降の入力に shell_send_raw を使用してください。Enter を押す場合は \n を含めます。ビューポートが変わったときは shell_resize を使用してください。アプリ独自のコマンドで終了するか、shell_interrupt を使ってセッションを閉じてください。各環境で同時にアクティブにできるインタラクティブセッションは 1 つです。別の shell_exec を開始する前に、現在のセッションを終了してください。

インタラクティブプロセスはツール呼び出しの間も動作し続け、応答の収集がタイムアウトしても終了しません。ツールの応答が完了した後に MCP クライアントとの接続が切れても、プロセス自体は停止しません。同じ環境に再接続して続行してください。環境のスリープ、クラッシュ、またはコールドリセットによって、プロセスの存続時間が変わることがあります。

エージェントの作業を確認する

agend watch

Watch は選択した環境のインタラクティブセッションをミラーリングし、保持されている出力を再生して、新しい更新を表示します。リモートプロセスには入力を送信しません。監視を停止するには q または Ctrl+C を押してください。エージェントのセッションは続行されます。

画面を録画するには、次のようにします。

agend watch --typing-delay 40ms

正確に表示するには、ターミナルのサイズをリモートセッションに合わせてください。Watch は、エージェントのツール呼び出しで収集された出力を追跡します。呼び出しの間にゲストをポーリングして出力を取得することはありません。表示されるのはインタラクティブセッションであり、通常のコマンド出力やバックグラウンドタスクのログではありません。

自分で環境を操作しますか？

agend connect

これにより、キーボード入力とターミナルのサイズ変更が可能なライブターミナルが開きます。シェルを閉じるには exit を実行してください。stdin にターミナルが必要です。また、MCP と同じインタラクティブセッション枠を使用するため、先にエージェントのインタラクティブアプリを閉じてください。

ブラウザーのプレビューを共有する

エージェントに shell_exec でサービスを起動させます。

{
  "environment": "my-workspace",
  "command": "python3 -m http.server 8080 --bind 0.0.0.0 --directory /home/agend-user/readme-demo",
  "run_in_background": true
}

まず /home/agend-user/readme-demo を作成し、デモファイルをそこに配置してください。トンネルから接続できるよう、サービスを 0.0.0.0 にバインドしてください。

次に port_expose を呼び出します。

{
  "environment": "my-workspace",
  "port": 8080
}

応答には公開 HTTPS URL が含まれます。トンネルと DNS が利用可能になるまで、しばらくお待ちください。port_list には有効な公開設定が表示されます。port_unexpose で公開設定を削除できます。ポートを公開すると、そのサービスにインターネットからアクセスできるようになります。

Cloudflare で管理している独自ドメインを使う場合は、agend domain add example.com でゾーンを登録し、port_expose に domain: "app.example.com" を渡してください。登録時には、Zone:DNS:Edit、Zone:Zone:Read、および Account:Cloudflare Tunnel:Edit の権限を持つ Cloudflare API トークンの入力を求められます。スクリプトでは AGEND_CF_TOKEN を使って指定できます。agend domain list は、agend domain remove <domain-id> で使用するドメイン ID を返します。

エージェントを接続する

agend config は、マシンにインストールされている対応クライアントを検出します。書き込み前に選択内容をプレビューできます。

agend config --dry-run
agend config

クライアントを明示的に選択することもできます。

設定すると、ローカルの stdio サーバーとして agend mcp が登録されます。クライアントがインストール済みバイナリを見つけられる必要があります。Windows では、設定書き込みツールがその絶対パスを使用します。クライアント固有の設定パスと形式は agend config が処理します。

{
  "mcpServers": {
    "agend": {
      "command": "agend",
      "args": ["mcp"]
    }
  }
}

CLI では23 個のツールを利用できます。list_environments を呼び出して、ID と名前を確認してください。環境固有のツールでは environment 引数が必要で、ID または名前を指定できます。env_create、list_environments、profiles_list、reload_config では不要です。

interactive と run_in_background は同時に指定できません。バックグラウンド実行では、タスクツールで使用する task_id が返されます。

file_upload と file_download のローカルパスは、MCP サーバーの作業ディレクトリ内、またはサーバーの環境で AGEND_LOCAL_ROOT を設定している場合はそのディレクトリ内に制限されます。ダウンロードでは転送メタデータが返されます。テキストを読むには shell_exec を使用するか、ダウンロードしたローカルファイルを開いてください。大きなファイルは、リモート環境内で curl または wget を使って直接ダウンロードするほうが通常は高速です。

CLI リファレンス

CLI コマンドは選択中の環境に対して実行されます。agend env use やその他の CLI 環境コマンドでは環境 IDを使用してください。MCP ツールでは名前も解決されます。

agend env list
agend env use <env-id>
agend exec 'pwd'

環境とアカウント

コールドリセットでは永続データディスクは保持されますが、ゲストメモリ、プロセス、セッション、スナップショットは破棄されます。これは復旧操作です。環境の作成、選択、または環境内での実行によって、環境が起動または復帰することがあります。読み取り専用で状態を確認するには、env status を使用します。

シェル、ファイル、タスク

exec は、--timeout （ミリ秒単位）（デフォルト：30000）、--head、--tail、--background、--interactive に対応しています。ライブターミナルには connect を使用します。エージェントで REPL や TUI を操作する場合は、MCP の対話型ツールワークフローを使用します。

たとえば、次のようになります。

agend file-put /home/agend-user/hello.txt 'hello from agend'
agend file-get /home/agend-user/hello.txt
agend exec --timeout 60000 'python3 --version'

file-get はファイルのメタデータを標準エラー出力に書き込みます。file-put が受け取るのは内容であり、ローカルのファイル名ではありません。ローカルファイルの転送には、MCP の file_upload を使用してください。どちらの CLI ファイルコマンドも --encoding text または --encoding base64 に対応しています。file-put はさらに --create-dirs、--overwrite、--mode にも対応しています。

agend update

アップデーターは、バイナリーを置き換える前に、署名済みのチェックサムマニフェストとアーカイブを検証します。すでに実行中の MCP プロセスは、再起動するまで現在のバージョンを使用し続けます。リリースビルドは、最大 24 時間に 1 回、自動で更新を確認します。これらの自動確認を無効にするには、AGEND_NO_AUTOUPDATE=1 を設定してください。Homebrew で管理されているインストールの場合は、brew upgrade agend を実行してください。

認証情報とアカウントごとの環境選択は ~/.config/agend/credentials.json に保存され、Unix ではファイルの権限が所有者のみに制限されます。Windows では、~ はユーザープロファイルを指し、アクセスは Windows のファイルシステム権限によって管理されます。スクリプトでメールアドレスとパスワードを使って認証するには、AGEND_PASSWORD を使用してください。それ以外の場合は、CLI が入力を求めます。

開発

Go 1.26.9+ が必要です。ソースコードをチェックアウトした状態で、次のコマンドを実行します。

git clone https://github.com/agend-sh/cli.git
cd cli
make build
./bin/agend version

make install はバイナリをビルドし、/usr/local/bin にコピーします。このディレクトリへの書き込み権限が必要です。Windows では、go build -o agend.exe ./cmd/agend を直接実行してビルドします。

go test ./...
go vet ./...

CI では Linux と Windows でビルド、テスト、静的解析を行い、さらにクロスコンパイルのチェックも実施します。バージョンタグを付けると GoReleaser が起動し、Linux/macOS 向けの tarball と Windows 向けの zip アーカイブ（amd64 および arm64 対応）、チェックサムマニフェスト、Sigstore 署名バンドルを公開します。Homebrew tap は独自のワークフローで更新されます。make release はローカルでの Unix クロスビルド用ターゲットであり、公開ワークフローではありません。

テスト済みのリリース、ライブチェック、現在の問題、カバレッジの制限については、README の検証レポートを参照してください。

Your MCP agent
     │ stdio / JSON-RPC
     ▼
  agend mcp ──────────────── agend connect / agend watch
     │ authenticated gRPC over a WebSocket tunnel
     ▼
  Environment backend
     │
     ▼
  Isolated Linux workspace

ライセンス

MIT。