명령을 실행하고 유지되는 셸 세션을 공유해요.
https://{p}-{c}-terminal-1.{node}.computers.hoody.com 링크 복사
POST /api/v1/terminal/execute복사
터미널 예시 ×
root ~ $ pwd /root $ printf "ready\n" ready
예시 명령 실행
내 컴퓨터에서 npm test를 실행하고 출력 결과를 돌려줘요.
프롬프트 CLI SDK HTTP URL
내 컴퓨터에서 hoody-curl로 실행돼요. 링크를 열 수 있는 앱이나 AI라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. dev-box에서 테스트를 실행하고, 무엇이 실패했는지 알려 주세요. Hoody를 연결한 뒤 AI에게 이렇게 말해 보세요. 복사
hoody terminal commands run -c {c} \
--ephemeral \
--command "npm test"hoody login 후에 실행하세요. 설치: npm install -g hoody-sdk 복사
TS Python Bash
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 Python
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건을 가져와요.
프롬프트 CLI SDK HTTP URL
내 컴퓨터에서 hoody-curl로 실행돼요. 링크를 열 수 있는 앱이나 AI라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. 내 상점 데이터베이스에서 주문 10건을 보여 주세요. Hoody를 연결한 뒤 AI에게 이렇게 말해 보세요. 복사
hoody db transactions run -c {c} \
--db shop \
--transaction '[{"query":"SELECT * FROM orders LIMIT 10"}]'hoody login 후에 실행하세요. 설치: npm install -g hoody-sdk 복사
TS Python Bash
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 Python
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로
작은 스크립트를 저장하면 스크립트 고유의 웹 주소에서 응답해요.
프롬프트 CLI SDK HTTP URL
내 컴퓨터에서 hoody-curl로 실행돼요. 링크를 열 수 있는 앱이나 AI라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. 호출한 사람의 이름을 불러 인사하는 hello 엔드포인트를 만들어 주세요. 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/hellohoody login 후에 실행하세요. 설치: npm install -g hoody-sdk 복사
TS Python Bash
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 Python
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라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. 복사
문서 ↗
Agent 보기 ↗
웹, SSH 또는 CLI에서 같은 AI 세션으로 작업해요.
https://{p}-{c}-agent-1.{node}.computers.hoody.com 링크 복사
hoody agent prompt "<task>" -c <id>복사
Agent 예시 ×
Hoody AI (무료)
나테스트를 실행해 주세요.
Agent프로젝트 파일을 읽는 중… 테스트 스위트를 실행하는 중…
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 앱을 계속 실행하고, 재시작한 뒤에도 다시 실행해요.
프롬프트 CLI SDK HTTP URL
내 컴퓨터에서 hoody-curl로 실행돼요. 링크를 열 수 있는 앱이나 AI라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. /home/user/app에 있는 내 Node 앱을 재시작한 뒤에도 계속 실행해 주세요. Hoody를 연결한 뒤 AI에게 이렇게 말해 보세요. 복사
hoody daemon programs create -c {c} \
--name web \
--command "node server.js" \
--directory /home/user/app \
--user user \
--boothoody login 후에 실행하세요. 설치: npm install -g hoody-sdk 복사
TS Python Bash
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 Python
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는 프로그램을 컴퓨터와 함께 시작해요. 이후에 충돌(0이 아닌 종료 코드)이 나면 기본으로 다시 시작해요. 시작하자마자 충돌하면 몇 번 다시 시도한 뒤 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는 프로그램을 컴퓨터와 함께 시작해요. 이후에 충돌(0이 아닌 종료 코드)이 나면 기본으로 다시 시작해요. 시작하자마자 충돌하면 몇 번 다시 시도한 뒤 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라면 무엇이든 실행할 수 있어요. 링크는 믿을 수 있는 사람과만 공유하세요. 복사
문서 ↗
크론 보기 ↗
명령을 예약하고, 원하면 작업 만료 시점도 정해요.
https://{p}-{c}-cron-1.{node}.computers.hoody.com 링크 복사
POST /api/v1/cron/users/{user}/entries복사
크론 예시 ×
root/예약 작업
0 9 * * *
/root/project/report.sh 일일 보고서 활성화됨
알림 보기 ↗
데스크톱 알림을 보내거나, 열려 있는 브라우저 페이지로 전달해요.
https://{p}-{c}-n-1.{node}.computers.hoody.com 링크 복사
POST /api/v1/notifications/notify복사
알림 예시 ×
빌드 완료 프로젝트를 검토할 준비가 됐어요.
브라우저 중계에는 권한과 열려 있고 연결된 페이지가 필요해요.
Pipe 보기 ↗
이름 붙인 링크로 기기 사이에 바이트를 스트리밍해요.
https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name} 링크 복사
PUT /api/v1/pipe/{name} · GET to receive복사
Pipe 예시 ×
/api/v1/pipe/report
보내는 쪽 PUT
바이트 → 바이트
받는 쪽 GET
아웃바운드 트래픽 보기 ↗
컴퓨터를 프록시로 쓰거나, 업스트림 프록시를 설정해요.
https://{p}-{c}-egress-1.{node}.computers.hoody.com 링크 복사
GET /api/v1/egress/upstream복사
아웃바운드 트래픽 예시 ×
아웃바운드 프록시
클라이언트 HTTP 요청
컴퓨터 → 업스트림
업스트림 SOCKS5/HTTP
터널 보기 ↗
로컬 웹 앱을 공개하거나 로컬 TCP 서비스에 접속해요.
https://{p}-{c}-tunnel-1.{node}.computers.hoody.com 링크 복사
https://{p}-{c}-http-{port}.{node}.computers.hoody.com복사
터널 예시 ×
로컬 웹 앱 공개
노트북 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