# トークンを取得
$ curl -X POST \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '{"command":"echo Hello from Hoody!"}'
> { "command_id": "42", "status": "running" }
# 最初のコマンドを実行
$ curl \
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com/api/v1/terminal/result/42 \
-H "Authorization: Bearer $TOKEN"
> { "status": "completed", "output": "Hello from Hoody!", "exit_code": 0 }
# URLを共有 — 誰でも接続できます
https://abc123-def456-terminal-1.node-us-1.containers.hoody.com
URL がインターフェース
ターミナルにはそれぞれ予測可能なアドレスがひとつあります。左から右へ読めば、どのサービス、インスタンス、コンテナと話しているのかが正確にわかります。
https://abc123-def456-terminal-1.node-us-1.containers.hoody.comabc123プロジェクト
プロジェクト ID。
def456コンテナ
コンテナ ID。
terminalサービス
どの Kit サービスか ── terminal、files、display……
1インスタンス
複数起動できます: terminal-1、terminal-2、terminal-3。
node-us-1サーバー
コンテナが動いているノード。
URL がインターフェースです。ポートも設定もネットワーク構築も不要。
すべてのコマンドが API 呼び出し
実行は非同期です。コマンドを投げると ID が返り、あとから結果を読みます ── あるいは WebSocket でライブにストリーミングします。
コマンドを POST します。すぐに command_id と status: running が返ります。
result エンドポイントをポーリングして、まとめた出力と終了コードを取得します。
WebSocket を開けば、ターミナルのフレームをリアルタイムで受け取れます。
すべてが組み込み済み
すべての機能は設定ゼロですぐに利用可能。ターミナルはすぐに使える状態でデプロイされます。
ブラウザの中に本格的なターミナル
どんなデバイスでも URL を開くだけ ── スマホ、タブレット、ノート PC。Web UI はクエリパラメータだけで丸ごと設定できます: シェル、フォントサイズ、読み取り専用モード、タイトル、サイドパネル。
?shell=zsh?fontSize=16?readonly=true?title=Prod?panel=/docsシェル選択
bash、zsh、fish、tmux、sh — URLパラメーターでシェルを切り替え。プリインストール済み。
自動化 API
キー入力を送り、テキストを貼り付け、画面が落ち着くのを待つ ── 対話的なプログラムを HTTP 越しに操作できます。
ターミナルスクリーンショット
API経由でターミナル状態をPNG、JPEG、GIFとしてキャプチャ。カラーとフォントサイズは設定可能。
ライブなセッション状態
作業ディレクトリ、シェル、履歴はセッションが生きている間は保持され、再接続後も残ります。
どんなサーバーにも SSH
リモートの SSH 接続としてセッションを開きます ── ホスト、ユーザー、キーをパラメータで指定。
19エンドポイント、フル制御
4つのドメイン：コマンド実行、セッション管理、WebSocket経由のライブストリーミング、システム監視。
コマンド実行
5 endpointscurl -X POST .../terminal/execute -d '{"command":"npm test"}'
セッション管理
6 endpointscurl .../terminal/sessions → [{ "terminal_id": "1", "shell": "bash" }]
ライブストリーミング
4 endpointsWS .../terminal/ws — real-time terminal frames
システム & メタ
7 endpointscurl .../system/resources → { "cpu": 45.2, "memory": { ... } }
実際のワークフローのために構築
ターミナルは開発者と自動化のシナリオ全体をカバーします。各ユースケースは特定のAPIエンドポイントにマップされます。
- 01
リモート開発
GET /terminal/wsブラウザがあるあらゆるデバイスからコンテナにSSH接続。永続的なシェルアクセス。
- 02
AIエージェントオーケストレーション
POST /terminal/executeエージェントがHTTP API経由でシェルコマンドを実行。ビルド、テスト、デプロイ — ターミナルAPIがエージェントに完全な制御を与える。
- 03
チームデバッグ
GET /terminal/sessionsマルチプレイヤーデバッグのためにターミナルURLをチームと共有。全員が同じ出力を見る。
- 04
GUIアプリケーション
?display=Nターミナルから任意のグラフィカルアプリケーションを起動。Firefox、VS Code、GIMP — terminal-NはdisplayNに自動マップ。
- 05
CI/CD統合
GET /terminal/result/{id}ビルドステップの実行、テストの実行、アーティファクトのデプロイ — すべてHTTP経由。ターミナルをあらゆるCI/CDパイプラインに統合。
- 06
ライブモニタリング
GET /system/resourcesAPI経由のリアルタイムCPU、メモリ、ディスク、ネットワーク統計。実行中プロセス一覧、シグナル送信。