# トークンを取得
$ curl https://your-terminal.hoody.com/token
> eyJhbG...
# 最初のコマンドを実行
$ curl -X POST .../api/v1/terminal/execute \
-H "Authorization: Bearer $TOKEN" \
-d '["command":"echo Hello from Hoody!","wait":true]'
> ["success":true,"stdout":"Hello from Hoody!\n","duration_ms":3]
# URLを共有 — 誰でも接続できます
https://proj-dev-terminal-1.server.containers.hoody.com
ターミナルの5つの使い方
ターミナルは作業スタイルに合わせて対応します。HTTP経由でコマンドを実行し、WebSocketでビルドをストリーミングし、チームと共有。
HTTP経由コマンド
任意のターミナルセッションにシェルコマンドをPOST。stdout、stderr、終了コードを含む構造化JSONを取得。
# 変更前 / 変更後
- ssh user@server 'ls -la /app' 2>/dev/null
+ curl -X POST terminal.hoody.com/api/v1/terminal/execute -d '["command":"ls -la /app"]'
$ curl -X POST /api/v1/terminal/execute \
-d '["command": "npm test", "wait": true]'
> HTTP/1.1 200 OK
> [
> "success": true,
> "exit_code": 0,
> "stdout": "24 passed, 0 failed",
> "duration_ms": 12
> ]
# Execute a command via Terminal HTTP API
curl -X POST \
https://proj-dev-terminal-1.hoody.com/api/v1/terminal/execute \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"command": "ls -la /app",
"wait": true
}'
# Response:
# {
# "success": true,
# "exit_code": 0,
# "stdout": "total 48\ndrwxr-xr-x ...",
# "stderr": "",
# "duration_ms": 12
# }
実際のワークフローのために構築
ターミナルは開発者と自動化のシナリオ全体をカバーします。各ユースケースは特定のAPIエンドポイントにマップされます。
リモート開発
ブラウザがあるあらゆるデバイスからコンテナにSSH接続。永続的なシェルアクセス。
AIエージェントオーケストレーション
エージェントがHTTP API経由でシェルコマンドを実行。ビルド、テスト、デプロイ — ターミナルAPIがエージェントに完全な制御を与える。
チームデバッグ
マルチプレイヤーデバッグのためにターミナルURLをチームと共有。全員が同じ出力を見る。
GUIアプリケーション
ターミナルから任意のグラフィカルアプリケーションを起動。Firefox、VS Code、GIMP — terminal-NはdisplayNに自動マップ。
CI/CD統合
ビルドステップの実行、テストの実行、アーティファクトのデプロイ — すべてHTTP経由。ターミナルをあらゆるCI/CDパイプラインに統合。
ライブモニタリング
API経由のリアルタイムCPU、メモリ、ディスク、ネットワーク統計。実行中プロセス一覧、シグナル送信。
19エンドポイント、フル制御
4つのドメイン：コマンド実行、セッション管理、WebSocket経由のライブストリーミング、システム監視。
セッション管理
7 endpointscurl .../sessions → [{terminal_id: "1", shell: "bash"}]
システム & メタ
6 endpointscurl .../system/resources → {cpu: 45%, mem: 8GB}
コマンド実行
4 endpointscurl -X POST .../execute -d '{"command":"npm test"}'
ライブストリーミング
2 endpointsWS .../sessions/1/ws → real-time stdout frames
すべてが組み込み済み
すべての機能は設定ゼロですぐに利用可能。ターミナルはすぐに使える状態でデプロイされます。
永続セッション
作業ディレクトリ、環境変数、シェル履歴 — すべてブラウザを閉じても保持される。
シェル選択
bash、zsh、fish、tmux、sh — URLパラメーターでシェルを切り替え。プリインストール済み。
tmuxブリッジ
tmuxセッションをWebとSSHアクセス間で共有。ブラウザのterminal-3はtmuxセッション3にマップ。
ターミナルスクリーンショット
API経由でターミナル状態をPNG、JPEG、GIFとしてキャプチャ。カラーとフォントサイズは設定可能。
セッションリセット
単一のURLパラメーターですべてのプロセスを強制終了し、環境をクリアし、作業ディレクトリをリセット。
OpenAPI仕様
/api/v1/terminal/openapi.jsonで自己文書化API。任意の言語で型付きクライアントを生成。