コマンドを実行し、保持されるシェルセッションを共有します。
https://{p}-{c}-terminal-1.{node}.computers.hoody.com
POST /api/v1/terminal/execute
ターミナル 例
root ~
$ pwd
/root
$ printf "ready\n"
ready
例 コマンドを実行
コンピューターでnpm testを実行し、出力を返します。
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。 dev-boxでテストを実行し、失敗した内容を教えてください。
AIとHoodyを連携したら、AIにこう伝えます。
hoody terminal commands run -c {c} \
--ephemeral \
--command "npm test"
hoody loginの後に実行します。インストール:npm install -g hoody-sdk
import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const out = await box.terminal.run('npm test');
console.log(out.stdout);
npm install hoody-sdk · TypeScript
import requests
r = requests.post(
"https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true",
json={"command": "npm test"},
)
print(r.json())
pip install requests · 素のHTTPで、HTTPタブと同じ呼び出しです。
BASE="https://{p}-{c}-terminal-0.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/terminal/execute?ephemeral=true" \
-H "Content-Type: application/json" \
-d '{"command": "npm test"}'
curl · 素のHTTPで、HTTPタブと同じ呼び出しです。
curl -X POST "https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true" \
-H "Content-Type: application/json" \
-d '{"command": "npm test"}'
コンピューターが開いている間、トークンは不要です。リンク内の{p}-{c}の組がキーです。
import requests
r = requests.post(
"https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true",
json={"command": "npm test"},
)
print(r.json())
pip install requests · コンピューターが開いている間、トークンは不要です。リンク内の{p}-{c}の組がキーです。
https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true&method=POST&json={"command":"npm%20test"}&response=transparent
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。
ドキュメント ↗
ディスプレイ
Linuxアプリをブラウザーで開きます。
https://{p}-{c}-display-1.{node}.computers.hoody.com
GET /api/v1/display/screenshot
ディスプレイの例
ドキュメントエディター
プロジェクトノート
下書きを確認する。
ディスプレイのリンクを共有する。
ブラウザー
HTTPでChromiumまたはFirefoxを操作します。
https://{p}-{c}-browser-1.{node}.computers.hoody.com
GET /api/v1/browser/snapshot
ブラウザーの例
Chromium · 例のページ
調査ノート
ページを読む。要素を調べる。
結果をキャプチャする。
コード
VS Codeをブラウザーのタブで使います。
https://{p}-{c}-code-1.{node}.computers.hoody.com
https://{p}-{c}-code-1.{node}.computers.hoody.com/?folder=<path>
コードの例
VS Code · app.ts
1 export function greet() {
2 return "Hello";
3 }
ファイル
ファイルをリンクから閲覧、編集、ダウンロードできます。
https://{p}-{c}-files-1.{node}.computers.hoody.com
GET /api/v1/files/{path}
ファイルの例
/root/project/
src/フォルダー
app.tsファイル
notes.mdファイル
HTTPでSQLデータベースやキーバリューデータにクエリを実行します。
https://{p}-{c}-sqlite-1.{node}.computers.hoody.com
POST /api/v1/sqlite/db
SQLiteの例
SELECT title FROM notes;
title
プロジェクトノート
リリースチェックリスト
例 データベースにクエリを実行
ショップのデータベースから、最初の10件の注文を取得します。
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。 ショップのデータベースから注文を10件表示してください。
AIとHoodyを連携したら、AIにこう伝えます。
hoody db transactions run -c {c} \
--db shop \
--transaction '[{"query":"SELECT * FROM orders LIMIT 10"}]'
hoody loginの後に実行します。インストール:npm install -g hoody-sdk
import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const { data } = await box.sqlite.sql.runTransaction(
{ transaction: [{ query: 'SELECT * FROM orders LIMIT 10' }] },
{ db: 'shop' },
);
npm install hoody-sdk · TypeScript
import requests
r = requests.post(
"https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop",
json={"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]},
)
print(r.json())
pip install requests · 素のHTTPで、HTTPタブと同じ呼び出しです。
BASE="https://{p}-{c}-sqlite-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/sqlite/db?db=shop" \
-H "Content-Type: application/json" \
-d '{"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]}'
curl · 素のHTTPで、HTTPタブと同じ呼び出しです。
curl -X POST "https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop" \
-H "Content-Type: application/json" \
-d '{"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]}'
コンピューターが開いている間、トークンは不要です。リンク内の{p}-{c}の組がキーです。
import requests
r = requests.post(
"https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop",
json={"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]},
)
print(r.json())
pip install requests · コンピューターが開いている間、トークンは不要です。リンク内の{p}-{c}の組がキーです。
https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop&method=POST&json={"transaction":[{"query":"SELECT%20*%20FROM%20orders%20LIMIT%2010"}]}&response=transparent
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。
ドキュメント ↗
JavaScriptまたはTypeScriptのファイルをHTTPエンドポイントにします。
https://{p}-{c}-exec-1.{node}.computers.hoody.com/{script}
GET /{script}
Execの例
hello.ts → /hello
// @mode serverless
return { message: "Hello" };{"message":"Hello"}
例 スクリプトがURLになる
短いスクリプトを保存すると、専用のWebアドレスで応答します。
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。 呼び出した人の名前であいさつするhelloエンドポイントを作ってください。
AIとHoodyを連携したら、AIにこう伝えます。
hoody exec scripts write -c {c} \
--path api/hello.js \
--content '// @mode serverless
return { hello: metadata.query.name || "World" };'
# live at https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello
hoody loginの後に実行します。インストール:npm install -g hoody-sdk
import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
await box.exec.scripts.write({
path: 'api/hello.js',
content: '// @mode serverless\nreturn { hello: metadata.query.name || "World" };',
});
npm install hoody-sdk · TypeScript
import requests
r = requests.post(
"https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write",
json={
"path": "api/hello.js",
"content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };",
},
)
print(r.json())
# then call it
print(requests.get("https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello", params={"name": "Ada"}).json())
pip install requests · 素のHTTPで、HTTPタブと同じ呼び出しです。
BASE="https://{p}-{c}-exec-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/exec/scripts/write" \
-H "Content-Type: application/json" \
-d '{"path": "api/hello.js", "content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };"}'
# then call it
curl "$BASE/api/hello?name=Ada"
curl · 素のHTTPで、HTTPタブと同じ呼び出しです。
curl -X POST "https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write" \
-H "Content-Type: application/json" \
-d '{"path": "api/hello.js", "content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };"}'
# then call it
curl "https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello?name=Ada"
スクリプトは、書き終えるとすぐ/api/helloで動きます。
import requests
r = requests.post(
"https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write",
json={
"path": "api/hello.js",
"content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };",
},
)
print(r.json())
# then call it
print(requests.get("https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello", params={"name": "Ada"}).json())
pip install requests · スクリプトは、書き終えるとすぐ/api/helloで動きます。
https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write&method=POST&json={"path":"api/hello.js","content":"//%20@mode%20serverless\nreturn%20{%20hello:%20metadata.query.name%20||%20\"World\"%20};"}&response=transparent
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。
ドキュメント ↗
エージェント
Web、SSH、CLIから同じAIセッションを使えます。
https://{p}-{c}-agent-1.{node}.computers.hoody.com
hoody agent prompt "<task>" -c <id>
エージェントの例
Hoody AI(無料)
ユーザーテストを実行してください。
エージェントプロジェクトのファイルを読み取り中…
テストスイートを実行中…
Curl
HTTPリクエストを、共有やスケジュール実行ができるリンクにします。
https://{p}-{c}-curl-1.{node}.computers.hoody.com
POST /api/v1/curl/request
Curlの例
保存済みのリクエスト
メソッドPOST
ボディ{"event":"ready"}
レスポンス200 OK
サーバーやワーカーを動かし続けます。自動で再起動します。
https://{p}-{c}-daemon-1.{node}.computers.hoody.com
POST /api/v1/daemon/programs/add
デーモンの例
プログラム
web実行中
worker実行中
再起動ポリシー失敗時
例 プログラムを動かし続ける
Nodeアプリを動かし続け、再起動後にもう一度起動します。
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。 /home/user/appにあるNodeアプリを、再起動後も動かし続けてください。
AIとHoodyを連携したら、AIにこう伝えます。
hoody daemon programs create -c {c} \
--name web \
--command "node server.js" \
--directory /home/user/app \
--user user \
--boot
hoody loginの後に実行します。インストール:npm install -g hoody-sdk
import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
await box.daemon.programs.create({
name: 'web',
command: 'node server.js',
directory: '/home/user/app',
user: 'user',
boot: true,
});
npm install hoody-sdk · TypeScript
import requests
r = requests.post(
"https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add",
json={
"name": "web",
"command": "node server.js",
"directory": "/home/user/app",
"user": "user",
"boot": True,
},
)
print(r.json())
pip install requests · 素のHTTPで、HTTPタブと同じ呼び出しです。
BASE="https://{p}-{c}-daemon-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/daemon/programs/add" \
-H "Content-Type: application/json" \
-d '{"name": "web", "command": "node server.js", "directory": "/home/user/app", "user": "user", "boot": true}'
curl · 素のHTTPで、HTTPタブと同じ呼び出しです。
curl -X POST "https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add" \
-H "Content-Type: application/json" \
-d '{"name": "web", "command": "node server.js", "directory": "/home/user/app", "user": "user", "boot": true}'
bootを指定すると、コンピューターの起動と同時に開始します。起動後にクラッシュ(ゼロ以外の終了コード)した場合は、既定で再起動します。起動直後にクラッシュする場合は数回再試行し、その後fatalの状態になります。
import requests
r = requests.post(
"https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add",
json={
"name": "web",
"command": "node server.js",
"directory": "/home/user/app",
"user": "user",
"boot": True,
},
)
print(r.json())
pip install requests · bootを指定すると、コンピューターの起動と同時に開始します。起動後にクラッシュ(ゼロ以外の終了コード)した場合は、既定で再起動します。起動直後にクラッシュする場合は数回再試行し、その後fatalの状態になります。
https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add&method=POST&json={"name":"web","command":"node%20server.js","directory":"/home/user/app","user":"user","boot":true}&response=transparent
コンピューター上のhoody-curlで実行します。リンクを開けるアプリやAIなら、どれでも実行できます。リンクは、信頼できる人にだけ共有してください。
ドキュメント ↗
Cron
コマンドをスケジュール実行します。ジョブに有効期限も設定できます。
https://{p}-{c}-cron-1.{node}.computers.hoody.com
POST /api/v1/cron/users/{user}/entries
Cronの例
root / スケジュールジョブ
0 9 * * *
/root/project/report.sh
日次レポート有効
通知
デスクトップ通知を送るか、開いているブラウザーのページに中継します。
https://{p}-{c}-n-1.{node}.computers.hoody.com
POST /api/v1/notifications/notify
通知の例
ビルドが完了しましたプロジェクトを確認できます。
ブラウザーへの中継には、許可と、開いて接続済みのページが必要です。
パイプ
名前付きリンクを通して、デバイス間でバイト列をストリーミングします。
https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name}
PUT /api/v1/pipe/{name} · GET to receive
パイプの例
/api/v1/pipe/report
送信側PUT
バイト列 → バイト列
受信側GET
外向き通信
コンピューターをプロキシとして使うか、上流プロキシを設定します。
https://{p}-{c}-egress-1.{node}.computers.hoody.com
GET /api/v1/egress/upstream
外向き通信の例
外向きプロキシ
クライアントHTTPリクエスト
コンピューター → 上流
上流SOCKS5 / HTTP
トンネル
ローカルのWebアプリを公開するか、ローカルのTCPサービスに接続します。
https://{p}-{c}-tunnel-1.{node}.computers.hoody.com
https://{p}-{c}-http-{port}.{node}.computers.hoody.com
トンネルの例
ローカルのWebアプリを公開
ノートパソコンlocalhost:3000
WebSocket → コンピューター
公開リンクhttp-3000
プログラム制限
デーモンを制限します。読み取り専用のファイル、ポートとプロセスの制限、専用のファイアウォールを設定します。
https://{p}-{c}-daemon-1.{node}.computers.hoody.com
POST /api/v1/daemon/programs/edit/{id}
プログラム制限の例
プログラムポリシー · root以外のユーザー
書き込み可/data
TCPポート443
メモリ256 MiB