본문으로 건너뛰기
내 AI@https://hoody.com Connect to Hoody
hoody / capabilities

Hoody의 모든 기능

Hoody로 할 수 있는 일
다섯 가지 개념, 500 항목

Hoody는 몇 가지 개념을 반복해서 써요. 다섯 가지 개념부터 보고, 쉬운 말로 풀어 쓴 구성 요소를 차례로 살펴보세요. 500 항목을 52 그룹으로 나눴어요. 항목마다 AI에게 할 말을 적었어요. 대부분의 항목에는 믿고 쓰기 전에 알아 둘 점과 문서 링크도 있어요. AI는 이 항목들을 조합해 더 많은 일을 해요.

항목마다 id가 있어서 바로 링크할 수 있어요. 예: /capabilities/#c120. 페이지에서 찾으려면 브라우저의 찾기 기능을 쓰세요.

hoody / capabilities / ideas

목록을 보기 전에

모든 항목에 담긴 다섯 가지 개념

목록은 길지만 개념은 몇 가지뿐이에요. 아래 항목은 모두 이 다섯 가지 중 하나가 실제로 쓰이는 모습이에요.

내 AI

생각과 대화를 맡아요.

Hoody AI는 무료이고 기본으로 들어 있어요. 내 ChatGPT나 Claude 요금제, 또는 다른 AI를 쓸 수도 있어요.

Hoody

내 것으로 남는 기반.

인프라는 Hoody가 호스팅하고 운영해요. AI가 모든 부분을 쓸 수 있어요.

Kit

모든 서비스가 포함돼요. 서비스마다 URL이 있어요.

터미널, 데스크톱, 파일, 브라우저, 데이터베이스 등이 컴퓨터마다 들어 있어요. Kit 보기

  1. 항상 켜져 있는 컴퓨터

    Hoody 컴퓨터는 클라우드에 있는 완전한 Linux 컴퓨터예요. 탭을 닫아도 계속 실행돼요.

    요청 한 번이면 만들어져요POST https://api.hoody.com/api/v1/projects/{p}/computers
    내게 달라지는 점

    자리를 비워도 사이트와 작업은 계속 실행되고, 파일도 그대로 남아 있어요. AI에게 컴퓨터를 만들어 달라고 하면 바로 준비돼요.

    c01 계속 실행되는 컴퓨터a02 필요할 때 만드는 컴퓨터x04 스냅샷과 되돌리기docs / concepts / computers

  2. 모든 것에 URL이 있어요

    컴퓨터 안의 도구마다 HTTPS 링크가 따로 있어요. 링크에서 단어 하나만 바꾸면 다른 도구로 들어가요.

    같은 컴퓨터, 도구 두 개https://{p}-{c}-terminal-1.{node}.computers.hoody.comhttps://{p}-{c}-display-1.{node}.computers.hoody.com
    내게 달라지는 점

    설치할 것은 없어요. 나도, 스크립트도, AI도 같은 링크를 열어요.

    x01 모든 것이 URLc24 사이트와 앱 바로 공개x02 실시간 공동 작업docs / concepts / everything-is-a-url

  3. API 하나, 일반 HTTP

    Hoody에서 할 수 있는 일은 AI나 스크립트도 할 수 있어요. API는 HTTP를 사용하는 일반 REST API예요.

    프로젝트 목록 보기curl "https://api.hoody.com/api/v1/projects/" \ -H "Authorization: Bearer $HOODY_TOKEN"SDK로도 할 수 있어요npm install hoody-sdk
    내게 달라지는 점

    SDK는 선택 사항이에요. 웹 요청을 보낼 수 있으면 무엇이든 Hoody를 다룰 수 있어요. curl, 스크립트, AI 모두 가능해요.

    a01 모든 것을 API 하나로x09 @hoody.com으로 말하기x10 ssh hoody.comdocs / foundation / hoody-apigithub / hoody-sdk

  4. Bot과 에이전트가 맡는 작업

    Bot은 오래 이어지는 채팅 하나예요. 맡긴 작업을 내 컴퓨터의 에이전트에게 넘기고, 에이전트가 한 일을 알려 줘요.

    고유 주소가 있는 Bothttps://<label>.hoody.bot
    내게 달라지는 점

    평소 쓰는 말로 원하는 일을 부탁하세요. Telegram, Slack, Discord에서 같은 Bot이 답해요.

    b01 내 Botb10 모든 채팅 앱에서 같은 Botb11 내 모든 컴퓨터의 Hoody AgentBots 페이지

  5. 비공개 링크, 실제 잠금

    생성된 링크는 추측할 수 없어서, 공유하기 전에는 링크가 드러나지 않아요. 비밀번호, 로그인, IP 목록으로 어떤 링크든 잠글 수 있어요.

    그룹에 속하지 않은 사람은 모두 거부"default": "deny"
    내게 달라지는 점

    어떤 도구를 누가 열지 직접 정해요. 규칙을 정하기 전에는 링크가 있는 사람 누구나 열 수 있어요.

    x05 비공개 링크x06 모든 링크 잠금x23 암호화된 디스크docs / concepts / security

hoody / capabilities / computers

01 264 항목

컴퓨터

항상 켜져 있는 컴퓨터를 브라우저에서 열어요. 도구마다 링크가 따로 있어요.

상시 실행과 데스크톱 10

  • c01

    항상 켜져 있는 컴퓨터

    탭을 닫아도 컴퓨터는 켜진 채 계속 실행돼요.

    AI에 이렇게 말하세요
    이걸 내 Hoody 컴퓨터에서 계속 실행해 주세요.

    docs / foundation / computers / managing

  • c02

    탭 안의 데스크톱

    브라우저에서 전체 데스크톱을 열어요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 컴퓨터에서 데스크톱을 열어 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 데스크톱을 쓸 수 있어요.

    docs / kit / displays

  • c03

    모든 Linux 앱

    Linux 앱을 실행하고 어떤 브라우저에서든 써요. 휴대폰도 돼요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    LibreOffice를 실행하고 링크를 보내 주세요.

    docs / kit / displays

  • c04

    AI가 화면을 써요

    데스크톱에서 AI가 클릭하고, 입력하고, 창을 읽고, 스크린샷을 찍을 수 있어요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshot

    AI에 이렇게 말하세요
    내 데스크톱 스크린샷을 찍고 저장을 클릭해 주세요.

    docs / kit / displays

  • c05

    기기 간 복사와 붙여넣기

    내 기기와 데스크톱 사이에서 복사하고 붙여 넣어요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    이 텍스트를 데스크톱 앱에 붙여 넣어 주세요.

    알아 두기붙여 넣기가 동작하기 전에 브라우저가 클립보드 권한을 물어볼 수 있어요.

    docs / kit / displays

  • c55

    컴퓨터 일시정지

    컴퓨터를 일시정지했다가 몇 초 만에 재개해요. 세션과 메모리는 그대로 남아 있어요.

    링크https://api.hoody.com/api/v1/computers/{id}/pause

    AI에 이렇게 말하세요
    내 개발 컴퓨터를 내일까지 일시정지해 주세요.

    알아 두기일시 중지된 컴퓨터는 RAM과 디스크 사용량을 그대로 유지하고, 재개하기 전까지 서비스 URL은 오류를 반환해요. 서버를 재부팅하면 일시 중지 상태가 사라져요.

    docs / foundation / computers / managing

  • c56

    별도 화면 여러 개

    별도 데스크톱을 실행해요. 해상도, 창, 앱이 각각 따로예요.

    AI에 이렇게 말하세요
    브라우저와 에디터를 별도 화면으로 나눠 주세요.

    알아 두기세션은 시작하기 전에 화면 번호마다 설정해야 해요.

    docs / kit / displays

  • c57

    데스크톱 환경 선택

    Xfce 또는 MATE 데스크톱 환경으로 화면을 시작해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AI에 이렇게 말하세요
    MATE 데스크톱으로 화면을 시작해 주세요.

    알아 두기기존 터미널 세션은 설정을 그대로 유지해요.

    docs / kit / displays

  • c58

    일반 컴퓨터 설정

    Kit 서비스 없이 컴퓨터를 만들고 직접 HTTP 서버를 실행해요.

    링크https://api.hoody.com/api/v1/projects/{p}/computers

    AI에 이렇게 말하세요
    내 웹 서버용 일반 컴퓨터를 만들어 주세요.

    알아 두기기본 컴퓨터에는 내장 브라우저 셸이 없어요. 처음 SSH로 접속하려면 SSH 공개 키를 설정하세요.

    docs / foundation / computers / create-edit-delete

  • c59

    화면 중지

    화면을 중지하고 화면에서 실행 중인 프로그램을 종료해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/displays/{displayId}/stop

    AI에 이렇게 말하세요
    화면 1을 중지하고 프로그램도 종료해 주세요.

    알아 두기화면을 중지하면 저장하지 않은 작업을 포함해 그 화면에서 실행 중인 모든 프로그램이 종료돼요.

    docs / kit / displays

데스크톱 뷰어 옵션 9

  • c60

    데스크톱 파일 전송

    브라우저와 화면 사이에서 파일을 전송해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    이 파일을 내 화면으로 전송해 주세요.

    docs / api / displays / feature-flags

  • c61

    데스크톱 오디오 듣기

    화면의 오디오를 보고 있는 브라우저에서 재생해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?sound=true

    AI에 이렇게 말하세요
    내 데스크톱 오디오를 이 브라우저에서 재생해 주세요.

    docs / api / displays / web-client

  • c62

    프레젠테이션 보기

    공유된 데스크톱을 클릭도 입력도 할 수 없는 보기 전용 뷰어로 열어요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?sharing=true&steal=false&readonly=true

    AI에 이렇게 말하세요
    데스크톱 프레젠테이션용 뷰어 링크를 주세요.

    알아 두기읽기 전용 보기 모드는 접근 제어가 아니에요. HTTP API는 여전히 입력을 받고, 프록시 권한에는 보기 전용 수준이 없어요.

    docs / kit / displays

  • c63

    데스크톱에서 인쇄

    화면의 인쇄 작업을 브라우저로 전달해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    내 데스크톱에서 이 문서를 인쇄해 주세요.

    docs / api / displays / feature-flags

  • c64

    키보드 배열 선택

    데스크톱 뷰어의 키보드 배열을 선택해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard_layout=gb

    AI에 이렇게 말하세요
    내 데스크톱에서 영국식 키보드 배열을 사용해 주세요.

    docs / kit / displays

  • c65

    터치스크린 키보드

    터치스크린에서 데스크톱을 쓸 때 가상 키보드를 보여 줘요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard=true

    AI에 이렇게 말하세요
    터치스크린 노트북에서 가상 키보드를 보여 주세요.

    docs / kit / displays / reference

  • c66

    화면 대역폭 제한

    느린 연결에서 쓰는 데스크톱 뷰어에 대역폭 상한을 설정해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?quality_mode=reduced&bandwidth_limit=500000

    AI에 이렇게 말하세요
    내 데스크톱 뷰어를 500Kbps로 제한해 주세요.

    docs / kit / displays / reference

  • c67

    열 때 앱 포커스

    이름을 지정한 창을 최대화하고 포커스한 상태로 뷰어를 열어요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?app=Firefox

    AI에 이렇게 말하세요
    Firefox를 맨 앞에 두고 내 데스크톱을 열어 주세요.

    알아 두기이 동작은 화면을 보는 모든 사용자에게 다른 창을 최소화해요.

    docs / api / displays / web-client

  • c68

    뷰어 사용자 지정

    어두운 데스크톱 뷰어와 플로팅 메뉴를 사용해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?dark_mode=true&floating_menu=true

    AI에 이렇게 말하세요
    어두운 뷰어와 플로팅 메뉴로 내 데스크톱을 열어 주세요.

    docs / kit / displays

데스크톱 자동화 7

  • c69

    창 이동과 크기 조절

    API로 데스크톱 창을 이동하거나 크기를 조절하고, 최소화하거나 복원하거나 닫아요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/window/resize

    AI에 이렇게 말하세요
    브라우저 창을 데스크톱 전체 크기로 조절해 주세요.

    알아 두기일부 창 동작에는 윈도 매니저가 있는 데스크톱이 필요해요.

    docs / kit / displays

  • c70

    창 대기

    앱 창이 나타날 때까지 기다린 뒤 자동화를 이어서 진행해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/wait-until

    AI에 이렇게 말하세요
    Firefox가 열릴 때까지 기다린 뒤 이어서 진행해 주세요.

    알아 두기대기는 최대 25초예요. 시간이 지나면 timedOut이 true로 설정된 HTTP 200을 반환해요.

    docs / kit / displays

  • c71

    데스크톱 동작 일괄 실행

    데스크톱 동작 여러 개를 API 호출 한 번으로 순서대로 실행해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/batch

    AI에 이렇게 말하세요
    데스크톱 브라우저에서 hoody.com을 한 번에 열어 주세요.

    알아 두기배치 하나는 동작 1~50개를 실행하고 첫 실패에서 멈춰요. 앞선 동작은 완료된 상태로 남고, 동작 사이에 다른 입력이 실행될 수 있어요.

    docs / kit / displays

  • c72

    실행 후 캡처

    API 호출 한 번으로 데스크톱 동작을 실행하고 결과를 캡처해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/act

    AI에 이렇게 말하세요
    버튼을 클릭하고 결과 화면을 캡처해 주세요.

    알아 두기동작 뒤에 스크린샷이 실패해도 동작은 이미 완료된 상태예요.

    docs / api / displays / input-actions

  • c73

    API로 쓰는 데스크톱 클립보드

    API 호출 한 번으로 데스크톱 클립보드의 텍스트를 읽거나 설정해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/clipboard

    AI에 이렇게 말하세요
    이 주소를 내 데스크톱 클립보드에 넣어 주세요.

    docs / api / displays / screenshots

  • c74

    저장된 데스크톱 스크린샷

    데스크톱에 저장된 스크린샷 목록을 보고, 시간이나 파일 이름으로 원하는 스크린샷을 가져와요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshots

    AI에 이렇게 말하세요
    10분 전 데스크톱 스크린샷을 보여 주세요.

    알아 두기조회는 저장된 캡처 중 최신 500개를 검색해요.

    docs / api / displays / screenshots

  • c75

    데스크톱 썸네일

    갤러리에 쓸 데스크톱 축소 이미지를 캡처해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/thumbnail

    AI에 이렇게 말하세요
    내 데스크톱 썸네일을 만들어 주세요.

    알아 두기썸네일은 화면 크기의 20%로 축소돼요.

    docs / api / displays / screenshots

터미널과 브라우저 12

  • c06

    링크로 여는 터미널

    어떤 브라우저에서든 전체 터미널을 쓸 수 있어요. SSH 키를 설정할 필요가 없어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 컴퓨터에서 터미널을 열어 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 터미널을 쓸 수 있어요.

    docs / kit / terminals

  • c07

    링크로 실행하는 명령

    AI가 명령을 실행하고, 출력과 오류를 돌려받아요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AI에 이렇게 말하세요
    테스트를 실행하고 실패한 항목을 알려 주세요.

    docs / kit / terminals

  • c08

    전체 화면 터미널 앱

    AI가 전체 화면 터미널 프로그램을 키를 하나씩 눌러 조작할 수 있어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    htop을 열고 메모리를 가장 많이 쓰는 게 무엇인지 알려 주세요.

    docs / kit / terminals / automation

  • c09

    다른 서버에 접속

    웹 터미널에서 다른 서버에 SSH로 접속해요. 클라이언트는 필요 없어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 예전 서버에 접속해서 디스크 공간을 확인해 주세요.

    docs / kit / terminals

  • c10

    AI가 조작하는 브라우저

    Chromium 또는 Firefox 브라우저를 실행해요. AI가 탐색하고, 읽고, 클릭할 수 있어요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    요금 페이지를 열고 요금제를 표로 정리해 주세요.

    알아 두기기본적으로 1시간 동안 쓰지 않은 브라우저는 중지되고, 탭과 쿠키도 사라져요. 다음 호출에서는 새 브라우저가 시작돼요.

    docs / kit / browser

  • c11

    페이지 스크린샷과 PDF

    백그라운드 브라우저로 웹 페이지를 스크린샷으로 찍거나 PDF로 저장해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/pdf

    AI에 이렇게 말하세요
    이 기사를 PDF로 저장해 주세요.

    알아 두기PDF에는 백그라운드 Chromium이 필요해요. 기본 브라우저는 화면에 보이는 브라우저예요.

    docs / kit / browser

  • c76

    별도 터미널 세션

    컴퓨터의 파일과 프로세스를 공유하는 셸 세션을 따로 열어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    빌드용 터미널을 하나 더 열어 주세요.

    알아 두기새 세션의 ID는 1~9999 범위에서 배정돼요. ID 4501~5000은 에이전트용으로 예약돼 있고, 동시에 실행되는 수는 컴퓨터 리소스에 따라 달라요.

    docs / kit / terminals

  • c77

    셸 상태 유지

    관련 명령을 한 세션에서 실행하면 작업 디렉터리와 변수가 유지돼요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AI에 이렇게 말하세요
    프로젝트 디렉터리로 이동해서 빌드를 실행해 주세요.

    알아 두기세션은 삭제, 컴퓨터 재시작, 터미널 서비스 재시작, 유휴 정리 때 종료돼요.

    docs / kit / terminals

  • c78

    오래 걸리는 명령 확인

    오래 걸리는 명령을 시작하고, 실행 중에 출력과 상태를 확인해요.

    AI에 이렇게 말하세요
    빌드를 시작하고 진행 상황을 확인해 주세요.

    알아 두기유지되는 세션의 타임아웃은 결과를 알려 주는 기한이고, 실행 중인 명령을 중지하지 않아요.

    docs / kit / terminals

  • c79

    명령 중지

    실행 중인 터미널 명령을 중단하거나, 대기 중인 명령을 취소해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute/{command_id}/abort

    AI에 이렇게 말하세요
    내가 시작한 빌드 명령을 중지해 주세요.

    알아 두기타임아웃 뒤에는 터미널에 다른 입력이 들어오지 않았고 셸이 아직 실행 중일 때만 중단할 수 있어요.

    docs / kit / terminals / reference

  • c80

    입력 없이 보기

    터미널을 읽기 전용으로 열어 입력은 보내지 않고 세션을 지켜봐요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?readonly=true

    AI에 이렇게 말하세요
    터미널의 보기 전용 링크를 주세요.

    알아 두기읽기 전용 모드는 해당 클라이언트의 입력만 막아요. URL을 열 수 있는 사람은 프록시 권한이 정해요.

    docs / kit / terminals

  • c81

    정확한 명령 출력

    명령을 실행하고 출력 바이트를 그대로 받아요. stdout과 stderr는 따로 받아요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AI에 이렇게 말하세요
    이 명령을 실행하고 바이너리 출력을 그대로 주세요.

    알아 두기원시 모드는 명령이 끝날 때까지 기다리고, 터미널 세션 밖에서 실행돼요. 각 스트림은 서버가 정한 한도까지 캡처해요.

    docs / api / terminal / commands

터미널 옵션 10

  • c82

    셸 선택

    bash, zsh, fish, sh 또는 tmux로 브라우저 터미널을 시작해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?shell={shell}

    AI에 이렇게 말하세요
    zsh로 내 터미널을 열어 주세요.

    알아 두기셸 설정은 세션을 시작할 때 적용돼요. 실행 중인 세션의 셸을 바꾸려면 reset=true를 추가하세요.

    docs / kit / terminals / reference

  • c83

    그래픽 앱 시작

    터미널을 화면과 짝지어 화면에서 프로그램을 열어요.

    AI에 이렇게 말하세요
    터미널 2에서 화면 2에 Firefox를 시작해 주세요.

    알아 두기API로 만든 세션은 생성 요청 본문에서 화면 설정을 읽어요.

    docs / kit / terminals

  • c84

    SSH로 tmux 참여

    터미널 번호로 브라우저의 tmux 세션에 SSH로 참여해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?shell=tmux

    AI에 이렇게 말하세요
    SSH로 터미널 3에 참여하는 방법을 알려 주세요.

    docs / kit / terminals

  • c85

    터미널 사이드 패널

    한 페이지에서 터미널 옆에 Hoody Agent나 런북, 대시보드를 보여 줘요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?panel={url}

    AI에 이렇게 말하세요
    터미널 1 옆에 내 에이전트를 열어 주세요.

    알아 두기URL을 공유하면 터미널과 패널도 함께 공유돼요.

    docs / api / terminal / web-interface

  • c86

    임시 셸 세션

    ID가 부여되고 스스로 정리되는 임시 터미널을 만들어요.

    AI에 이렇게 말하세요
    이 스크립트를 임시 터미널에서 실행해 주세요.

    알아 두기서비스가 5001~7999 사이에서 ID를 골라요. 세션에는 화면이 없고, 끝난 결과는 기본적으로 5분 동안 가져올 수 있어요.

    docs / kit / terminals / reference

  • c87

    터미널 시작 시 실행

    로컬 터미널의 셸 프롬프트가 나타나기 전에 시작 스크립트를 실행해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AI에 이렇게 말하세요
    터미널 2가 시작될 때 내 설정 스크립트를 실행해 주세요.

    알아 두기SSH 세션은 시작 스크립트를 실행하지 않아요. 세션에 지정하는 스크립트는 `..` 없이 절대 경로여야 해요.

    docs / kit / terminals / reference

  • c88

    프록시를 거치는 SSH

    터미널의 SSH 연결을 SOCKS5 프록시로 거쳐 호스트에 접속해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AI에 이렇게 말하세요
    내 SOCKS5 프록시를 거쳐 내 서버에 접속해 주세요.

    알아 두기SSH 호스트 키는 확인하지 않아요. SSH 자격 증명과 SOCKS5 설정은 생성 요청 본문에 넣으세요.

    docs / kit / terminals / reference

  • c89

    명령 환경

    로컬 터미널 세션에서 명령 하나에 환경 변수를 전달해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AI에 이렇게 말하세요
    DEBUG를 1로 설정하고 테스트를 실행해 주세요.

    알아 두기SSH 세션에서는 전달한 변수가 원격 셸로 내보내져 남아 있어요.

    docs / api / terminal / commands

  • c90

    터미널 화면 사용자 지정

    링크로 터미널 탭 제목, 글꼴 크기, 배경색을 설정해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    터미널 글자를 더 크게 하고 탭 제목을 Build로 해 주세요.

    알아 두기글꼴 크기는 8~72픽셀이에요. 탭 제목은 최대 200자예요.

    docs / api / terminal / web-interface

  • c91

    스크린 리더 모드

    링크로 브라우저 터미널의 스크린 리더 지원을 켜요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?screenReaderMode=true

    AI에 이렇게 말하세요
    스크린 리더 지원을 켠 상태로 터미널을 열어 주세요.

    docs / api / terminal / web-interface

터미널 자동화 6

  • c92

    터미널 출력 대기

    일치하는 프롬프트가 나오거나 화면이 안정될 때까지 기다린 뒤 다음 단계로 넘어가요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/wait

    AI에 이렇게 말하세요
    Python 프롬프트가 나타날 때까지 기다려 주세요.

    알아 두기대기 시간 제한은 기본 5000ms이고, 10~300000ms까지 지정할 수 있어요.

    docs / kit / terminals / automation

  • c93

    터미널 화면 검색

    터미널 화면이나 스크롤백에서 패턴을 검색하고 일치한 위치를 받아요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/find

    AI에 이렇게 말하세요
    내 터미널 스크롤백에서 오류 메시지를 찾아 주세요.

    알아 두기패턴은 최대 1,024바이트예요. 검색 결과는 최대 1,000건이고, 검색 시간은 500ms로 제한돼요.

    docs / kit / terminals / automation

  • c94

    터미널 명령 기록

    세션에 남아 있는 명령 기록을 상태와 종료 코드까지 가져와요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/history/{terminal_id}

    AI에 이렇게 말하세요
    터미널 1에서 실행한 명령을 보여 주세요.

    알아 두기기록은 기본적으로 최근 100건만 담는 롤링 윈도우예요. 전체 기록이 필요하면 쌓이는 대로 가져오세요.

    docs / kit / terminals / reference

  • c95

    터미널 출력 내보내기

    남아 있는 터미널 출력을 다운로드하거나 마지막 줄을 텍스트나 HTML로 가져와요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/raw

    AI에 이렇게 말하세요
    터미널 1의 최신 출력을 다운로드해 주세요.

    알아 두기출력은 기본적으로 최대 8MB까지 보관하고, 넘치면 오래된 것부터 버려요.

    docs / kit / terminals / reference

  • c96

    터미널 스크린샷

    터미널 출력을 튜토리얼이나 대시보드에 쓸 이미지로 만들어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/screenshot

    AI에 이렇게 말하세요
    내 터미널의 PNG 스크린샷을 저장해 주세요.

    알아 두기PNG, JPEG, GIF 중에서 고르세요. 이미지는 기본적으로 함께 저장돼요.

    docs / kit / terminals / reference

  • c97

    터미널 마우스 입력

    마우스 리포팅을 지원하는 터미널 프로그램에서 클릭하거나 스크롤해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/mouse

    AI에 이렇게 말하세요
    내 터미널 프로그램에서 메뉴 항목을 클릭해 주세요.

    알아 두기프로그램은 마우스 보고를 켠 경우에만 마우스 이벤트를 받아요. HTTP는 요청 하나에 이벤트를 최대 256개까지 받아요.

    docs / kit / terminals / automation

웹 페이지 읽기 8

  • c98

    페이지를 Markdown으로

    웹 페이지를 제목과 메타데이터가 담긴 Markdown으로 바꿔요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AI에 이렇게 말하세요
    이 글을 Markdown으로 읽어 주세요.

    알아 두기메인 프레임만 변환하므로 iframe 콘텐츠와 shadow DOM은 제외돼요.

    docs / api / browser / interaction

  • c99

    글 본문 추출

    내비게이션, 사이드바, 댓글을 뺀 페이지 본문을 가져와요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AI에 이렇게 말하세요
    이 페이지에서 본문을 추출해 주세요.

    알아 두기메인 프레임만 변환하므로 iframe 콘텐츠와 shadow DOM은 제외돼요.

    docs / api / browser / interaction

  • c100

    페이지 HTML 또는 텍스트

    브라우저 탭의 전체 HTML이나 보이는 텍스트만 가져와요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/html

    AI에 이렇게 말하세요
    이 탭의 HTML을 보여 주세요.

    docs / kit / browser

  • c101

    페이지 링크 수집

    페이지의 링크를 정렬하고 중복을 없앤 목록으로 가져와요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AI에 이렇게 말하세요
    이 글에 있는 링크를 나열해 주세요.

    알아 두기links 배열에는 항목이 최대 10,000개 들어가요. 메인 프레임만 변환해요.

    docs / api / browser / interaction

  • c102

    페이지 JavaScript 실행

    브라우저 탭에서 JavaScript를 실행하고 결과를 받아요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/eval

    AI에 이렇게 말하세요
    JavaScript를 실행해서 페이지 제목을 읽어 주세요.

    알아 두기기본 스텔스 인스턴스에서 스크립트는 격리된 월드에서 실행돼 페이지 전역 변수를 읽을 수 없어요. 시간 제한은 기본값과 최대값 모두 30000ms예요.

    docs / kit / browser

  • c103

    요소 하나 스크린샷

    보이는 페이지 요소 하나를 원래 크기로 캡처해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    AI에 이렇게 말하세요
    이 페이지의 차트만 캡처해 주세요.

    알아 두기선택자는 처음 일치하는 요소를 캡처하고, clip이나 fullPage=true와는 함께 쓸 수 없어요.

    docs / api / browser / interaction

  • c104

    스크린샷 내용 가리기

    스크린샷에서 선택한 페이지 요소를 불투명한 상자로 가려요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    AI에 이렇게 말하세요
    이 스크린샷에서 계좌번호를 가려 주세요.

    알아 두기마스킹은 iframe 안의 요소에는 적용되지 않아요. 선택자와 일치하는 요소가 없어도 요청은 성공하니, 이미지를 확인하세요.

    docs / api / browser / interaction

  • c105

    페이지 접근성 스냅샷

    요소 참조가 포함된 구조화된 페이지 스냅샷을 가져와요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/snapshot

    AI에 이렇게 말하세요
    이 페이지에서 접근 가능한 컨트롤을 보여 주세요.

    알아 두기참조는 더 새로운 스냅샷이 만들어지거나 최상위 문서가 이동하면 만료돼요. 입력한 폼 값은 기본적으로 가려져요.

    docs / api / browser / interaction

브라우저 제어 15

  • c106

    브라우저 자동화 연결

    Playwright나 Puppeteer 클라이언트를 Hoody Chromium 인스턴스에 연결해요.

    링크https://{p}-{c}-cdp-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    내 Playwright 스크립트를 Hoody 브라우저에 연결해 주세요.

    알아 두기원격 디버깅이 켜진 Chromium이 필요해요. Firefox는 501을 반환해요.

    docs / kit / browser

  • c107

    브라우저 세션 분리

    탭과 쿠키가 따로 있는 브라우저 인스턴스를 각각 실행해요.

    AI에 이렇게 말하세요
    이 사이트용으로 브라우저 세션 두 개를 따로 열어 주세요.

    알아 두기기본적으로 1시간 동안 쓰지 않은 인스턴스는 중지되고, 탭과 쿠키도 삭제돼요.

    docs / kit / browser

  • c108

    페이지 변화 대기

    페이지에 텍스트가 나타나거나 URL로 이동하거나 로드가 끝날 때까지 기다려요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/wait

    AI에 이렇게 말하세요
    페이지에 주문이 확인됐다고 나올 때까지 기다려 주세요.

    알아 두기시간 제한은 기본 10000ms, 최대 30000ms예요. 이 호출은 브라우저를 시작하지 않아요.

    docs / kit / browser / reference

  • c109

    페이지 대화상자 처리

    브라우저 동작으로 뜬 페이지 대화상자를 수락하거나 닫아요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/action

    AI에 이렇게 말하세요
    삭제를 클릭하고 확인 대화상자를 수락해 주세요.

    알아 두기정책은 동작이 띄운 첫 번째 일치하는 대화상자에만 적용돼요. 예상하지 못한 대화상자는 닫히고 동작은 실패해요.

    docs / kit / browser

  • c110

    브라우저 탭 관리

    열려 있는 브라우저 탭을 팝업까지 나열하고, 필요 없는 탭은 닫아요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/tabs

    AI에 이렇게 말하세요
    내 브라우저에서 오래된 쇼핑 탭을 닫아 주세요.

    알아 두기마지막으로 열린 탭은 닫을 수 없어요.

    docs / kit / browser

  • c111

    브라우저 쿠키

    브라우저 인스턴스의 쿠키를 읽고, 추가하고, 지워요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/cookies

    AI에 이렇게 말하세요
    이 사이트의 쿠키를 보여 주세요.

    알아 두기추가한 쿠키 중 하나라도 유효하지 않으면 아무것도 설정되지 않아요. 인스턴스를 중지하면 쿠키가 삭제돼요.

    docs / kit / browser

  • c112

    브라우저 위치 설정

    브라우저를 시작할 때 로케일, 시간대, 위치 정보를 설정해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AI에 이렇게 말하세요
    런던 시간대로 브라우저를 시작해 주세요.

    알아 두기이 옵션은 인스턴스를 만들 때만 적용돼요.

    docs / kit / browser

  • c113

    프록시로 브라우저 실행

    브라우저 트래픽을 HTTP 또는 SOCKS 프록시로 보내요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AI에 이렇게 말하세요
    내 프록시를 거쳐 브라우저를 시작해 주세요.

    알아 두기프록시 옵션은 인스턴스를 만들 때만 적용돼요.

    docs / kit / browser

  • c114

    Chromium 확장 프로그램

    광고 차단기 같은 Chromium 확장 프로그램을 브라우저에 불러와요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AI에 이렇게 말하세요
    내 광고 차단기와 함께 Chromium을 시작해 주세요.

    알아 두기확장 프로그램은 화면이 보이는 Chromium 인스턴스가 필요하고, 인스턴스를 만들 때 설정해야 해요.

    docs / kit / browser

  • c115

    Chrome 버전 고정

    브라우저 인스턴스에 쓸 Chrome 버전이나 채널을 골라요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AI에 이렇게 말하세요
    Chrome 136으로 브라우저를 시작해 주세요.

    알아 두기시작 옵션은 인스턴스를 만들 때만 적용돼요. 확인되지 않은 메이저 버전은 생략한 것으로 처리하니, 메타데이터의 browserFullVersion을 확인하세요.

    docs / kit / browser

  • c116

    브라우저 방문 기록

    브라우저 방문 기록을 날짜나 도메인별로 찾아보거나 삭제해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/history

    AI에 이렇게 말하세요
    10월 이전의 내 브라우저 방문 기록을 삭제해 주세요.

    알아 두기기록은 기본적으로 30일 동안 보관하고, 재시작해도 남아 있어요. 삭제하면 되돌릴 수 없어요.

    docs / kit / browser

  • c117

    브라우저 콘솔 로그

    브라우저의 최근 콘솔 메시지와 페이지 오류를 확인해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/console

    AI에 이렇게 말하세요
    내 테스트 페이지의 콘솔 오류를 보여 주세요.

    알아 두기최근 500개 항목을 보관해요. 기본 스텔스 인스턴스는 브라우저가 보고한 메시지만 담고, 페이지의 콘솔 호출이나 잡히지 않은 오류는 담지 않아요.

    docs / api / browser / health

  • c118

    브라우저 네트워크 로그

    브라우저 탭 전체의 최근 네트워크 요청과 응답을 확인해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/network

    AI에 이렇게 말하세요
    내 테스트 페이지의 네트워크 요청을 보여 주세요.

    알아 두기최근 500개 항목을 보관해요.

    docs / api / browser / health

  • c119

    브라우저 DevTools 열기

    DevTools에서 Chromium 인스턴스를 검사할 수 있는 링크를 받아요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/devtools-url

    AI에 이렇게 말하세요
    내 브라우저의 DevTools를 열어 주세요.

    알아 두기DevTools Protocol은 Firefox에서, 또는 Chromium 원격 디버깅이 꺼져 있을 때 쓸 수 없어요.

    docs / kit / browser

  • c120

    브라우저 탭 크기 조절

    실행 중인 브라우저의 모든 탭에 고정된 뷰포트 크기를 설정해요.

    링크https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/viewport

    AI에 이렇게 말하세요
    내 브라우저 탭을 1,280 × 800으로 조절해 주세요.

    알아 두기너비와 높이는 1~8192 사이의 정수예요. 충돌한 탭은 건너뛰어요.

    docs / api / browser / control

파일과 데이터 8

  • c12

    링크로 여는 파일

    웹 파일 관리자에서 파일을 둘러보고, 편집하고, 다운로드해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 프로젝트 폴더의 파일을 보여 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 내 파일을 보고 바꿀 수 있어요.

    docs / kit / files

  • c13

    클라우드 드라이브를 한곳에

    Google Drive, Dropbox, S3 등 원격 스토리지 49가지를 연결해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 Dropbox 청구서를 프로젝트로 복사해 주세요.

    docs / kit / files

  • c14

    파일 기록

    링크로 수정한 작은 텍스트 파일의 이전 버전을 불러와요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    config.json의 어제 버전을 보여 주세요.

    알아 두기Hoody 파일로 바꾼 최대 2MiB의 텍스트 파일을 90일 동안, 또는 기록이 2GiB에 이를 때까지 보관해요. 빌드 폴더와 URL 다운로드는 건너뛰고, 기록은 최선을 다하지만 보장되지는 않아서 백업이 아니에요.

    docs / kit / files

  • c15

    노트북의 파일

    Finder나 Explorer에서 내 컴퓨터의 파일을 열어요.

    AI에 이렇게 말하세요
    내 Hoody 파일을 Mac에 마운트해 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 WebDAV 링크가 있는 누구나 내 파일을 마운트할 수 있어요.

    docs / foundation / storage / mount-locally

  • c16

    컴퓨터 안의 노트북 폴더

    노트북의 폴더가 내 컴퓨터 안에 나타나게 해요.

    AI에 이렇게 말하세요
    내 다운로드 폴더를 Hoody 컴퓨터와 공유해 주세요.

    알아 두기rclone 1.61 이상을 쓰는 Linux나 macOS에서 쓸 수 있고, Windows는 아직 지원하지 않아요. 폴더는 내 기기가 온라인이고 명령이 실행되는 동안에만 동작하며, 중지할 때는 대기 중인 쓰기가 전달될 때까지 기다려요.

    docs / foundation / storage / share-local-folder

  • c17

    컴퓨터 간 공유 폴더

    같은 서버의 컴퓨터끼리 폴더를 공유해요. 읽기 전용 또는 읽기와 쓰기 모두 가능하게 설정할 수 있어요.

    AI에 이렇게 말하세요
    assets 폴더를 이 프로젝트의 모든 컴퓨터와 공유해 주세요.

    알아 두기같은 서버의 컴퓨터 사이에서 쓸 수 있어요. 서버 간에는 시범 기능이고, 기본으로 꺼져 있어요.

    docs / foundation / storage / sharing-files

  • c18

    서버 없는 데이터베이스

    SQL 데이터베이스와 키-값 데이터를 보관하고, 링크로 접근해요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 읽기 목록용 데이터베이스를 만들어 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 데이터베이스에 접근할 수 있어요.

    docs / kit / sqlite

  • c19

    데이터 되돌리기

    저장한 키-값 데이터의 지난 변경을 확인하고 되돌려요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 설정의 마지막 변경을 되돌려 주세요.

    알아 두기키-값 API로 만든 변경만 기록돼요. SQL 쓰기와 기록을 끈 상태로 보낸 쓰기는 되돌릴 수 없어요.

    docs / kit / sqlite

링크로 쓰는 파일 도구 17

  • c121

    URL에서 다운로드

    원격 파일을 내 기기를 거치지 않고 컴퓨터로 바로 가져와요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/{folder}?download={url}

    AI에 이렇게 말하세요
    이 데이터셋을 내 컴퓨터로 바로 다운로드해 주세요.

    알아 두기다운로드는 100GiB 또는 12시간에서 중단돼요.

    docs / kit / files

  • c122

    파일 복사와 이동

    Files API로 파일과 폴더를 복사하거나 이동해요.

    AI에 이렇게 말하세요
    내 보고서를 아카이브 폴더로 복사해 주세요.

    알아 두기이동은 이미 있는 대상을 덮어쓰지 않아요. 복사는 `?overwrite=true`를 붙일 때만 덮어써요.

    docs / kit / files

  • c123

    아카이브 내용 보기

    아카이브를 풀지 않고 내용을 나열하거나 파일 하나를 읽어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?preview

    AI에 이렇게 말하세요
    이 아카이브의 파일을 나열하고 README를 보여 주세요.

    알아 두기ZIP, TAR, 압축된 TAR 아카이브를 지원해요. 선택한 파일이 100MB를 넘으면 거부돼요.

    docs / api / files / directories

  • c124

    이미지 크기 조절과 변환

    링크로 이미지의 크기를 조절하거나 변환하고, 흐리게 하거나 회색조로 만들어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/{image}?thumbnail&size={size}&format={format}

    AI에 이렇게 말하세요
    이 사진으로 256픽셀 WebP 썸네일을 만들어 주세요.

    알아 두기JPEG, PNG, WebP, GIF, BMP를 지원하고, 2000×2000픽셀 영역 안까지 처리해요. 흐림 반경은 0~50이에요.

    docs / api / files / file-operations

  • c125

    선택한 줄 읽기

    링크로 파일의 특정 범위나 마지막 줄을 읽어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?lines={range}

    AI에 이렇게 말하세요
    이 로그의 마지막 20줄을 보여 주세요.

    알아 두기요청당 최대 100,000줄 또는 64MB예요.

    docs / api / files / reading

  • c126

    읽기 전용 파일 페이지

    편집 기능이 없는 페이지에서 텍스트 파일을 열어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/{path}?view

    AI에 이렇게 말하세요
    이 메모를 읽기 전용 보기로 열어 주세요.

    알아 두기이 보기는 다른 요청으로 하는 쓰기를 막지 않아요. 접근을 제어하려면 프록시 권한을 설정하세요.

    docs / kit / files

  • c127

    파일 수정본 비교

    기록된 파일 버전 두 개의 차이를 확인해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?diff&from_seq={from_seq}&to_seq={to_seq}

    AI에 이렇게 말하세요
    이 두 수정본 사이에 바뀐 내용을 보여 주세요.

    알아 두기Hoody 파일로 바꾼 변경이 기록에 담겨요. 2MiB를 넘는 파일과 바이너리 파일은 diff를 남기지 않고, 기록은 90일이 지나거나 2GiB를 넘으면 정리돼요.

    docs / kit / files

  • c128

    파일에 이어 쓰기

    링크로 파일 끝에 데이터를 추가해요. 파일이 없으면 새로 만들어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/append/{path}

    AI에 이렇게 말하세요
    이 항목을 내 로그 파일 끝에 추가해 주세요.

    docs / api / files / file-operations

  • c129

    아카이브 항목 하나 추출

    아카이브의 나머지는 그대로 두고 파일이나 폴더 하나만 추출해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?extract_file&extract={member}

    AI에 이렇게 말하세요
    이 아카이브에서 images 폴더만 추출해 주세요.

    알아 두기ZIP, TAR, 압축된 TAR 아카이브를 지원해요.

    docs / api / files / directories

  • c130

    파일 범위 다운로드

    파일 전체를 받는 대신 선택한 바이트만 요청해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    AI에 이렇게 말하세요
    이 파일의 처음 1메가바이트를 가져와 주세요.

    알아 두기`backend`로 지정한 원격 파일에 범위를 여러 개 요청하면 파일 전체를 돌려줘요.

    docs / api / files / reading

  • c131

    링크로 파일 정보 확인

    내용을 다운로드하지 않고 파일의 크기, 소유자, 권한을 확인해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/stat/{path}

    AI에 이렇게 말하세요
    이 파일의 크기와 소유자를 확인해 주세요.

    docs / api / files / file-operations

  • c132

    파일 무결성 확인

    파일의 SHA-256 해시를 내 사본과 비교해 다운로드를 확인해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?hash

    AI에 이렇게 말하세요
    내려받은 백업이 원본과 같은지 확인해 주세요.

    docs / kit / files

  • c133

    URL 다운로드 관리

    컴퓨터의 URL 다운로드 진행 상황과 기록을 확인하거나 취소해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/downloads

    AI에 이렇게 말하세요
    진행 중인 다운로드를 보여 주고, 멈춘 다운로드는 취소해 주세요.

    알아 두기루트에 쓰기 권한이 있어야 취소할 수 있어요. 취소된 일부 파일은 마운트나 네트워크 파일 시스템에 남아요.

    docs / api / files / downloading

  • c134

    아카이브 추출 확인

    실행 중인 아카이브 추출의 진행 상황을 확인하거나 취소해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/extractions

    AI에 이렇게 말하세요
    내 아카이브가 아직 추출 중인지 확인해 주세요.

    알아 두기압축 해제를 취소하려면 루트 폴더에 쓰기 권한이 있어야 해요.

    docs / api / files / directories

  • c135

    파일 변경 감사

    컴퓨터 전체에 기록된 파일 변경을 경로, 작업 유형, 시간별로 찾아요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/journal

    AI에 이렇게 말하세요
    오늘 이 폴더에 기록된 파일 삭제를 보여 주세요.

    알아 두기저널에는 Hoody 파일로 바꾼 변경만 기록돼요. 터미널 명령, 스크립트, 프로그램이 바꾼 변경은 기록되지 않아요.

    docs / kit / files

  • c136

    조건부 파일 쓰기

    파일 버전이 예상한 버전과 같을 때만 파일을 써요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    AI에 이렇게 말하세요
    내가 읽은 뒤로 아무도 바꾸지 않았을 때만 저장해 주세요.

    알아 두기컴퓨터에 있는 파일에서 동작하고, 연결한 클라우드 스토리지의 파일에서는 동작하지 않아요.

    docs / api / files / file-operations

  • c137

    업로드 권한 설정

    업로드하면서 새 파일의 권한 비트를 설정해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?chmod={mode}

    AI에 이렇게 말하세요
    이 키를 소유자만 접근할 수 있는 권한으로 업로드해 주세요.

    알아 두기`GET /api/v1/version`의 `features`에 `put_chmod`가 있는지 확인하세요. 오래된 서비스는 `?chmod`를 무시해요.

    docs / kit / files

클라우드와 공유 스토리지 11

  • c138

    원격 스토리지를 폴더로

    연결한 스토리지 계정을 마운트해 프로그램이 폴더처럼 쓸 수 있게 해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts

    AI에 이렇게 말하세요
    내가 연결한 Drive를 마운트해서 프로그램에서 쓸 수 있게 해 주세요.

    알아 두기쓰기는 `write_back` 시간이 지난 뒤 업로드되고, 기본값은 5초예요. 한 파일에 쓰는 쪽이 둘이면 마지막에 업로드한 쪽이 반영돼요.

    docs / kit / files

  • c139

    클라우드 계정 여러 개

    같은 스토리지 제공업체의 개인 계정과 업무 계정을 연결해요.

    AI에 이렇게 말하세요
    내 개인 Google Drive와 업무 Google Drive를 모두 연결해 주세요.

    알아 두기연결은 기본적으로 전체 100개, 원격 호스트당 10개까지예요.

    docs / foundation / storage / cloud

  • c140

    클라우드 제공업체 간 복사

    컴퓨터의 대역폭으로 연결한 제공업체 사이에서 파일을 복사해요.

    AI에 이렇게 말하세요
    이 Drive 백업을 내 S3 버킷으로 복사해 주세요.

    알아 두기파일은 컴퓨터에 만들어지는 임시 복사본을 거쳐요.

    docs / foundation / storage / cloud

  • c141

    파일 서버 연결

    SFTP, SMB, WebDAV, FTP, HDFS 또는 HTTP 서버를 컴퓨터에 연결해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/backends/{protocol}

    AI에 이렇게 말하세요
    우리 팀의 SMB 파일 서버를 연결해 주세요.

    알아 두기연결할 때 로그인을 확인해요. 연결한 뒤에 폴더로 마운트하세요.

    docs / api / files / mount / protocols

  • c142

    휴대폰에 마운트

    휴대폰의 WebDAV 앱에서 컴퓨터의 파일을 열어요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    휴대폰 파일 앱에서 내 컴퓨터의 파일을 열어 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 WebDAV 링크가 있는 누구나 내 파일을 마운트할 수 있어요.

    docs / foundation / storage / mount-locally

  • c143

    일회성 원격 파일

    스토리지 연결을 저장하지 않고 원격 파일을 읽거나 업로드해요.

    AI에 이렇게 말하세요
    내 SFTP 서버에서 이 파일을 한 번 읽어 주세요.

    알아 두기SFTP, WebDAV, FTP, S3에서 쓸 수 있어요.

    docs / kit / files

  • c144

    읽기 전용 노트북 폴더

    컴퓨터에서 노트북 폴더를 읽을 수 있게 하고, 쓰기는 막아요.

    AI에 이렇게 말하세요
    내 문서 폴더를 컴퓨터와 읽기 전용으로 공유해 주세요.

    알아 두기rclone 1.61 이상을 쓰는 Linux나 macOS에서 쓸 수 있어요. 공유는 내 기기가 온라인이고 명령이 실행되는 동안 동작해요.

    docs / foundation / storage / share-local-folder

  • c145

    만료되는 폴더 공유

    다른 컴퓨터와 공유한 폴더에 만료 시간을 설정해요.

    링크https://api.hoody.com/api/v1/computers/{id}/storage/shares

    AI에 이렇게 말하세요
    이 폴더를 금요일까지 다른 컴퓨터와 공유해 주세요.

    알아 두기만료되면 공유가 삭제되고 모든 대상에서 마운트가 해제돼요.

    docs / foundation / storage / sharing-files

  • c146

    받은 공유 수락

    다른 컴퓨터가 내 컴퓨터로 보낸 폴더 공유를 수락하거나 꺼요.

    링크https://api.hoody.com/api/v1/computers/{id}/storage/incoming/{shareId}/mount

    AI에 이렇게 말하세요
    이 컴퓨터에서 공유 에셋 폴더 마운트를 중지해 주세요.

    알아 두기공유가 마운트되려면 만든 쪽의 enabled 플래그와 받는 쪽의 mount 플래그가 모두 true여야 해요.

    docs / api / storage-shares

  • c147

    읽기 전용 클라우드 마운트

    마운트한 원격 폴더에 마운트 경로로 쓰는 것을 막아요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts/{id}

    AI에 이렇게 말하세요
    마운트된 이 클라우드 폴더를 읽기 전용으로 바꿔 주세요.

    알아 두기`?backend=` 경로는 여전히 쓰기가 가능해요. 커스텀 설정은 `box`, `onedrive`, `protondrive`에서 지원하지 않아요.

    docs / kit / files / reference

  • c148

    업로드에 실패한 파일

    클라우드 마운트가 업로드하지 못한 파일을 찾고, 보관된 사본을 다운로드해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/pending-uploads

    AI에 이렇게 말하세요
    내 클라우드 스토리지에 올라가기를 기다리는 파일을 보여 주세요.

    알아 두기보류된 파일은 전달하거나 버릴 때까지 남아 있어요. 보류된 사본은 불완전할 수 있어요.

    docs / kit / files

데이터베이스와 키-값 저장소 13

  • c149

    SQL 트랜잭션

    SQL 문 여러 개를 함께 실행하고, 하나라도 실패하면 모두 되돌려요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    AI에 이렇게 말하세요
    주문과 재고를 한 트랜잭션으로 업데이트해 주세요.

    알아 두기결과 집합은 10,000행에서 멈추고 truncated: true가 표시돼요. 나누어 가져오려면 LIMIT을 쓰세요.

    docs / kit / sqlite

  • c150

    실시간 쿼리 공유

    읽기 전용 SQL 쿼리를 실시간 데이터에 실행하는 링크를 공유해요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/query

    AI에 이렇게 말하세요
    현재 주문 수를 보여 주는 링크를 만들어 주세요.

    알아 두기URL에는 Base64URL로 인코딩한 읽기 전용 SELECT 문 하나가 담겨요.

    docs / kit / sqlite

  • c151

    네이티브와 HTTP SQLite

    로컬 코드와 HTTP에서 SQLite 데이터베이스를 동시에 사용해요.

    AI에 이렇게 말하세요
    내 로컬 워커와 대시보드가 같은 데이터베이스를 쓰게 해 주세요.

    알아 두기SQLite는 데이터베이스 파일 하나에 한 번에 쓰는 쪽을 하나만 허용해요. 스토리지 공유로 컴퓨터 사이에서 데이터베이스 파일을 공유하지 마세요.

    docs / foundation / storage / sqlite-drive

  • c152

    데이터베이스 백업 사본

    사용 중인 SQLite 데이터베이스의 일관된 사본을 만들어요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/maintenance

    AI에 이렇게 말하세요
    내 데이터베이스의 일관된 백업을 만들어 주세요.

    알아 두기사본은 새 경로에 만들어져요.

    docs / kit / sqlite

  • c153

    데이터베이스 변경 추적

    SQL 쓰기를 포함해 키-값 테이블의 변경 사항을 발생 즉시 스트리밍해요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/changes/stream

    AI에 이렇게 말하세요
    내 앱 데이터베이스의 키가 바뀔 때마다 알려 주세요.

    알아 두기로그는 24시간치, 최대 1,000,000개의 변경을 보관해요.

    docs / kit / sqlite

  • c154

    임시 키 만료

    저장한 키에 만료 시간을 지정하고, 나중에 바꿀 수도 있어요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/expire

    AI에 이렇게 말하세요
    이 세션 키를 1시간 뒤에 만료시켜 주세요.

    docs / kit / sqlite

  • c155

    경쟁 상태에 안전한 카운터

    여러 클라이언트가 공유 카운터를 올려도 업데이트가 누락되지 않아요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/incr

    AI에 이렇게 말하세요
    내 홈페이지 방문 횟수를 세어 주세요.

    docs / kit / sqlite

  • c156

    JSON 필드 업데이트

    저장한 JSON 값의 일부를 읽고, 쓰고, 증가시켜요.

    AI에 이렇게 말하세요
    다른 설정은 그대로 두고 테마 필드만 바꿔 주세요.

    알아 두기경로로 설정하려면 저장된 값에 JSON 콘텐츠 유형이 필요해요.

    docs / kit / sqlite

  • c157

    충돌하는 쓰기 방지

    버전이 바뀌지 않았을 때만 공유 키를 업데이트해요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}

    AI에 이렇게 말하세요
    먼저 바꾼 사람이 없을 때만 설정을 업데이트해 주세요.

    알아 두기412는 다른 클라이언트가 먼저 썼다는 뜻이에요. 다시 읽고 변경을 다시 적용하세요.

    docs / kit / sqlite

  • c158

    파일로 저장하는 키

    다른 도구가 파일로 편집할 수 있는 디렉터리에 키를 저장해요.

    AI에 이렇게 말하세요
    이 설정을 디렉터리에 파일로 저장해 주세요.

    docs / kit / sqlite

  • c159

    SQL 값 일괄 처리

    SQL 문 하나를 여러 값 묶음에 대해 실행해요.

    링크https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    AI에 이렇게 말하세요
    이 행들을 SQL 문 하나로 삽입해 주세요.

    docs / kit / sqlite

  • c160

    키 작업 일괄 처리

    요청 한 번으로 키를 최대 100개까지 읽고, 쓰고, 삭제해요.

    AI에 이렇게 말하세요
    이 설정을 한 번에 함께 저장해 주세요.

    알아 두기일괄 쓰기는 모든 키를 적용하거나, 하나도 적용하지 않아요.

    docs / kit / sqlite

  • c161

    경쟁 상태에 안전한 리스트

    클라이언트끼리 충돌하지 않게 저장된 리스트에 항목을 추가하거나, 꺼내거나, 제거해요.

    AI에 이렇게 말하세요
    이 상품을 공유 장바구니에 담아 주세요.

    docs / kit / sqlite

사이트, 스크립트, 링크 10

  • c20

    스크립트가 엔드포인트로

    스크립트 폴더에 JavaScript나 TypeScript 파일을 저장하면 바로 웹 엔드포인트가 돼요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AI에 이렇게 말하세요
    CSV를 JSON으로 바꾸는 엔드포인트를 만들어 주세요.

    docs / kit / exec

  • c21

    스크립트 안의 AI

    스크립트에서 키 설정 없이 AI 모델을 호출할 수 있어요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AI에 이렇게 말하세요
    어떤 웹 페이지든 요약해 주는 엔드포인트를 만들어 주세요.

    알아 두기기본 모델은 서버 한도 안에서 무료예요. 유료 모델은 사용한 만큼 청구돼요.

    docs / kit / exec / ai-integration

  • c22

    비공개 엔드포인트

    스크립트 엔드포인트마다 고유한 비밀 토큰으로 보호해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AI에 이렇게 말하세요
    이 엔드포인트를 내 앱만 호출할 수 있게 잠가 주세요.

    docs / kit / exec / authentication

  • c23

    실시간 스크립트 이벤트

    실행 중인 스크립트의 이벤트를 어떤 페이지로든 실시간 스트리밍해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AI에 이렇게 말하세요
    주문 현황을 내 대시보드에 실시간으로 보내 주세요.

    알아 두기스크립트마다 따로 켜요. 이벤트는 저장되지 않으므로 페이지는 연결된 동안 전송된 이벤트만 볼 수 있어요. 비공개 데이터를 보내기 전에 토큰이나 프록시 권한을 추가하세요.

    docs / kit / exec / remote

  • c24

    바로 열리는 사이트와 앱

    실행한 HTTP 앱은 각자의 HTTPS 링크에서 바로 열려요. 배포 단계는 없어요.

    링크https://{p}-{c}-http-8080.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    랜딩 페이지를 만들고 링크를 보내 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 열 수 있어요.

    docs / concepts / everything-is-a-url

  • c25

    내 도메인

    어떤 사이트나 도구든 내 도메인에 올려요. HTTPS도 포함돼요.

    링크https://www.yourdomain.com

    AI에 이렇게 말하세요
    내 사이트를 www.example.com에 연결해 주세요.

    알아 두기www.example.com 같은 서브도메인만 연결할 수 있고, example.com은 안 돼요. 서브도메인마다 짧은 링크 하나를 가리키도록 설정하세요. 여러 서브도메인이 링크 하나를 함께 쓸 수도 있어요.

    docs / foundation / proxy / connect-domain

  • c26

    짧은 링크

    어떤 사이트나 도구에든 기억하기 쉬운 짧은 링크를 붙여요.

    링크https://{alias}.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 대시보드에 짧은 링크를 만들어 주세요.

    알아 두기짧은 링크는 추측하기 쉽고, 프록시 권한을 설정하기 전까지 누구나 열 수 있어요. 무료 컴퓨터당 3개, Plus는 50개, Pro는 250개예요.

    docs / foundation / proxy / aliases

  • c162

    만료되는 데모 링크

    데모나 행사 링크에 만료 시간을 설정해요.

    링크https://api.hoody.com/api/v1/proxy/aliases

    AI에 이렇게 말하세요
    이 데모 링크가 금요일에 만료되게 해 주세요.

    알아 두기만료된 뒤에도 별칭은 404로 응답하고 설정은 그대로 남아요. 비활성화된 별칭과 만료된 별칭도 서버의 별칭 한도에 포함돼요.

    docs / foundation / proxy / aliases

  • c163

    링크를 한 페이지에 고정

    별칭이 고정된 페이지 하나 또는 API 엔드포인트 하나만 열게 해요.

    링크https://api.hoody.com/api/v1/proxy/aliases

    AI에 이렇게 말하세요
    이 링크가 보고서 페이지만 열게 해 주세요.

    알아 두기경로 재정의를 끄면 다른 경로는 404를 반환해요. 메서드, 본문, WebSocket 업그레이드, 그 밖의 매개변수는 그대로 전달돼요.

    docs / foundation / proxy / aliases

  • c164

    짧은 링크 일시 중지

    별칭을 비활성화했다가, 설정을 잃지 않고 나중에 복원해요.

    링크https://api.hoody.com/api/v1/proxy/aliases/{id}/state

    AI에 이렇게 말하세요
    데모 링크를 내일까지 일시 중지해 주세요.

    알아 두기비활성화된 동안 URL은 404로 응답해요. 변경 사항은 약 30초 안에 별칭 URL에 반영되고, 더 걸릴 때도 있어요.

    docs / foundation / proxy / aliases

스크립트 작성 12

  • c165

    스크립트 속 패키지

    npm 패키지를 import하면 스크립트가 실행되기 전에 설치돼요.

    AI에 이렇게 말하세요
    내 스크립트에서 axios로 이 API를 호출해 주세요.

    알아 두기첫 요청은 더 느리고, 컴퓨터가 npm 레지스트리에 접속할 수 있어야 해요. 계산해서 만든 패키지 이름은 감지하지 못해요.

    docs / kit / exec / writing-scripts

  • c166

    동적 스크립트 라우트

    URL 경로의 값을 가져와 스크립트에서 쓸 수 있어요.

    AI에 이렇게 말하세요
    URL에서 ID를 읽는 사용자 엔드포인트를 만들어 주세요.

    docs / kit / exec / routing

  • c167

    구조화된 AI 응답

    스크립트가 정해진 JSON 형식으로 AI 출력을 요청해요.

    AI에 이렇게 말하세요
    이 텍스트에서 이름과 날짜를 JSON으로 추출해 주세요.

    알아 두기Zod 스키마는 응답을 자동으로 검증해요. `jsonSchema(...)` 스키마는 `validate` 함수를 넘기지 않으면 모델에만 전달돼요.

    docs / kit / exec / ai-integration

  • c168

    AI 응답 스트리밍

    응답이 만들어지는 대로 스크립트에서 생성된 텍스트를 스트리밍해요.

    AI에 이렇게 말하세요
    내 AI 엔드포인트의 답변을 작성되는 대로 스트리밍해 주세요.

    docs / kit / exec / ai-integration

  • c169

    스크립트 WebSocket 서버

    내 워커 스크립트에서 WebSocket 연결을 받아요.

    AI에 이렇게 말하세요
    내 채팅 앱용 WebSocket 엔드포인트를 만들어 주세요.

    알아 두기WebSocket에는 `// @mode worker`와 `// @websocket`이 모두 필요해요.

    docs / kit / exec / execution-modes

  • c170

    스크립트 요청 미들웨어

    폴더 안 스크립트로 가는 요청 전후에 내 코드를 실행해요.

    AI에 이렇게 말하세요
    내 API 폴더의 스크립트에 요청 로깅을 추가해 주세요.

    docs / kit / exec / routing

  • c171

    스크립트 환경 변수

    스크립트, 폴더 또는 스크립트 루트에 환경 변수를 설정해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/env/update

    AI에 이렇게 말하세요
    내 청구서 스크립트의 API 키를 설정해 주세요.

    알아 두기충돌하는 변경을 막기 위해 요청에 현재 파일 리비전이 필요해요.

    docs / api / exec / script-management

  • c172

    공유 스크립트 캐시

    스크립트로 오는 요청 사이에서도 임시 값을 쓸 수 있게 유지해요.

    AI에 이렇게 말하세요
    요청 사이에 최신 환율을 캐시해 주세요.

    알아 두기다시 시작하면 모두 사라져요. 직접 비우거나 유휴 상태여서 자동 정리되면 내용이 비워져요.

    docs / kit / exec

  • c173

    요청마다 새 컨텍스트

    독립적인 작업이 되도록 요청마다 새 JavaScript 컨텍스트에서 실행해요.

    AI에 이렇게 말하세요
    이 웹훅 수신기가 요청마다 새 컨텍스트를 쓰게 해 주세요.

    알아 두기새 컨텍스트가 격리하는 것은 변수이고, 부수 효과는 격리하지 않아요. 쓴 파일, 시작한 하위 프로세스, 보낸 네트워크 호출은 그대로 남아요.

    docs / kit / exec / execution-modes

  • c174

    템플릿으로 생성

    기본 제공 템플릿이나 커스텀 템플릿으로 스크립트를 생성해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/templates/generate

    AI에 이렇게 말하세요
    템플릿으로 새 스크립트를 생성해 주세요.

    docs / api / exec / templates

  • c175

    실행 전 스크립트 점검

    스크립트의 구문, 의존성, 지시문, 선택적 타입을 한 번의 호출로 점검해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/validate/script

    AI에 이렇게 말하세요
    저장하기 전에 이 스크립트에 오류가 없는지 확인해 주세요.

    docs / api / exec / validation

  • c176

    스크립트 의존성 고정

    패키지 매니페스트에서 스크립트 의존성 버전을 고정해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/package/pin

    AI에 이렇게 말하세요
    내 스크립트가 쓰는 의존성 버전을 고정해 주세요.

    docs / api / exec / package-management

스크립트 실행 8

  • c177

    스크립트 버전 기록

    스크립트의 이전 버전이나, 사본을 보관해 둔 삭제된 스크립트를 되살려요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/restore

    AI에 이렇게 말하세요
    내 웹훅 스크립트를 이전 버전으로 복원해 주세요.

    알아 두기삭제한 스크립트는 `keepCopy=true`로 삭제한 경우에만 복원할 수 있어요.

    docs / api / exec / script-management

  • c178

    스크립트 로그 검색

    스크립트 로그에서 텍스트나 정규식을 검색해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/logs/search

    AI에 이렇게 말하세요
    내 스크립트 로그에서 타임아웃 오류를 찾아 주세요.

    docs / api / exec / logs

  • c179

    스크립트 성능 기록

    스크립트의 시간별 호출 수, 실패 수, 지연 시간을 확인해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/monitor/script-usage

    AI에 이렇게 말하세요
    오늘 내 웹훅이 느렸던 시간대를 보여 주세요.

    알아 두기기록은 최근 24시간을 담아요.

    docs / api / exec / monitoring

  • c180

    실행 중인 스크립트에 메시지 보내기

    실행 중인 스크립트에 메시지를 보내고 핸들러의 응답을 받아요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    AI에 이렇게 말하세요
    실행 중인 내 빌드 스크립트에 시작 메시지를 보내 주세요.

    알아 두기스크립트에 `@remote-messages`를 켜세요. 원격 작업은 디렉터리 미들웨어를 거치지 않으니 토큰으로 보호하세요.

    docs / kit / exec / remote

  • c181

    노출된 함수 호출

    실행 중인 스크립트가 노출한 함수를 호출하고 응답을 받아요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    AI에 이렇게 말하세요
    실행 중인 내 워커의 status 함수를 호출해 주세요.

    알아 두기스크립트에 `@remote-call`을 켜세요. 원격 작업은 디렉터리 미들웨어를 거치지 않으니 토큰으로 보호하세요.

    docs / kit / exec / remote

  • c182

    실행 중인 스크립트 살펴보기

    디버그할 때 스크립트의 최근 실행에서 식을 평가해요.

    AI에 이렇게 말하세요
    실행 중인 내 워커의 카운터를 살펴봐 주세요.

    알아 두기`@remote-eval`과 `eval` 범위가 있는 `@remote-token`이 필요해요. `@token`으로는 열 수 없어요.

    docs / kit / exec / remote

  • c183

    스크립트 스케줄 기록

    지난 예약 스크립트 실행을 확인하고, 스크립트나 시간으로 필터링해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/schedules/history

    AI에 이렇게 말하세요
    예약된 내 보고서 스크립트가 언제 실행됐는지 보여 주세요.

    docs / api / exec / scheduling

  • c184

    스크립트 라우트 테스트

    여러 URL 경로를 스크립트 라우팅 규칙과 한 번에 대조해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/route/test

    AI에 이렇게 말하세요
    이 URL 경로를 어떤 스크립트가 처리하는지 확인해 주세요.

    docs / api / exec / routing

스스로 실행 17

  • c27

    계속 실행되는 프로그램

    서버와 워커를 실행해요. 충돌로 멈추면 스스로 다시 시작해요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    스크래퍼가 계속 실행되게 해 주세요.

    알아 두기시작하자마자 계속 실패하는 프로그램은 치명적 오류로 표시되고 더 이상 재시도하지 않아요.

    docs / kit / daemons

  • c28

    프로그램 범위 제한

    프로그램 하나가 쓰고, 접근하고, 사용할 수 있는 범위를 제한해요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    TCP 443번과 53번 포트만 열어 두고 이 워커를 실행해 주세요.

    알아 두기데몬 프로그램용이에요. 호스트가 아니라 TCP 포트를 제한하며, 일부 Unix 소켓에는 계속 접근할 수 있고, 읽기 전용 루트는 쓰기만 막고 읽기는 막지 않아요.

    docs / kit / program-sandbox

  • c29

    Docker 준비 완료, Kubernetes도

    Docker와 Compose는 개발용 Kit에 준비돼 있고, Kubernetes는 간단히 설정하면 안에서 실행돼요.

    AI에 이렇게 말하세요
    Docker 컨테이너에서 테스트 스위트를 실행해 주세요.

    docs / foundation / computers / images

  • c30

    예약 작업

    원하는 작업을 스케줄에 따라 실행하고, 정해진 시간에 스스로 삭제되도록 설정해요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    매일 밤 3시에 내 데이터베이스를 백업해 주세요.

    docs / kit / cron

  • c31

    링크가 되는 웹 요청

    API 호출을 클릭하고, 공유하고, 예약할 수 있는 링크로 바꿔요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 웹훅으로 POST 요청을 보내는 링크를 만들어 주세요.

    알아 두기링크가 있으면 누구나 안에 든 모든 헤더와 값을 읽을 수 있어요. 자격 증명도 예외가 아니에요.

    docs / kit / curl

  • c32

    반복 호출, 응답 저장

    API를 스케줄에 따라 호출하고 응답마다 파일로 저장해요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    이 API를 한 시간마다 확인하고 결과를 저장해 주세요.

    docs / kit / curl

  • c185

    부팅 시 프로그램 시작

    컴퓨터가 부팅될 때마다 프로그램이 자동으로 시작돼요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/boot

    AI에 이렇게 말하세요
    컴퓨터가 부팅될 때마다 내 API 서버를 시작해 주세요.

    알아 두기활성화된 부팅 프로그램은 만들거나 켜거나 수정하는 즉시 시작될 수 있어요.

    docs / kit / daemons

  • c186

    첫 요청에 시작

    누군가 처음 포트에 요청하면 서비스를 시작해요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AI에 이렇게 말하세요
    누군가 열 때만 내 앱을 시작해 주세요.

    알아 두기lazy_load와 port_range가 필요해요. lazy_load는 boot: true와 함께 쓸 수 없어요.

    docs / kit / daemons

  • c187

    프로그램 로그 읽기

    프로그램 출력이나 오류 로그의 마지막 줄을 읽거나, 실시간으로 따라가요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/logs

    AI에 이렇게 말하세요
    내 워커의 마지막 오류 로그 200줄을 보여 주세요.

    알아 두기로그는 기본적으로 5MiB마다 로테이션하고 백업 2개를 유지해요. 두 설정 모두 바꿀 수 있어요.

    docs / kit / daemons

  • c188

    임시 명령 실행

    일회성 프로그램을 실행하고 종료 결과를 받아요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/quick-start

    AI에 이렇게 말하세요
    내 마이그레이션을 한 번 실행하고 종료 코드를 확인해 주세요.

    알아 두기시작 대기 시간보다 오래 실행되는 명령은 running을 반환해요. 상태와 로그는 명령이 끝난 뒤 10분 동안 조회할 수 있어요.

    docs / kit / daemons

  • c189

    서버 준비 대기

    서버를 시작하고, 포트가 연결을 받을 수 있게 된 뒤에만 응답을 받아요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/start

    AI에 이렇게 말하세요
    내 API 포트가 준비될 때까지 기다린 뒤 계속해 주세요.

    알아 두기프로그램에 ready_port를 설정하고 대기형 시작을 쓰세요.

    docs / kit / daemons

  • c190

    포트마다 프로그램 하나

    포트 범위에 걸쳐 프로그램의 인스턴스를 따로 실행해요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AI에 이렇게 말하세요
    내 서비스 사본 4개를 포트 8000~8003에서 실행해 주세요.

    알아 두기각 인스턴스는 포트를 명령줄 플래그로 받아요. 명령에는 포트를 넣지 마세요.

    docs / kit / daemons

  • c191

    상호작용형 데몬 프로그램

    터미널로 관리 중인 프로그램을 보고 직접 입력해요.

    AI에 이렇게 말하세요
    내가 직접 조작할 수 있게 내 워커를 터미널에서 실행해 주세요.

    알아 두기샌드박스에서 실행하는 프로그램에는 terminal_id를 지정할 수 없어요.

    docs / kit / daemons

  • c192

    프로그램 상태 개요

    명령이나 환경 변수는 드러내지 않고 프로그램 상태를 보여 줘요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/overview

    AI에 이렇게 말하세요
    내 프로그램의 상태를 안전하게 요약해서 보여 주세요.

    docs / kit / daemons

  • c193

    오프라인 샌드박스 워커

    IP 네트워크를 끈 상태로 워커를 실행해요. 인터넷에 접근할 수 없어요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AI에 이렇게 말하세요
    이 워커를 IP 네트워크 없이 실행해 줘요.

    알아 두기경로로 접근할 수 있는 Unix 소켓은 그대로 동작해요. 프로그램은 유지되는 데몬 프로그램이어야 하고, 루트로 실행할 수 없어요.

    docs / kit / program-sandbox

  • c194

    샌드박스 연결 빈도

    샌드박스에서 실행하는 서비스에 출발지별 연결 빈도를 설정해요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/edit/{id}

    AI에 이렇게 말하세요
    내 앱으로 들어오는 새 연결을 출발지당 초당 50개로 제한해 줘요.

    알아 두기인바운드 트래픽 제한은 새 IPv4 TCP 연결에만 적용돼요. 규칙을 다시 만들면 한도가 초기화되고, 출발지가 65,535개를 넘으면 새 출발지는 계량되지 않아요.

    docs / kit / program-sandbox

  • c195

    전용 임시 공간

    샌드박스 프로그램에 비어 있는 전용 임시 디렉터리를 줘요.

    링크https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AI에 이렇게 말하세요
    이 워커에 각각 256MiB까지로 제한한 전용 임시 공간을 줘요.

    알아 두기프로그램은 유지되는 데몬 프로그램이어야 하고, 루트로 실행할 수 없어요. 임시 공간은 메모리에 있고 max_memory에 포함돼요.

    docs / kit / program-sandbox / reference

예약 작업 도구 7

  • c196

    예약 작업 지금 실행

    기존 예약 작업을 즉시 실행하고 확인서를 받아요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}/run

    AI에 이렇게 말하세요
    예약해 둔 백업을 지금 실행해 줘요.

    알아 두기항목이 있어야 하고 활성화되어 있어야 해요. 일시정지되었거나 만료된 항목, 앞서 지금 실행으로 시작한 작업이 아직 실행 중인 항목은 실행되지 않아요.

    docs / kit / cron

  • c197

    크론 스케줄 확인

    크론 스케줄을 확인해요. 쉬운 말로 풀어 주고, 다음 실행을 최대 3번까지 보여 줘요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/schedule/describe

    AI에 이렇게 말하세요
    이 크론 표현식을 확인하고 다음 실행을 보여 줘요.

    알아 두기재부팅 때만 실행되거나 한 번도 실행되지 않는 스케줄은 다음 실행 시각이 null이에요.

    docs / kit / cron

  • c198

    예약 작업 일시정지

    예약 작업을 일시정지하고, 필요할 때 다시 시작해요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}

    AI에 이렇게 말하세요
    야간 백업 작업을 일단 일시정지해 줘요.

    알아 두기일시정지한 작업은 crontab에 주석 처리된 줄로 남아요.

    docs / kit / cron

  • c199

    예약 작업 기록

    관리 중인 작업의 상태, 종료 코드, 실행 시간을 확인해요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/runs

    AI에 이렇게 말하세요
    야간 백업이 정상적으로 끝났나요?

    알아 두기기록은 항목당 끝난 실행을 최대 50개까지, 30일 동안 보관하고, 전체로는 끝난 실행 10,000개까지 보관해요. 원시 줄에는 실행 기록이 없어요.

    docs / kit / cron

  • c200

    예약 작업 실시간 이벤트

    작업의 시작과 종료, crontab 변경을 일어나는 대로 따라가요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/events/sse

    AI에 이렇게 말하세요
    내 예약 작업의 변경과 실행을 지켜봐 줘요.

    알아 두기관리되는 항목만 작업의 시작과 종료를 보고해요. 직접 쓴 원시 crontab 줄은 보고하지 않아요.

    docs / kit / cron

  • c201

    사용자 전체 작업 점검

    컴퓨터 사용자 전체의 관리 작업과, 직접 쓴 뒤 해석된 작업을 나열해요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/entries

    AI에 이렇게 말하세요
    모든 사용자의 예약 작업을 나열해 줘요.

    알아 두기감사 결과를 완전한 것으로 보기 전에 모든 페이지를 가져오고 unreadable_users와 job_lines를 확인하세요.

    docs / kit / cron

  • c202

    crontab 원본 편집

    선택한 사용자의 crontab 전체를 읽고 교체해요.

    링크https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/crontab

    AI에 이렇게 말하세요
    내 워커 계정의 crontab 원본을 보여 줘요.

    알아 두기crontab을 교체하면 관리되는 항목을 포함해 모든 내용을 덮어써요. 256KiB(262,144바이트)보다 큰 본문은 거부돼요.

    docs / kit / cron

백그라운드 웹 요청 5

  • c203

    백그라운드 웹 요청

    느린 웹 요청을 백그라운드에서 실행하고, 결과는 나중에 받아요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AI에 이렇게 말하세요
    이 느린 API 요청을 시작하고 결과는 나중에 알려 줘요.

    알아 두기끝난 작업 기록은 기본적으로 7일 뒤에 삭제돼요.

    docs / kit / curl

  • c204

    실패한 요청 재시도

    실패한 웹 전송을 시도 사이에 간격을 두고 다시 시도해요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AI에 이렇게 말하세요
    전송에 실패하면 이 다운로드를 다시 시도해 줘요.

    알아 두기재시도는 최대 5번이에요. 재시도할 때 POST 본문을 다시 보내요.

    docs / kit / curl

  • c205

    쿠키 세션

    이름 붙인 세션으로 사이트에 보내는 요청 사이에 쿠키를 유지해요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AI에 이렇게 말하세요
    로그인한 뒤 그 세션으로 내 계정 데이터를 가져와 줘요.

    알아 두기세션은 삭제하거나 30일 동안 쓰지 않을 때까지 유지돼요. 그 뒤에는 같은 ID로 쿠키 없이 새로 시작해요.

    docs / kit / curl

  • c206

    API 이벤트 스트리밍

    AI 채팅 스트림 같은 API의 실시간 이벤트 스트림을 도착하는 대로 받아요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AI에 이렇게 말하세요
    이 API의 이벤트를 도착하는 대로 스트리밍해 줘요.

    알아 두기업스트림 응답은 본문이 있는 2xx이고 Content-Type이 text/event-stream이어야 해요. 각 스트림은 기본적으로 30분까지예요.

    docs / kit / curl

  • c207

    요청 작업 이벤트

    백그라운드 요청이 시작되고, 진행되고, 끝날 때의 이벤트를 따라가요.

    링크https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/sse

    AI에 이렇게 말하세요
    백그라운드 다운로드가 끝나면 알려 줘요.

    docs / kit / curl

기기와 네트워크 사이 11

  • c33

    무엇이든 실시간 전송

    파일, 화면, 카메라, 데이터를 한 기기에서 다른 기기로 스트리밍해요.

    링크https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/<name>

    AI에 이렇게 말하세요
    이 파일을 내 휴대폰으로 보내 주세요.

    알아 두기아무것도 저장되지 않아요. 보내는 쪽과 받는 쪽이 모두 연결해야 하고, 먼저 연결한 쪽은 기본적으로 최대 5분 기다려요. 실시간 방송 링크를 공유하기 전에 보내는 쪽 키를 설정하세요.

    docs / kit / pipe

  • c34

    데스크톱 알림

    어떤 스크립트에서든 컴퓨터 데스크톱에 알림을 띄우고, 휴대폰에서도 알림으로 받아요.

    링크https://{p}-{c}-n-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    빌드가 끝나면 내 휴대폰으로 알려 주세요.

    알아 두기기기마다 브라우저에서 알림을 한 번 켜세요. 전달은 최선을 다하지만 보장되지는 않아요. iPhone에서는 먼저 페이지를 홈 화면에 추가하세요.

    docs / kit / notifications

  • c35

    노트북을 온라인으로

    노트북에서 실행 중인 서버를 컴퓨터의 해당 포트 링크로 공개해요.

    링크https://{p}-{c}-http-3000.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 로컬 포트 3000을 온라인에 올려 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 포트 링크가 있는 누구나 열 수 있어요. 방문자는 포트 자체 링크를 써요. 터널 링크는 터널을 관리하는 데만 쓰여요.

    docs / kit / tunnel

  • c36

    노트북에 접근

    노트북이 연결돼 있는 동안 컴퓨터가 노트북의 데이터베이스나 서비스에 접근하게 해요.

    링크https://{p}-{c}-tunnel-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 Hoody 앱이 내 노트북의 데이터베이스를 쓰게 해 주세요.

    docs / kit / tunnel

  • c37

    트래픽이 나가는 위치 선택

    앱이 컴퓨터의 프록시 링크를 쓰게 하면, 요청이 내가 고른 프록시나 내 기기를 통해 나가요.

    링크https://{p}-{c}-egress.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    스크래퍼가 내 프록시를 거치게 해 주세요.

    알아 두기프록시 권한을 설정하기 전까지는 링크가 있는 누구나 열 수 있어요.

    docs / kit / egress

  • c208

    컴퓨터 트래픽 경유

    컴퓨터의 아웃바운드 TCP를 SOCKS5, HTTP 또는 HTTPS 프록시로 보내요.

    링크https://api.hoody.com/api/v1/computers/{id}/network

    AI에 이렇게 말하세요
    이 컴퓨터를 내 SOCKS5 프록시로 경유해 줘요.

    알아 두기경로가 실행되는 동안에는 TCP만 전달해요. DNS는 플랫폼 리졸버로 가고, 그 밖의 아웃바운드 UDP와 ICMP는 차단돼요.

    docs / foundation / networking / network

  • c209

    끊긴 터널 다시 연결

    연결이 끊긴 뒤 터널을 이어 가고, 포트는 그대로 유지해요.

    AI에 이렇게 말하세요
    네트워크가 잠깐 끊긴 뒤에도 내 터널을 유지해 줘요.

    알아 두기리스너는 기본적으로 60초 동안 유지돼요. 드롭이 일어나면 열려 있는 연결은 끊어져요.

    docs / kit / tunnel

  • c210

    로컬 핸들러 제공

    별도 서버를 띄우지 않고 노트북의 요청 핸들러를 공개해요.

    AI에 이렇게 말하세요
    이 로컬 요청 핸들러를 내 컴퓨터로 공개해 줘요.

    알아 두기serve 헬퍼는 Bun이 필요해요. Node에서는 직접 만든 HTTP 서버와 함께 expose를 쓰세요.

    docs / kit / tunnel

  • c211

    터널 바인딩 확인

    활성 터널 세션과 바인딩된 포트를 확인해요.

    링크https://{p}-{c}-tunnel-1.{node}.computers.hoody.com/api/v1/tunnel/tunnels

    AI에 이렇게 말하세요
    내 터널 세션과 바인딩을 보여 줘요.

    docs / kit / tunnel

  • c212

    임시 프록시 출구

    클라이언트가 갱신하지 않으면 꺼지는 업스트림 프록시를 설정해요.

    링크https://{p}-{c}-egress-1.{node}.computers.hoody.com/api/v1/egress/upstream?lease={seconds}

    AI에 이렇게 말하세요
    내 클라이언트가 갱신하는 동안에만 이 프록시를 사용해 줘요.

    알아 두기리스는 5~3600초 범위예요. 이미 열린 HTTPS 터널은 닫힐 때까지 처음의 출구를 그대로 써요.

    docs / kit / egress

  • c213

    프록시 자격 증명 분리

    클라이언트마다 아웃바운드 프록시용 자격 증명을 따로 줘요.

    링크https://{p}-{c}-egress-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    클라이언트마다 프록시 자격 증명을 따로 줘요.

    알아 두기아웃바운드 인덱스는 업스트림 하나를 공유해요. 프록시 권한은 인덱스마다 설정해야 해요.

    docs / kit / egress

실시간 전송 6

  • c214

    브라우저 전송 페이지

    브라우저에서 입력한 텍스트, 파일, 붙여 넣은 이미지를 보내요.

    링크https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/

    AI에 이렇게 말하세요
    붙여 넣은 이미지를 보낼 수 있는 브라우저 페이지를 열어 줘요.

    알아 두기브라우저 자체가 컴퓨터의 접근 규칙으로 허용되어 있어야 해요.

    docs / kit / pipe

  • c215

    라이브 방송 시청자

    시청자가 자유롭게 들어오고 나가는 동안 라이브 스트림을 방송해요.

    AI에 이렇게 말하세요
    실행되는 동안 시청자가 참여할 수 있게 이 로그를 방송해 줘요.

    알아 두기동시에 최대 256명까지 볼 수 있어요. 시청자는 참여한 시점부터 스트림을 받고, 아무도 보지 않을 때 보낸 바이트는 버려져요.

    docs / kit / pipe

  • c216

    TCP 포트 포워딩

    파이프로 두 머신 사이의 TCP 연결을 전달해요.

    AI에 이렇게 말하세요
    파이프로 다른 머신에서 내 데이터베이스에 접속해 줘요.

    docs / kit / pipe

  • c217

    양방향 파이프

    WebSocket 피어 두 개를 연결해 텍스트와 바이너리 메시지를 주고받아요.

    AI에 이렇게 말하세요
    이 프로그램 두 개를 연결해 양방향으로 대화하게 해 줘요.

    알아 두기세 번째 피어는 409를 받아요.

    docs / kit / pipe

  • c218

    전송 진행률

    수신자 자리를 차지하지 않고 전송 진행률을 지켜봐요.

    링크https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name}?progress

    AI에 이렇게 말하세요
    이 전송의 진행률을 보여 줘요.

    docs / kit / pipe

  • c219

    전송 체크섬

    전송된 바이트를 서버가 계산한 SHA-256 다이제스트와 대조해요.

    AI에 이렇게 말하세요
    이 디스크 이미지를 보내고 체크섬을 확인해 줘요.

    알아 두기해시로 하거나 직접 이름을 붙인 전송은 수신 확인을 최대 10분 동안 보관해요.

    docs / kit / pipe

경고와 알림 4

  • c220

    실시간 알림 피드

    선택한 화면의 알림을 대시보드로 스트리밍해요.

    링크https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/stream

    AI에 이렇게 말하세요
    1번 화면의 알림을 내 대시보드로 스트리밍해 줘요.

    알아 두기화면 필터링은 경로 지정일 뿐 접근 제어가 아니에요. 스트림 URL에 접속할 수 있으면 누구나 모든 화면을 요청할 수 있어요.

    docs / kit / notifications

  • c221

    알림 기록

    화면 하나 이상에서 최근 알림을 읽어요.

    링크https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/{display}

    AI에 이렇게 말하세요
    1번 화면의 최근 알림을 보여 줘요.

    알아 두기기록에는 닫은 알림과 만료된 알림이 빠지고, 기록 파일마다 최신 1,000개를 보관해요.

    docs / kit / notifications

  • c222

    알림 긴급도 선택

    알림의 긴급도와 표시되는 시간을 설정해요.

    링크https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/notify

    AI에 이렇게 말하세요
    백업이 실패하면 긴급 알림을 띄워 줘요.

    알아 두기만료 시간은 0~300000밀리초예요. 호출자마다 1분에 알림을 10개까지 보낼 수 있어요.

    docs / kit / notifications

  • c223

    알림 기기 관리

    알림을 구독한 브라우저를 나열하고, 알림에서 기기를 제거해요.

    AI에 이렇게 말하세요
    알림에서 예전 브라우저를 제거해 줘요.

    알아 두기기본 한도는 Kit당 푸시 구독 50개예요.

    docs / kit / notifications

도구와 컴퓨터 전체 16

  • c38

    브라우저에서 VS Code

    어떤 브라우저에서든 VS Code를 그대로 써요. 휴대폰도 돼요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 프로젝트를 VS Code로 열어 주세요.

    알아 두기확장 프로그램은 Open VSX에서 가져오고, 그 밖의 확장은 .vsix 파일로 추가할 수 있어요.

    docs / kit / code

  • c39

    파일 변경 감시

    파일이 바뀔 때마다 실시간 피드를 받아요.

    링크https://{p}-{c}-watch-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    새 업로드가 도착할 때마다 알려 주세요.

    알아 두기감시 서비스가 다시 시작되면 워처가 사라져요. 그 뒤에 다시 만드세요.

    docs / api / watch

  • c40

    어떤 앱이든 찾기

    여러 카탈로그에서 이름으로 앱을 찾고, 실행 명령어를 받아요.

    링크https://{p}-{c}-run-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    Blender를 실행할 방법을 찾아 주세요.

    docs / api / run

  • c41

    트래픽 로그

    컴퓨터에 도착한 모든 요청을 실시간으로, 또는 나중에 확인해요.

    링크https://{p}-{c}-logs-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    오늘 내 사이트를 연 사람은 누구예요?

    알아 두기기본값으로 컴퓨터당 최근 7일, 최대 50,000건 또는 100MB까지 보관해요.

    docs / api / proxy-logs

  • c42

    방화벽

    무엇이 컴퓨터에 접근할 수 있는지, 컴퓨터가 어디에 연결할 수 있는지 정해요.

    AI에 이렇게 말하세요
    내 데이터베이스 포트를 닫아서 외부 연결을 막아 주세요.

    알아 두기IPv4 주소와 범위만 쓸 수 있고, 도메인 이름은 쓸 수 없어요. Hoody의 SSH 게이트웨이로 접속하는 SSH에는 이 규칙이 적용되지 않아요.

    docs / foundation / networking / firewall

  • c43

    Linux 소프트웨어

    필요한 Linux 소프트웨어를 설치하세요. 컴퓨터는 Hoody 커널을 함께 써요. 다른 커널이 필요하면 가상 머신을 쓰세요.

    AI에 이렇게 말하세요
    Postgres를 설치하고 내 앱용 데이터베이스를 설정해 주세요.

    docs / concepts / computers

  • c44

    완전한 가상 머신

    컴퓨터 안에서 Windows나 다른 Linux를 완전한 가상 머신으로 실행해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 컴퓨터에서 Windows 11 VM을 시작해 주세요.

    알아 두기임대 서버나 전용 서버에서만 쓸 수 있고, KVM은 컴퓨터가 중지된 동안 켜요.

    docs / kit / vm

  • c224

    실패한 요청 찾기

    트래픽 로그를 서비스, 경로, HTTP 상태 또는 요청 ID로 걸러요.

    링크https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    AI에 이렇게 말하세요
    오늘 내 앱에 들어온 실패한 요청을 찾아 줘요.

    알아 두기로그 접근은 컴퓨터의 프록시 권한과 설정된 보존 기간을 따라요.

    docs / api / proxy-logs

  • c225

    기록된 본문 읽기

    컴퓨터 트래픽을 살펴볼 때 저장된 요청 또는 응답 본문을 불러와요.

    링크https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    AI에 이렇게 말하세요
    그 요청에 기록된 응답 본문을 보여 줘요.

    알아 두기비밀 값처럼 이름 붙은 필드는 저장 전에 가려져요. 한 페이지에서 본문이 4MiB를 넘으면 나머지는 본문 없이 반환돼요.

    docs / concepts / auditing

  • c226

    시간대별 트래픽 집계

    조건에 맞는 프록시 로그 항목을 시간 구간별로 세어요.

    링크https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs/stats

    AI에 이렇게 말하세요
    오늘 내 앱의 오류를 시간별로 세어 줘요.

    알아 두기버킷 하나는 최소 60000ms이고, 구간마다 버킷은 최대 240개예요.

    docs / api / proxy-logs

  • c227

    감시 파일 필터링

    선택한 경로를 감시하고, 파일 이름 패턴이나 변경 유형으로 이벤트를 걸러요.

    링크https://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers

    AI에 이렇게 말하세요
    내 업로드 폴더에 새 CSV 파일이 생기는지 지켜봐 줘요.

    알아 두기감시는 서비스를 재시작하면 사라져요. 제외 패턴이 포함 패턴보다 우선해요.

    docs / api / watch

  • c228

    파일 변경 다시 보기

    이벤트 ID나 타임스탬프 이후 감시기가 보관한 파일 이벤트를 가져와요.

    링크https://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers/{id}/events

    AI에 이렇게 말하세요
    오늘 아침부터 보관된 파일 변경을 보여 줘요.

    알아 두기기록은 링 버퍼라서 오래된 이벤트가 밀려날 수 있어요. 감시는 서비스를 재시작하면 사라져요.

    docs / api / watch

  • c229

    수신 대기 포트 찾기

    수신 대기 중인 포트를 나열하고, 어떤 프로그램과 사용자가 쓰는지 확인해요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/ports

    AI에 이렇게 말하세요
    3000번 포트에서 대기 중인 프로그램을 찾아 줘요.

    docs / api / terminal / monitoring

  • c230

    작업 일시정지와 재개

    프로세스나 프로세스 트리를 일시정지했다가 메모리 상태 그대로 다시 시작해요.

    AI에 이렇게 말하세요
    내 빌드를 일시정지했다가 나중에 다시 시작해 줘요.

    알아 두기일부 시스템 및 서비스 PID는 보호되어 있어서 이 엔드포인트로 동결하거나 재개할 수 없어요.

    docs / api / terminal / monitoring

  • c231

    서버 리소스 사용량

    서버의 CPU, 메모리, 저장 공간 사용량을 확인해요.

    링크https://api.hoody.com/api/v1/rentals/{id}/runtime

    AI에 이렇게 말하세요
    내 서버의 CPU와 메모리 사용량을 보여 줘요.

    알아 두기실시간 호출에는 로그인한 세션이 필요해요. 서브서버와 공유하는 임대한 서버는 409를 반환해요.

    docs / foundation / servers

  • c232

    방화벽 규칙 일시정지

    방화벽 규칙을 하나씩 끄고, 필요할 때 다시 켜요.

    링크https://api.hoody.com/api/v1/computers/{id}/firewall/ingress

    AI에 이렇게 말하세요
    이 인바운드 방화벽 규칙을 잠시 꺼 줘요.

    알아 두기Hoody SSH 게이트웨이로 접속하는 SSH에는 이 규칙이 적용되지 않아요.

    docs / foundation / networking / firewall

코드 에디터 옵션 6

  • c233

    링크로 폴더 열기

    편집기를 다시 시작하지 않고 링크로 원하는 폴더를 열어요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}

    AI에 이렇게 말하세요
    편집기에서 내 프로젝트 폴더를 열어 줘요.

    알아 두기이미 정규화된 절대 경로를 보내세요.

    docs / api / code

  • c234

    팀원별 편집기 분리

    팀원마다 같은 컴퓨터의 파일을 쓰는 별도 편집기 인스턴스를 줘요.

    AI에 이렇게 말하세요
    같은 프로젝트 파일을 쓰는 별도 편집기를 각자 줘요.

    알아 두기에디터마다 설정과 확장 프로그램이 따로 있고, 커서 공유는 지원하지 않아요.

    docs / guides / multiplayer

  • c235

    편집기 인스턴스 분리

    설정과 확장 프로그램이 따로 있는 편집기 인스턴스를 각각 열어요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com/

    AI에 이렇게 말하세요
    내 고객 프로젝트용 별도 편집기를 열어 줘요.

    알아 두기인스턴스는 컴퓨터의 파일과 서비스 계정을 공유해요. 서로 신뢰하지 않는 사람에게는 컴퓨터를 따로 주세요.

    docs / kit / code

  • c236

    모든 편집기에 확장 프로그램 추가

    URL에 있는 VS Code 확장 프로그램 파일을 컴퓨터의 모든 편집기에 추가해요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code/extensions/install

    AI에 이렇게 말하세요
    이 VSIX 확장 프로그램을 내 편집기에서 쓸 수 있게 준비해 줘요.

    알아 두기에디터는 시작할 때만 설치하므로, 실행 중인 에디터는 `restart=true`로 다시 시작하세요.

    docs / kit / code

  • c237

    확장 프로그램 전용 편집기 화면

    확장 프로그램 하나의 사이드바 화면에 맞춘 편집기 링크를 열어요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&extension={extension}

    AI에 이렇게 말하세요
    Python 확장 프로그램 화면만 따로 열어 줘요.

    알아 두기Code가 일치하는 사이드바 보기를 찾지 못하면 Explorer를 대신 보여 줘요.

    docs / kit / code

  • c238

    편집기 언어 선택

    인스턴스를 시작할 때 편집기의 표시 언어를 선택해요.

    링크https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&locale={locale}

    AI에 이렇게 말하세요
    내 편집기를 일본어로 열어 줘요.

    알아 두기시작 옵션은 인스턴스가 시작될 때 적용돼요. 실행 중인 인스턴스에는 `restart=true`가 필요해요.

    docs / api / code

앱 찾기와 실행 4

  • c239

    스타터 앱 둘러보기

    테스트를 거친 스타터 앱을 둘러보고, 각각 어디에서 열리는지 확인해요.

    링크https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/catalog

    AI에 이렇게 말하세요
    내 컴퓨터의 스타터 앱을 보여 줘요.

    docs / api / run / resolve

  • c240

    앱 실행 사전 점검

    앱을 실행하기 전에 실행 계획과 빠진 요구 사항을 확인해요.

    링크https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/preflight

    AI에 이렇게 말하세요
    이 앱을 실행하는 데 필요한 것을 확인해 줘요.

    docs / api / run / resolve

  • c241

    앱 레시피 저장

    앱을 고르고 실행하는 방식을 이름 붙인 레시피로 저장하고, 이름으로 다시 써요.

    링크https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/recipes

    AI에 이렇게 말하세요
    내가 선호하는 Firefox 선택을 레시피로 저장해 줘요.

    docs / api / run / recipes

  • c242

    앱 일괄 조회

    여러 앱을 검색하거나 앱의 명령어를 한 번의 요청으로 찾아요.

    링크https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/batch

    AI에 이렇게 말하세요
    이 앱 10개의 실행 명령어를 찾아 줘요.

    알아 두기요청 하나에는 항목을 최대 100개까지 담을 수 있어요. 더 긴 요청은 통째로 거부되고 400 `BATCH_TOO_LARGE`를 받아요.

    docs / api / run / resolve

가상 머신 14

  • c243

    브라우저에서 VM 화면

    가상 머신 화면을 열고 키 입력과 클릭을 보내요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/display

    AI에 이렇게 말하세요
    Linux 설치를 마칠 수 있게 VM 화면을 열어 주세요.

    알아 두기VM에는 자체 화면 설정이 필요해요. 브라우저의 복사와 붙여넣기는 지원하지 않고, 화면에는 자체 프록시 권한이 있어요.

    docs / kit / vm

  • c244

    VM 스냅샷

    위험한 변경 전에 중지한 VM의 스냅샷을 만들고, 변경 후에 복원해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/snapshots

    AI에 이렇게 말하세요
    운영 체제를 업그레이드하기 전에 VM 스냅샷을 만들어 주세요.

    알아 두기VM이 중지되어 있어야 해요. 복원하면 디스크, UEFI varstore, TPM 상태가 교체되고 되돌릴 수 없어요.

    docs / kit / vm

  • c245

    VM 설치 파일 다운로드

    URL로 가상 머신용 설치 이미지를 다운로드해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/isos/downloads

    AI에 이렇게 말하세요
    이 Linux 설치 파일을 내 VM에 다운로드해 주세요.

    알아 두기가능하면 제공처의 SHA-256을 함께 입력하세요. 없으면 이미지를 처음 사용할 때 신뢰해요.

    docs / kit / vm

  • c246

    가상 머신 일시정지

    VM의 CPU를 멈췄다가 메모리 상태 그대로 다시 이어서 실행해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/pause

    AI에 이렇게 말하세요
    다시 필요할 때까지 테스트 VM을 일시정지해 주세요.

    알아 두기일시정지한 VM은 메모리를 그대로 차지해요. 메모리를 돌려받으려면 중지하세요.

    docs / kit / vm

  • c247

    VM 포트 포워딩

    컴퓨터의 포트를 가상 머신 안의 서비스로 전달해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AI에 이렇게 말하세요
    포트 2222를 내 VM의 SSH로 전달해 주세요.

    알아 두기포워드는 컴퓨터의 모든 주소에서 호스트 포트를 열어요. 포워드를 바꾸려면 VM을 중지하세요.

    docs / kit / vm

  • c248

    VM 공유 폴더

    컴퓨터와 가상 머신 사이에서 폴더를 공유해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AI에 이렇게 말하세요
    내 VM에 프로젝트 파일용 공유 폴더를 추가해 주세요.

    알아 두기VM 스냅샷 내보내기에는 공유 폴더의 파일이 포함되지 않아요.

    docs / kit / vm

  • c249

    VM 디스크 복제

    다른 VM의 디스크 사본으로 가상 머신을 만들어요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AI에 이렇게 말하세요
    업그레이드를 시험해 볼 수 있게 테스트 VM을 복제해 주세요.

    알아 두기원본 VM이 중지되어 있어야 해요. 사본은 새 ID와 TPM을 받아요.

    docs / kit / vm

  • c250

    가상 머신 이동

    VM 스냅샷을 내보내고 다른 컴퓨터에서 VM을 만들어요.

    AI에 이렇게 말하세요
    테스트 VM을 내 다른 컴퓨터로 옮겨 주세요.

    알아 두기공유 폴더의 파일은 포함되지 않아요. 원래 디스크 버스를 쓰고, 원본을 삭제하기 전에 대상을 확인하세요.

    docs / kit / vm

  • c251

    VM 크기 조정

    중지한 VM의 메모리, CPU, 디스크 크기를 다음 시작부터 바꿔요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    AI에 이렇게 말하세요
    중지한 VM에 메모리와 CPU를 더 할당해 주세요.

    알아 두기VM이 중지되어 있어야 해요. 디스크 크기는 늘리기만 할 수 있고, 다른 값 없이 단독으로 보내야 해요.

    docs / kit / vm / reference

  • c252

    VM 자동 시작

    컴퓨터가 재시작 후 다시 켜지면 VM도 자동으로 시작해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    AI에 이렇게 말하세요
    컴퓨터가 재시작되면 내 VM을 자동으로 시작해 주세요.

    알아 두기자동 시작은 기본적으로 꺼져 있어요. 바꾸려면 VM이 중지되어 있어야 해요.

    docs / kit / vm

  • c253

    VM 시리얼 콘솔

    링크로 VM의 시리얼 콘솔을 읽고 명령을 보내요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/console

    AI에 이렇게 말하세요
    내 VM의 부팅이 실패했을 때 콘솔 출력을 읽어 주세요.

    알아 두기게스트 콘솔 중에는 루트 셸이 많으니, 쓰기 권한을 셸 접근처럼 다루세요.

    docs / kit / vm

  • c254

    중첩 가상 머신

    테스트나 CI용으로 VM 안에서 하드웨어 가속 가상 머신을 실행해요.

    AI에 이렇게 말하세요
    내 게스트 안에 VM 기반 CI를 설정해 주세요.

    알아 두기중첩 가상화가 켜진 전용 서버가 필요해요. 중첩 가상화는 Hoody 고객지원에 요청하면 켜 줘요.

    docs / foundation / servers / virtual-machines

  • c255

    VM 게스트 정보

    VM 게스트의 운영 체제, 네트워크 주소, 로그인한 사용자를 읽어요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/agent/inventory

    AI에 이렇게 말하세요
    내 VM 안의 IP 주소를 보여 주세요.

    알아 두기게스트 에이전트가 정보를 보고해야 해요. 지원되지 않거나 사용할 수 없는 항목은 빠져 있을 수 있어요.

    docs / api / vm / console

  • c256

    실시간 VM 이벤트

    VM의 상태와 스냅샷 이벤트를 발생하는 대로 스트리밍해요.

    링크https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/events

    AI에 이렇게 말하세요
    내 VM의 상태와 스냅샷 변경을 지켜봐 주세요.

    알아 두기연결이 끊긴 뒤에는 이벤트를 다시 보내지 않아요. 다시 연결해서 현재 상태를 읽으세요.

    docs / kit / vm

기본 포함 10

  • c45

    공유 메모

    표, 파일, 댓글이 있는 메모를 작성하고 함께 실시간으로 편집해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    오늘의 계획을 공유 메모로 작성해 주세요.

    docs / api / notes

  • c46

    평소 쓰던 SSH

    내 SSH, SFTP 또는 VS Code Remote로 접속해요.

    입력ssh root@{p}-{c}-ssh.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 컴퓨터에 접속하는 SSH 명령어를 알려 주세요.

    알아 두기공개 키만 가능하고, 컴퓨터당 키는 1개예요.

    docs / foundation / networking / ssh

  • c47

    업로드, 검색, 압축

    파일을 업로드하고 검색하고, 압축 파일을 풀고, 폴더를 ZIP으로 다운로드해요.

    링크https://{p}-{c}-files-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    reports 폴더를 압축하고 다운로드 링크를 주세요.

    알아 두기ZIP에는 보호된 서비스 상태가 포함되지 않고, 파일은 최대 1,000,000개까지 담겨요.

    docs / kit / files

  • c48

    실행 중인 항목 확인

    CPU, 메모리, 디스크 활동을 한눈에 확인하고, 실행 중인 프로그램 목록도 볼 수 있어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/resources 프로그램은 /api/v1/system/processes 경로를 쓰세요.

    AI에 이렇게 말하세요
    지금 내 컴퓨터가 왜 느려요?

    docs / kit / terminals

  • c49

    재시작해도 남는 설정

    설정과 키를 재시작해도 남는 환경 변수로 보관해요.

    링크https://api.hoody.com/api/v1/computers/{c}/env

    AI에 이렇게 말하세요
    내 앱의 API 키를 환경 변수로 설정해 주세요.

    알아 두기실행 중인 프로그램은 다시 시작한 뒤에 변경 내용을 반영해요. 컴퓨터에서 명령을 실행할 수 있는 사람은 누구나 값을 읽을 수 있어요.

    docs / api / computer-env

  • c50

    메모리처럼 빠른 저장 공간

    캐시와 임시 작업에는 메모리 기반의 빠른 저장 공간을 써요.

    AI에 이렇게 말하세요
    빌드 캐시를 RAM 저장 공간에 둬 주세요.

    알아 두기기본값은 512MiB이고 최대 서버 메모리의 절반까지예요. 서버의 모든 컴퓨터가 함께 쓰고, 서버가 재부팅되면 지워져요.

    docs / foundation / storage / ramdisk

  • c52

    컴퓨터 안의 VPN

    VPN 제공업체의 WireGuard 파일을 컴퓨터 안에서 실행하고, 링크도 계속 쓸 수 있어요.

    AI에 이렇게 말하세요
    이 컴퓨터를 내 Mullvad VPN에 연결해 주세요.

    알아 두기제공업체의 앱이 아니라 wg-quick으로 WireGuard 파일을 시작하세요. IPv6 항목은 지우고, Network Configuration 경로는 중지된 상태로 두고, 먼저 SSH 키를 추가하세요.

    docs / foundation / networking / vpn

  • c53

    데스크톱 녹화

    뷰어에서 바로 데스크톱 화면을 동영상 파일로 녹화해요.

    링크https://{p}-{c}-display-1.{node}.computers.hoody.com/?record=true

    AI에 이렇게 말하세요
    AI가 데모를 실행하는 동안 데스크톱을 녹화해 주세요.

    알아 두기브라우저가 녹화해서 MP4, WebM 또는 GIF로 저장해요. GIF는 30초에서 멈추고, 긴 녹화는 저장될 때까지 브라우저 메모리에 남아 있을 수 있어요.

    docs / kit / displays

  • c54

    터미널에 파일 놓기

    터미널의 프로그램에 파일을 끌어다 놓은 것처럼 넘겨요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/drop

    AI에 이렇게 말하세요
    이 스크린샷을 내 Claude Code 터미널에 넣어 주세요.

    docs / api / terminal / file-drop

  • c257

    디스크에 남지 않는 시크릿

    복호화한 키를 메모리에만 두어요. 디스크, 스냅샷, 백업에는 남지 않아요.

    AI에 이렇게 말하세요
    이 작업 동안 복호화한 자격 증명을 메모리에 보관해 주세요.

    알아 두기Free 서버와 유료 서브서버에서만 쓸 수 있어요. 호스트 서버가 재부팅되면 사라져요.

    docs / foundation / storage / ramdisk

메모 사용 8

  • c258

    메모를 Markdown으로 읽기

    메모 페이지 하나를 Markdown 또는 HTML로 가져와요. 전체도, 줄 범위만도 가져올 수 있어요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document

    AI에 이렇게 말하세요
    회의 메모 페이지를 Markdown으로 읽어 주세요.

    알아 두기페이지 하나만 반환해요. 하위 페이지까지 함께 받으려면 노트북 내보내기를 쓰세요.

    docs / api / notes / nodes

  • c259

    최근 메모 찾기

    제목이나 내용이 가장 최근에 바뀐 메모 페이지를 최신순으로 확인해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/recent

    AI에 이렇게 말하세요
    가장 최근에 바뀐 페이지를 보여 주세요.

    docs / api / notes / nodes

  • c260

    메모 블록 추가

    메모 끝에 텍스트나 구조화된 블록을 추가해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document/append

    AI에 이렇게 말하세요
    오늘 회의 메모를 해당 페이지 끝에 추가해 주세요.

    알아 두기요청당 블록 최대 100개예요.

    docs / api / notes / nodes

  • c261

    메모 버전 저장

    메모를 버전으로 저장해 두고 나중에 복원해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

    AI에 이렇게 말하세요
    이 메모를 편집하기 전에 버전을 저장해 주세요.

    알아 두기복원하면 교체되는 내용이 새 버전으로 저장돼요.

    docs / api / notes / versions

  • c262

    메모를 ZIP으로 내보내기

    메모장 전체나 섹션, 폴더, 페이지, 데이터베이스 하나를 Markdown 또는 HTML ZIP으로 다운로드해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/export

    AI에 이렇게 말하세요
    내 메모장을 Markdown ZIP으로 내보내 주세요.

    알아 두기아카이브에는 읽을 수 있는 항목만 담겨요. 채널과 메시지, 데이터베이스 보기, 필드 정의는 빠져요.

    docs / api / notes / notebooks

  • c263

    메모 공동 작업자 역할

    메모에 공동 작업자를 추가하고 역할을 정해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/collaborators

    AI에 이렇게 말하세요
    Sam을 이 메모의 공동 작업자로 추가해 주세요.

    알아 두기역할은 admin, editor, collaborator, viewer 중 하나예요. 페이지에 admin 권한이 있어야 해요.

    docs / api / notes / collaborators

  • c264

    메모 레코드 필터

    메모 데이터베이스의 레코드를 필터링하고, 정렬하고, 이름으로 검색해요.

    링크https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/databases/{databaseId}/records

    AI에 이렇게 말하세요
    내 메모 데이터베이스의 레코드를 이름순으로 보여 주세요.

    알아 두기목록은 페이지로 나뉘어 있어요.

    docs / api / notes / databases

  • c265

    재개 가능한 메모 업로드

    파일을 나눠서 메모장에 업로드해요. 중단돼도 이어서 올릴 수 있어요.

    AI에 이렇게 말하세요
    이 큰 첨부 파일을 나눠서 내 메모장에 업로드해 주세요.

    알아 두기파일 노드를 만든 사용자만 업로드할 수 있어요.

    docs / api / notes / files

hoody / capabilities / bots

02 114 항목

Bots

평소 쓰는 말로 Hoody 전체를 다뤄요. Bot이 작업을 에이전트 팀에 넘겨요.

내 Bot 17

  • b01

    내 Bot

    오래 이어지는 채팅 하나로 Hoody 전체를 쉬운 말로 실행해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}?realm={realm}

    AI에 이렇게 말하세요
    내 Bot에게 블로그를 만들어 달라고 해 주세요.

    docs / api / agent / bots

  • b02

    에이전트 팀

    작업을 맡기면 에이전트 팀이 처리하고 결과를 알려 줘요.

    AI에 이렇게 말하세요
    에이전트 팀에게 실패한 테스트를 고치게 하고 결과를 알려 주세요.

    docs / api / agent / bots

  • b03

    다시 설명하지 않아도 돼요

    Bot은 메시지가 오가도 대화를 이어 가요. 긴 대화는 요약될 수 있어요.

    AI에 이렇게 말하세요
    어제 하던 데서 이어서 해 주세요.

    docs / api / agent / bots

  • b04

    규칙과 범위

    Bot이 다룰 수 있는 컴퓨터와 따라야 할 규칙을 정해요.

    AI에 이렇게 말하세요
    내 Bot은 웹 프로젝트에서만 작업하고, main에는 푸시하지 않게 해 주세요.

    알아 두기변경 사항은 새로 위임하는 에이전트에만 적용돼요. 이미 실행 중인 에이전트는 받은 제한을 그대로 유지해요.

    docs / api / agent / bots

  • b05

    Bot 공유

    Bot의 .hoody.bot 링크를 믿을 수 있는 사람과 공유하세요. 상대는 계정 없이 자신의 키로 어떤 브라우저에서든 Bot과 채팅할 수 있어요.

    링크https://<label>.hoody.bot

    AI에 이렇게 말하세요
    공동 창업자가 내 Bot을 쓸 수 있게 해 주세요.

    알아 두기모두가 대화 하나를 공유하고, 모든 호출은 내 크레딧이나 제공업체 키로 처리돼요. 키마다 일시정지하거나 폐기하거나 주소별로 제한할 수 있어요. 요청 한도는 모든 키에 똑같이 적용되고, 지출 상한은 아직 없어요. Bot URL은 IPv4에서만 작동해요.

    docs / kit / agent / bot-urls

  • b06

    다른 AI 앱 속의 Bot

    다른 AI 앱과 에이전트를 Bot의 .hoody.bot URL과 이름을 붙인 키로 연결해요.

    링크https://<label>.hoody.bot/v1

    AI에 이렇게 말하세요
    이 앱에서 내 Hoody Bot을 모델로 써 주세요.

    알아 두기Bot은 자체 공유 대화를 유지해요. 앱의 마지막 메시지만 사용하고, 시스템 프롬프트와 도구, 이전 메시지는 무시해요.

    docs / kit / agent / bot-urls / calling

  • b07

    Bot과 대화

    Bot에게 실시간으로 말하거나 음성 녹음을 보내요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/voice

    AI에 이렇게 말하세요
    운전 중에도 Bot과 말할 수 있게 해 주세요.

    알아 두기Bot당 음성 연결은 한 번에 1개이고, 음성에는 하루 한도가 있어요.

    docs / kit / agent / voice

  • b08

    음성 앱 속의 Bot

    LiveKit이나 Pipecat처럼 OpenAI Realtime 기반으로 만든 음성 앱이 Bot과 대화할 수 있어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/realtime

    AI에 이렇게 말하세요
    내 음성 어시스턴트를 Bot에 연결해 주세요.

    알아 두기Bot당 음성 연결은 한 번에 1개예요.

    docs / api / agent / bots / voice

  • b10

    모든 채팅 앱에 Bot 하나

    Telegram, Slack, Discord가 모두 같은 Bot과 같은 대화로 이어져요.

    AI에 이렇게 말하세요
    우리 팀 Slack에도 내 Bot을 연결해 주세요.

    알아 두기Bot은 텍스트만 읽어요. 파일, 이미지, 음성 메시지는 전달되지 않고 캡션이나 텍스트만 전달돼요. 페어링한 사람은 모두 같은 대화를 공유해요.

    docs / kit / agent / chat-apps

  • b29

    Bot마다 다른 모델

    Bot이 직접 답할 때 쓸 모델을 골라요.

    AI에 이렇게 말하세요
    리서치 Bot에 전용 모델을 지정해 주세요.

    알아 두기Bot이 시작하는 작업은 해당 Bot에 작업별 모델을 켜지 않으면 기본 모델을 써요.

    docs / kit / agent / ai-models

  • b30

    Bot 기본값 분리

    Bot의 기본 모델을 AI 도우미와 따로 설정해요.

    AI에 이렇게 말하세요
    내 Bot에는 다른 기본 모델을 써 주세요.

    알아 두기기본값을 따르는 Bot은 대화가 다시 시작될 때 바뀐 기본값으로 전환돼요.

    docs / kit / agent / ai-models

  • b31

    핸즈프리 음성

    손을 쓰지 않고 말해요. Bot이 말을 시작하고 멈추는 때를 알아채요.

    AI에 이렇게 말하세요
    내 Bot과 핸즈프리로 대화를 시작해 주세요.

    알아 두기헤드폰을 쓰세요. 전이중 모드에서는 말로 답변을 끊을 수 있어요.

    docs / kit / agent / voice

  • b32

    음성 입력과 텍스트 답변

    말로 질문하고 Bot의 답을 글로 읽어요. 음성 재생은 없어요.

    AI에 이렇게 말하세요
    내 Bot에 말로 질문하고, 답은 글로 읽게 해 주세요.

    알아 두기음성을 텍스트로 바꾸는 작업은 계속 실행돼요. Hoody Voice는 서버의 음성 한도에서 차감되고, 다른 제공업체는 요금을 청구해요.

    docs / kit / agent / voice

  • b33

    작업 에이전트 선택

    Bot이 넘기는 작업에 쓸 수 있는 에이전트를 골라요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    AI에 이렇게 말하세요
    이 Bot이 내 리뷰어 에이전트만 쓰게 해 주세요.

    알아 두기목록이 비어 있으면 모든 에이전트가 대상이에요.

    docs / api / agent / bots

  • b34

    규칙에 맞는지 작업 확인

    Bot이 새 작업을 시작하기 전에 가드레일에 맞는지 확인해요.

    AI에 이렇게 말하세요
    새 작업이 내 Bot의 가드레일에 맞는지 확인해 주세요.

    알아 두기엄격 모드의 Bot은 검사기를 실행할 수 없는 동안 모든 작업을 거부해요.

    docs / kit / agent / ai-models

  • b35

    작업 에이전트 자동 승인

    Bot이 맡긴 에이전트가 도구 승인을 자동으로 받아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    AI에 이렇게 말하세요
    이 Bot의 작업 에이전트에 도구 자동 승인을 켜 주세요.

    알아 두기기본값은 꺼짐이에요. 켜면 워커가 먼저 묻지 않고 작업해요.

    docs / api / agent / bots

  • b36

    일일 음성 한도

    Bot이 말하고 받아쓰는 양에 하루 한도를 정해요.

    AI에 이렇게 말하세요
    내 Bot의 하루 음성 한도를 정해 주세요.

    알아 두기기본값은 UTC 기준 하루에 소리 내어 읽는 텍스트 200,000자와 텍스트로 변환하는 음성 14,400초예요.

    docs / api / agent / bots

채팅 앱에서 쓰는 Bot 11

  • b37

    채팅 앱 사용자 페어링

    다른 사람에게 페어링 코드를 줘서 채팅 앱에서 Bot과 대화하게 해요.

    AI에 이렇게 말하세요
    Sam이 내 Bot과 대화할 수 있게 페어링 코드를 만들어 주세요.

    알아 두기다이렉트 메시지 정책을 pairing으로 설정하세요. 새 코드가 이전 코드를 대체해요.

    docs / kit / agent / chat-apps

  • b38

    채팅으로 받는 업데이트

    Bot의 완료된 작업, 승인 요청, 오류를 홈 채팅으로 보내요.

    AI에 이렇게 말하세요
    내 Bot의 작업 업데이트를 다이렉트 메시지로 보내 주세요.

    알아 두기홈 채팅은 채팅 앱의 다이렉트 메시지 하나 또는 승인된 그룹 하나예요.

    docs / kit / agent / chat-apps

  • b39

    채팅에서 중지

    채팅 명령으로 Bot이 하던 일을 중지해요.

    AI에 이렇게 말하세요
    Telegram에서 내 Bot을 중지해 주세요.

    알아 두기보내는 사람에게 제어 권한이 있어야 해요.

    docs / kit / agent / chat-apps

  • b40

    채팅 권한 선택

    페어링한 사람이 채팅하고, 명령을 실행하고, 승인을 결정할 수 있는지 골라요.

    AI에 이렇게 말하세요
    Sam은 내 Bot과 채팅할 수 있지만 승인은 결정하지 못하게 해 주세요.

    알아 두기공개 게스트는 채팅만 할 수 있어요.

    docs / kit / agent / chat-apps / settings

  • b41

    그룹 채팅 승인

    그룹을 승인해야 구성원이 Bot과 대화할 수 있어요.

    AI에 이렇게 말하세요
    우리 프로젝트 그룹이 내 Bot과 대화할 수 있게 승인해 주세요.

    알아 두기승인된 그룹의 모든 멤버가 Bot의 답변을 읽을 수 있어요.

    docs / kit / agent / chat-apps

  • b42

    채팅 사용자 차단

    Bot의 모든 채팅에서 선택한 사용자의 메시지를 무시해요.

    AI에 이렇게 말하세요
    이 사용자가 내 Bot에 메시지를 보내지 못하게 차단해 주세요.

    알아 두기채팅 앱의 차단 사용자 목록에는 플랫폼 사용자 ID를 최대 200개까지 담을 수 있어요.

    docs / kit / agent / chat-apps / settings

  • b43

    채팅에 답변 미러링

    Bot의 다른 접속 경로에서 나온 답변도 홈 채팅으로 보내요.

    AI에 이렇게 말하세요
    내 Bot의 앱 답변을 홈 채팅에도 보내 주세요.

    알아 두기이 설정은 기본값이 꺼짐이에요.

    docs / kit / agent / chat-apps / settings

  • b44

    채팅 앱 모두 일시정지

    Bot에 연결된 모든 채팅 앱을 한 번에 일시정지해요.

    AI에 이렇게 말하세요
    내 Bot의 채팅 앱을 모두 일시정지해 주세요.

    알아 두기채팅 앱마다 사용 여부를 따로 저장해요.

    docs / kit / agent / chat-apps / settings

  • b45

    답변 형식 선택

    Bot의 채팅 답변을 서식 있는 텍스트와 일반 텍스트 중에서 골라요.

    AI에 이렇게 말하세요
    내 Bot의 답변을 일반 텍스트로 보내 주세요.

    docs / kit / agent / chat-apps / settings

  • b46

    채팅 메시지 한도

    Bot을 쓰는 사람과 채팅의 메시지 횟수 한도를 정해요.

    AI에 이렇게 말하세요
    한 사람당 Bot 메시지를 분당 10개로 제한해 주세요.

    알아 두기기본값은 한 사람이 1분에 메시지 10개까지 보낼 수 있어요. 0을 넣으면 이 제한을 끄고, 최대 600까지 설정할 수 있어요.

    docs / kit / agent / chat-apps / settings

  • b47

    채팅 알림 언어

    Bot의 채팅 앱 알림에 쓸 언어를 골라요.

    AI에 이렇게 말하세요
    내 채팅 앱 알림을 프랑스어로 보여 주세요.

    알아 두기Bot의 답변은 번역되지 않아요. 사용할 수 있는 언어는 en, de, fr, es, pt, it, ja, zh예요.

    docs / kit / agent / chat-apps / settings

Bot URL 키와 한도 6

  • b48

    키로 Bot 상태 확인

    Bot이 작업 중인지 확인하고 대기 중인 승인을 봐요.

    AI에 이렇게 말하세요
    내 Bot이 작업 중인지 승인을 기다리는지 확인해 주세요.

    알아 두기Bot URL 키가 필요해요.

    docs / kit / agent / bot-urls / calling

  • b49

    Bot 이벤트 따라가기

    Bot의 실시간 이벤트를 따라가고, 저장한 커서부터 이어서 받아요.

    AI에 이렇게 말하세요
    내 Bot의 실시간 이벤트를 마지막 커서부터 따라가 주세요.

    알아 두기Bot URL 키가 필요해요. 키당 스트림을 최대 4개까지 열 수 있어요.

    docs / kit / agent / bot-urls / calling

  • b50

    만료되는 Bot 키

    임시 접근을 위해 Bot URL 키에 만료 시간을 정해요.

    링크https://api.hoody.com/api/v1/bot-urls/{id}/keys/{keyId}

    AI에 이렇게 말하세요
    Sam의 Bot 키가 12월 말에 만료되게 해 주세요.

    docs / api / bot-urls

  • b51

    Bot URL 접속 로그

    어떤 이름의 키가 어느 주소에서 Bot을 호출했는지 확인해요.

    AI에 이렇게 말하세요
    내 Bot의 접속 로그에서 예상 밖의 주소가 있는지 확인해 주세요.

    알아 두기최선을 다해 기록하지만, 일부 거부는 로그에 남지 않아요. 로그에는 오간 내용도, 키 자체도 담기지 않아요.

    docs / kit / agent / bot-urls / status

  • b52

    Bot URL 트래픽 제한

    Bot URL과 키에 요청 한도와 동시 실행 한도를 정해요.

    AI에 이렇게 말하세요
    내 Bot URL의 키별 요청 한도를 낮춰 주세요.

    알아 두기키별 설정은 모든 키에 적용돼요. 한도는 금액이 아니라 요청 횟수로 계산해요.

    docs / kit / agent / bot-urls / security

  • b53

    Bot 키 모두 폐기

    Bot URL을 끄고 모든 키를 한 번에 폐기해요.

    링크https://api.hoody.com/api/v1/bot-urls/{id}/panic

    AI에 이렇게 말하세요
    내 Bot URL을 끄고 모든 키를 폐기해 주세요.

    알아 두기이미 실행 중인 호출은 끝까지 실행되고, Bot이 이미 시작한 작업은 중지하기 전까지 계속돼요.

    docs / kit / agent / bot-urls / security

내 컴퓨터 안의 에이전트 22

  • b11

    모든 컴퓨터의 Hoody Agent

    AI 에이전트가 컴퓨터 안에서 실행돼요. 탭에서 열거나 SSH 또는 CLI로 접속해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내 Hoody Agent를 열어 주세요.

    docs / kit / agent

  • b12

    계속 이어지는 세션

    탭을 닫아도 AI는 계속 작업해요. 어떤 기기에서든 이어서 쓸 수 있어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    내가 자리를 비운 동안에도 이 작업을 계속해 주세요.

    docs / kit / agent

  • b13

    어떤 모델이든

    100개 이상의 AI 제공업체 중에서 고르거나 직접 모델 서버를 추가해요.

    AI에 이렇게 말하세요
    이 채팅을 더 빠른 모델로 바꿔 주세요.

    알아 두기내 모델 서버는 공개 HTTPS 주소에서 OpenAI 또는 Anthropic API를 지원해야 해요.

    docs / kit / agent

  • b14

    여러 모델을 동시에

    여러 모델에 동시에 물어보고 하나로 합친 답을 받아요.

    AI에 이렇게 말하세요
    모델 세 개에 물어보고 가장 좋은 답을 알려 주세요.

    docs / kit / agent / ai-models

  • b15

    GitHub 내장

    에이전트에서 바로 복제하고, 커밋하고, 끌어오기 요청을 열어요.

    AI에 이렇게 말하세요
    이 수정으로 끌어오기 요청을 열어 주세요.

    docs / kit / agent

  • b16

    AI에 도구 추가

    MCP 서버를 연결해 에이전트에 새 도구를 추가해요.

    AI에 이렇게 말하세요
    우리 팀의 MCP 서버를 내 에이전트에 추가해 주세요.

    알아 두기로컬 서버는 내 권한으로 실행되고 샌드박스 안에서 실행되지 않아요. 원격 서버는 내가 지정한 헤더를 받아요. 신뢰하는 서버만 추가하세요.

    docs / kit / agent

  • b17

    어떤 AI든 쓸 수 있는 기억

    에이전트가 기억을 저장하고 검색해요. 특정 AI 앱에 묶이지 않아요.

    AI에 이렇게 말하세요
    내 사이트가 Postgres를 쓴다는 점을 기억해 주세요.

    docs / api / agent / memory

  • b18

    스킬

    에이전트에게 새 작업을 가르치는 스킬을 설치해요.

    AI에 이렇게 말하세요
    릴리스 노트를 쓰는 스킬을 설치해 주세요.

    docs / api / agent / skills

  • b19

    스케줄에 따라 실행되는 AI

    에이전트가 스케줄에 따라 상태를 확인하고 작업하게 해요.

    AI에 이렇게 말하세요
    오늘은 매시간 내 사이트를 확인하고 문제가 생겼는지 알려 주세요.

    알아 두기1분 이상의 정해진 간격으로 반복해요. 기본 50회이고 다른 횟수로 설정할 수도 있으며, 활성 루프는 최대 8개예요. 채팅이 닫히거나 에이전트가 다시 시작되면 멈춰요. 계속 유지할 스케줄에는 cron을 쓰세요.

    docs / api / agent / loops

  • b20

    저장된 AI 워크플로

    AI 워크플로를 저장해 두고, 원할 때 다시 실행해요.

    AI에 이렇게 말하세요
    이 작업을 다시 실행할 수 있는 워크플로로 저장해 줘요.

    docs / api / agent / workflows

  • b21

    AI의 할 일 목록

    AI가 대기 중인 작업과 지금 진행 중인 작업을 확인해요.

    AI에 이렇게 말하세요
    내 프로젝트의 할 일 목록에 뭐가 있나요?

    docs / api / agent / todos

  • b22

    채팅 분기

    채팅을 분기해 다른 방법을 시도하고, 처음 채팅은 그대로 둬요.

    AI에 이렇게 말하세요
    이 채팅을 분기해서 다른 디자인으로 시도해 줘요.

    docs / api / agent / sessions

  • b23

    AI 사용량 확인

    채팅별, 모델별 AI 사용량을 확인해요.

    AI에 이렇게 말하세요
    이번 주에 AI를 얼마나 썼나요?

    docs / api / agent / statistics

  • b24

    채팅 없는 작업

    에이전트에 작업을 보내 두고 결과는 나중에 받아요. 채팅은 필요 없어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    이 보고서를 백그라운드에서 실행하고, 나중에 확인할 수 있는 작업을 만들어 주세요.

    알아 두기헤드리스 작업은 모든 확인을 스스로 승인하고 컴퓨터에서 명령을 실행할 수 있으므로, 먼저 프록시 권한으로 에이전트 링크를 잠그세요. 결과는 작업에서 가져와요.

    docs / api / agent / headless

  • b25

    에이전트 이벤트 훅

    에이전트가 시작하거나 도구를 사용하거나 끝날 때 내 명령을 실행해요. Claude Code와 같은 방식이에요.

    AI에 이렇게 말하세요
    테스트가 통과할 때까지 에이전트가 끝나지 않게 해 주세요.

    알아 두기수정한 훅은 내 확인을 기다린 뒤에 실행돼요.

    docs / api / agent / hooks

  • b26

    내 에이전트

    에이전트를 직접 만들어요. 에이전트마다 모델, 도구, 지침을 따로 정해요.

    AI에 이렇게 말하세요
    저렴한 모델을 쓰는 읽기 전용 리뷰어 에이전트를 만들어 주세요.

    docs / api / agent / agents

  • b27

    작업 전에 확인

    무언가를 바꾸는 작업마다 에이전트가 먼저 물어보게 해요.

    AI에 이렇게 말하세요
    무엇이든 바꾸거나 실행하기 전에 먼저 물어봐 주세요.

    알아 두기읽기는 묻지 않고 통과해요. 물어볼 수 없는 하위 에이전트, 워크플로 실행 등 중첩 실행은 거부되고, 내 훅은 건너뛰며 MCP 서버는 시작되지 않아요. 잠긴 모드는 세션 내내 유지돼요.

    docs / api / agent / sessions / approvals

  • b28

    휴대폰에서 승인

    Bot의 에이전트가 위험한 작업 전에 확인을 요청하면, Telegram, Slack 또는 Discord에서 승인이나 거부를 누르세요.

    AI에 이렇게 말하세요
    무엇이든 배포하기 전에 Telegram으로 나에게 물어봐 주세요.

    알아 두기내가 허용한 사람만 버튼을 누를 수 있어요.

    docs / kit / agent / chat-apps / approvals

  • b54

    만들기 전에 계획 세우기

    에이전트를 계획 모드로 바꿔서 구현하기 전에 작업을 설계해요.

    AI에 이렇게 말하세요
    앱을 만들기 전에 아키텍처를 계획해 주세요.

    알아 두기계획대로 만들려면 일반 에이전트로 다시 전환하세요.

    docs / guides / vibe-coding

  • b55

    앱 실시간 미리보기

    에이전트가 파일을 바꿀 때마다 앱 미리보기가 갱신돼요.

    AI에 이렇게 말하세요
    앱을 만드는 동안 실시간 미리보기를 시작해 주세요.

    알아 두기문서에 나온 워크플로는 Vite 개발 서버를 시작하고, 컴퓨터 화면의 브라우저에서 열어요.

    docs / guides / vibe-coding

  • b56

    수정 없이 살펴보기

    탐색 모드에서는 읽기 전용 도구로 코드를 조사해요.

    AI에 이렇게 말하세요
    이 코드베이스를 살펴보고 로그인이 어떻게 동작하는지 설명해 주세요.

    docs / guides / vibe-coding / reference

  • b57

    에이전트 작업 스트리밍

    턴이 실행되는 동안 에이전트의 도구 호출, 결과, 메시지를 지켜봐요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{session_id}/prompt:stream

    AI에 이렇게 말하세요
    에이전트가 작업하는 동안 도구 호출을 보여 주세요.

    알아 두기프록시 권한을 설정하지 않으면 컴퓨터 URL 자체가 자격 증명이에요.

    docs / guides / ai-agents

에이전트 세션 14

  • b58

    채팅 이름 바꾸기

    에이전트 세션에 찾기 쉬운 제목을 붙여요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}

    AI에 이렇게 말하세요
    이 채팅 이름을 “릴리스 계획”으로 바꿔 주세요.

    알아 두기제목은 최대 120자예요.

    docs / api / agent / sessions

  • b59

    채팅 기록 읽기

    저장된 대화를 도구 호출과 결과까지 포함해 불러와요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/transcript

    AI에 이렇게 말하세요
    마지막 세션의 기록을 보여 주세요.

    docs / api / agent / sessions / streaming

  • b60

    대화 자르기

    세션에서 이후 턴을 지우고 이전 시점부터 이어가요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/trim

    AI에 이렇게 말하세요
    이 채팅을 마지막 요청 직전 턴까지만 남기고 잘라 주세요.

    알아 두기턴 사이에서만 작동하고, 턴이 실행되는 중에는 작동하지 않아요.

    docs / api / agent / sessions

  • b61

    여러 세션 지켜보기

    최대 32개의 실시간 세션 이벤트를 하나의 스트림으로 따라가요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions:events

    AI에 이렇게 말하세요
    이 에이전트 세션들을 함께 모니터링해 주세요.

    알아 두기활성 세션만 지켜볼 수 있어요.

    docs / api / agent / sessions / streaming

  • b62

    추론 강도 조절

    세션의 모델이 얼마나 깊게 추론할지 선택해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/effort

    AI에 이렇게 말하세요
    이 세션의 추론 강도를 높음으로 설정해 주세요.

    알아 두기단계는 low, medium, high, xhigh, max예요.

    docs / api / agent / sessions / settings

  • b63

    더 짧은 에이전트 답변

    원하는 상세 수준에 맞게 세션의 답변 길이를 설정해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/verbosity

    AI에 이렇게 말하세요
    이 세션의 답변을 간결하게 해 주세요.

    docs / api / agent / sessions / settings

  • b64

    대기 중인 에이전트 질문

    여러 세션에서 내 답을 기다리는 질문과 확인 요청을 모아 봐요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/gates

    AI에 이렇게 말하세요
    내 입력이 필요한 에이전트 세션을 보여 주세요.

    알아 두기이 에이전트가 활성 상태로 열어 둔 세션만 목록에 나와요.

    docs / api / agent / sessions / approvals

  • b65

    도구 허용 또는 거부

    특정 에이전트 도구를 허용하거나 거부하는 세션 규칙을 설정해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/approval/rules/{tool}

    AI에 이렇게 말하세요
    현재 세션에서 이 도구를 거부해 주세요.

    알아 두기세션 정책이 잠겨 있거나 모든 동작 전에 확인을 요청하는 경우에는 허용 규칙이 거부돼요.

    docs / api / agent / sessions / approvals

  • b66

    질문 답변 제안

    보조 모델이 에이전트가 멈춰 둔 질문의 답변안을 제안해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/answer:assist

    AI에 이렇게 말하세요
    에이전트가 기다리는 질문에 답변을 제안해 주세요.

    알아 두기제안은 질문의 답이 아니에요. 실제 답은 따로 보내요.

    docs / api / agent / sessions / approvals

  • b67

    실행 중인 워크플로 안내

    워크플로가 실행되는 동안 피드백을 보내요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/workflow/messages

    AI에 이렇게 말하세요
    실행 중인 워크플로가 릴리스 노트에 집중하도록 알려 주세요.

    알아 두기워크플로가 실행 중일 때만 사용하세요. 게이트가 대기 중일 때 보낸 메시지는 버려지므로, 턴이 끝난 뒤 다시 보내야 해요.

    docs / api / agent / sessions / turns

  • b68

    턴 결과 확인

    연결이 끊기거나 재시작한 뒤에도 턴의 상태와 결과를 조회해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/turns/{turn_id}

    AI에 이렇게 말하세요
    마지막 에이전트 턴이 끝났는지 확인해 주세요.

    알아 두기활성 세션과 휴면 세션 모두에서 작동해요.

    docs / api / agent / sessions / turns

  • b69

    다른 세션 기다리기

    다른 세션의 작업에서 지정한 결과가 나올 때까지 세션이 기다리게 해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/waiters

    AI에 이렇게 말하세요
    다른 세션이 빌드가 끝났다고 알릴 때까지 기다려 주세요.

    알아 두기대상은 같은 렐름(컴퓨터 묶음)의 다른 활성 세션이어야 해요. 대기자는 에이전트를 다시 시작하면 사라져요.

    docs / api / agent / sessions / waiters

  • b70

    요약 뒤 지침 재적용

    에이전트가 대화를 압축할 때마다 지정한 지침을 다시 넣어 줘요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/after-compaction

    AI에 이렇게 말하세요
    대화를 요약할 때마다 에이전트가 테스트를 실행하도록 알려 주세요.

    알아 두기최대 16KiB예요. Claude Code 세션에서는 쓸 수 없어요.

    docs / api / agent / sessions / settings

  • b71

    에이전트 작업 일시정지

    에이전트 세션을 일시정지하고, 멈춘 지점에서 다시 이어가요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/pause

    AI에 이렇게 말하세요
    계속할 준비가 될 때까지 에이전트를 일시정지해 주세요.

    알아 두기일시 중지는 모든 렐름의 모든 세션에 적용돼요. 이미 실행 중인 작업은 먼저 끝나고, 독립적으로 실행되는 일부 Claude Code 작업은 멈추지 않아요.

    docs / api / agent / system

에이전트 메모리 4

  • b72

    메모리 끄기

    에이전트의 메모리 개인정보 보호 스위치를 켜거나 꺼요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/enabled

    AI에 이렇게 말하세요
    이 렐름(컴퓨터 묶음)의 메모리를 꺼 주세요.

    docs / api / agent / memory

  • b73

    메모리 수정

    저장된 메모리 기록을 수정하고, 건드리지 않은 필드는 그대로 둬요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items/{id}

    AI에 이렇게 말하세요
    저장된 프로젝트 선호 설정을 TypeScript 사용으로 업데이트해 주세요.

    docs / api / agent / memory

  • b74

    저장된 메모리 삭제

    에이전트 메모리에서 특정 기록을 하나 또는 여러 개 삭제해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items

    AI에 이렇게 말하세요
    오래된 메모리 기록을 삭제해 주세요.

    알아 두기기록을 하나씩 삭제해도 프로젝트 요약, 관계 그래프, 통합 후 남은 데이터는 지워지지 않아요.

    docs / api / agent / memory

  • b75

    메모리 관계 보기

    프로젝트 메모리 그래프의 노드와 연결을 살펴봐요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/graph

    AI에 이렇게 말하세요
    이 프로젝트 메모리의 관계를 보여 주세요.

    docs / api / agent / memory

백그라운드 작업 9

  • b76

    루프 지금 실행

    다음 주기를 기다리지 않고 예약된 에이전트 루프를 바로 실행해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}/run-now

    AI에 이렇게 말하세요
    예약된 점검을 지금 실행해 주세요.

    알아 두기일시 중지된 루프는 한 번 실행된 뒤 계속 일시 중지 상태로 있어요. 회로 차단기로 일시 중지된 루프는 스케줄을 다시 이어 가요.

    docs / api / agent / loops

  • b77

    루프 예산 설정

    반복 실행하는 에이전트 루프의 비용과 시간 상한을 설정해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}

    AI에 이렇게 말하세요
    이 루프의 비용과 시간 예산을 설정해 주세요.

    알아 두기업데이트 한 번에 하나만 바꿀 수 있어요. 일시 중지 상태, 만료 시점, 예산 중 하나예요. 0을 넣으면 상한이 해제돼요.

    docs / api / agent / loops

  • b78

    조건에 따라 루프 중지

    반복 실행하는 에이전트 루프가 지정한 조건을 만족하면 멈추게 해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops

    AI에 이렇게 말하세요
    종료 조건을 만족할 때까지 이 점검을 반복해 주세요.

    알아 두기허용되는 최소 간격은 60초예요. max_runs를 생략하거나 0 또는 음수로 지정하면 기본 상한인 50회가 적용돼요.

    docs / api / agent / loops

  • b79

    헤드리스 실행 스트리밍

    헤드리스로 실행한 에이전트의 진행 상황을 이벤트 스트림으로 실시간 받아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/headless/runs

    AI에 이렇게 말하세요
    이 작업을 헤드리스로 실행하고 진행 상황을 스트리밍해 주세요.

    알아 두기헤드리스 실행은 확인, 계획, 질문을 자동으로 승인하고 코드를 실행할 수 있어요. 프록시 권한으로 에이전트 URL을 보호하세요.

    docs / api / agent / headless

  • b80

    에이전트 작업 취소

    대기 중이거나 실행 중인 비동기 에이전트 작업을 중지해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jobs/{id}

    AI에 이렇게 말하세요
    해당 에이전트 작업을 취소해 주세요.

    알아 두기끝난 작업을 삭제하면 그 이력도 함께 삭제돼요.

    docs / api / agent / jobs

  • b81

    하위 에이전트 기록 읽기

    백그라운드 하위 에이전트 작업의 기록과 요약을 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/transcript

    AI에 이렇게 말하세요
    백그라운드 리뷰어가 한 일을 보여 주세요.

    docs / api / agent / tasks

  • b82

    하위 에이전트 작업 취소

    세션이 작업하는 동안 백그라운드 하위 에이전트 작업 하나를 중지해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/cancel

    AI에 이렇게 말하세요
    백그라운드 조사 작업을 취소해 주세요.

    알아 두기세션이 활성 상태여야 해요.

    docs / api / agent / tasks

  • b83

    백그라운드 셸 보기와 중지

    에이전트 세션이 시작한 백그라운드 셸을 나열하고, 하나를 중지해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/bash-jobs

    AI에 이렇게 말하세요
    이 세션이 시작한 백그라운드 셸을 보여 주세요.

    docs / api / agent / tasks

  • b84

    훅 일시정지

    에이전트의 수명 주기 훅을 끄거나 다시 켜요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hooks/toggle

    AI에 이렇게 말하세요
    내 lint 훅을 꺼 주세요.

    알아 두기활성 에이전트 세션이 필요해요.

    docs / api / agent / hooks

스킬, 워크플로, 작업 10

  • b85

    기존 스킬 가져오기

    선택한 Claude 또는 Codex 스킬을 에이전트의 로컬 스킬 저장소로 가져와요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/import/apply

    AI에 이렇게 말하세요
    내 기존 Claude 스킬을 에이전트로 가져와 주세요.

    알아 두기먼저 스킬을 스캔하세요. 덮어쓰기를 요청하지 않으면 이미 있는 대상 위치는 거부돼요.

    docs / api / agent / skills

  • b86

    스킬 미리 보기

    허브의 스킬을 내 컴퓨터에 설치하기 전에 미리 봐요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/hub/preview

    AI에 이렇게 말하세요
    릴리스 노트 스킬을 설치하기 전에 미리 보여 주세요.

    알아 두기미리 보기에는 검색 결과의 제공자, 소스, 스킬 ID가 필요해요.

    docs / api / agent / skills

  • b87

    스킬 끄기

    스킬을 이름으로 비활성화하고, 필요할 때 다시 켜요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/toggle

    AI에 이렇게 말하세요
    내 웹 검색 스킬을 당분간 꺼 주세요.

    docs / api / agent / skills

  • b88

    스킬 지침 수정

    스킬 원본을 읽고 바꿔서 에이전트가 배우는 내용을 바꿔요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/source

    AI에 이렇게 말하세요
    릴리스 노트 스킬을 새 형식에 맞게 업데이트해 주세요.

    docs / api / agent / skills

  • b89

    워크플로 재개

    실패하거나 취소된 워크플로를 끝나지 않은 첫 단계부터 이어가요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}/resume

    AI에 이렇게 말하세요
    실패한 워크플로를 멈춘 지점부터 다시 이어 주세요.

    알아 두기활성 세션은 유휴 상태여야 하고, 실행의 렐름, 소유자, 작업 디렉터리, 컴퓨터와 일치해야 해요. 실행은 한 번만 재개할 수 있어요.

    docs / api / agent / workflows

  • b90

    워크플로 단계 확인

    워크플로 각 단계의 상태, 소요 시간, 토큰 사용량, 오류를 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}

    AI에 이렇게 말하세요
    해당 워크플로에서 어느 단계가 실패했는지 보여 주세요.

    알아 두기실행 기록은 보관되는 동안에만 쓸 수 있어요.

    docs / api / agent / workflows

  • b91

    작업 실행

    백그라운드 워커를 시작해 작업을 자율적으로 처리해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/run

    AI에 이렇게 말하세요
    이 작업에 워커를 시작해 주세요.

    알아 두기이 요청은 사람의 승인으로 처리되고, 워커는 더 이상 확인을 요청하지 않아요. 완료 여부는 작업 자체에서 확인하세요.

    docs / api / agent / todos

  • b92

    작업 필터링

    에이전트 목록에서 상태, 태그, 검색어로 작업을 찾아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos

    AI에 이렇게 말하세요
    결제 태그가 붙은 열린 작업을 보여 주세요.

    docs / api / agent / todos

  • b93

    작업 미루기

    깨울 시각까지 작업을 미루거나, 기존 미루기를 해제해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/snooze

    AI에 이렇게 말하세요
    이 작업을 내일까지 미뤄 주세요.

    docs / api / agent / todos

  • b94

    작업에 댓글 달기

    에이전트 턴을 새로 시작하지 않고 작업 타임라인에 댓글을 추가해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/messages

    AI에 이렇게 말하세요
    이 고객 정보를 작업에 추가해 주세요.

    docs / api / agent / todos

에이전트에서 쓰는 GitHub 6

  • b95

    리포지토리 변경 사항 검토

    리포지토리의 스테이징된 변경 사항과 스테이징되지 않은 변경 사항을 unified diff로 읽어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/diff

    AI에 이렇게 말하세요
    내 리포지토리의 스테이징된 변경 사항을 보여 주세요.

    알아 두기수집된 출력은 최대 1MiB예요.

    docs / api / agent / github

  • b96

    커밋 메시지 초안 작성

    대기 중인 리포지토리 변경 사항을 바탕으로 모델이 커밋 메시지 초안을 써요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/commit/suggest-message

    AI에 이렇게 말하세요
    내 변경 사항에 맞는 커밋 메시지를 제안해 주세요.

    알아 두기diff가 모델 제공자에게 전송되고, 호출에는 요금이 청구돼요. 커밋은 하지 않아요.

    docs / api / agent / github

  • b97

    GitHub 이슈

    에이전트에서 리포지토리 이슈를 나열하거나 새 이슈를 열어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/issues

    AI에 이렇게 말하세요
    로그인 페이지가 깨진다는 이슈를 열어 주세요.

    알아 두기이슈 목록은 최대 200개를 반환하고, 최근에 업데이트된 순으로 정렬돼요.

    docs / api / agent / github

  • b98

    연결된 워크트리

    리포지토리의 다른 브랜치에서 작업하도록 연결된 워크트리를 만들어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/worktrees

    AI에 이렇게 말하세요
    내 기능 브랜치용 워크트리를 만들어 주세요.

    docs / api / agent / github

  • b99

    GitHub 계정 전환

    에이전트가 이후 작업에 쓰는 연결된 GitHub 계정을 바꿔요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/auth/active

    AI에 이렇게 말하세요
    에이전트를 내 업무용 GitHub 계정으로 전환해 주세요.

    알아 두기계정이 이미 연결돼 있어야 해요.

    docs / api / agent / github

  • b100

    원격 브랜치 확인

    체크아웃은 그대로 두고 GitHub 브랜치가 가리키는 커밋을 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/remote-branch

    AI에 이렇게 말하세요
    마지막 푸시가 원격 브랜치에 반영됐는지 확인해 주세요.

    알아 두기사용 중인 계정으로 GitHub을 읽기만 하고, 내 체크아웃은 바꾸지 않아요.

    docs / api / agent / github

에이전트 설정 15

  • b101

    AI 지출 상한 설정

    채팅과 턴 단위로 지출 상한을 정해 작업을 멈추거나 알림을 받아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/spend-caps

    AI에 이렇게 말하세요
    내 에이전트 채팅의 지출 상한을 설정해 주세요.

    알아 두기상한은 미국 달러 기준이고, 0(꺼짐)부터 1,000,000까지 설정할 수 있어요. 이미 실행 중인 작업은 중지되지 않아요.

    docs / api / agent / settings

  • b102

    제공업체 계정 순환

    제공업체의 한 계정이 사용 한도에 도달하면 로그인해 둔 다른 계정으로 에이전트가 전환해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/features

    AI에 이렇게 말하세요
    내 에이전트에 계정 순환을 켜 주세요.

    docs / api / agent / settings

  • b103

    MCP 설정 가져오기

    Claude, Cursor, VS Code의 MCP 서버 정의를 에이전트로 가져와요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/import

    AI에 이렇게 말하세요
    Cursor의 MCP 서버 설정을 가져와 주세요.

    알아 두기가져온 서버는 비활성 상태로 시작해요. 잘못된 항목이 하나라도 있으면 가져오기 전체가 중단돼요.

    docs / api / agent / mcp

  • b104

    MCP 서버 테스트

    서버 설정을 저장하기 전에 테스트하고 도구를 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/probe

    AI에 이렇게 말하세요
    저장하기 전에 이 MCP 서버 설정을 테스트해 주세요.

    알아 두기프로브는 사람만 실행할 수 있고, 프로세스를 시작하거나 외부로 요청을 보낼 수 있어요.

    docs / api / agent / mcp

  • b105

    MCP 서버 비활성화

    저장된 설정과 자격 증명은 그대로 두고 MCP 서버 하나를 꺼요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/servers/enable

    AI에 이렇게 말하세요
    이슈 트래커 MCP 서버를 당분간 비활성화해 주세요.

    알아 두기비활성화하면 모든 활성 세션에서 서버 연결이 바로 끊겨요.

    docs / api / agent / mcp

  • b106

    렐름 전체 지침

    렐름(컴퓨터 묶음)의 채팅, 도우미, 워크플로 단계가 함께 쓰는 지침을 설정해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/agent-instructions

    AI에 이렇게 말하세요
    이 렐름의 모든 에이전트에게 미국 영어를 쓰라고 알려 주세요.

    알아 두기실행 중인 채팅에는 다음 턴부터 변경이 적용돼요.

    docs / api / agent / settings

  • b107

    에이전트 복사

    에이전트 정의를 새 이름으로 복사해서 나만의 변형을 만들어요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/copy

    AI에 이렇게 말하세요
    내 리뷰어 에이전트를 복사해서 직접 수정할 수 있게 해 주세요.

    알아 두기제품 소유 Bot 에이전트의 이름으로 복사하면 거부돼요.

    docs / api / agent / agents

  • b108

    에이전트 턴 제한 설정

    에이전트 하나가 실행당 진행하는 최대 턴 수를 설정해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/turns

    AI에 이렇게 말하세요
    내 리뷰어 에이전트에 턴 제한을 설정해 주세요.

    알아 두기이 방법으로는 Bot 에이전트를 바꿀 수 없어요.

    docs / api / agent / agents

  • b109

    에이전트 기본값 복원

    기본 제공 에이전트를 수정한 뒤 원래 정의로 복원해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/reset-to-shipped

    AI에 이렇게 말하세요
    이 에이전트를 기본값으로 되돌려 주세요.

    알아 두기초기화하면 로컬에서 바꾼 설정이 사라져요.

    docs / api / agent / agents

  • b110

    Claude 설정 복사

    내 컴퓨터 사이에서 Claude Code 설정을 미리 보고 복사해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/acp/agents/{agent}/file-syncs

    AI에 이렇게 말하세요
    내 Claude Code 설정을 다른 컴퓨터로 복사해 주세요.

    알아 두기파일은 최대 200개, 전체 8MiB, 파일당 2MiB까지예요. 자격 증명 파일과 로그인이나 대화가 담긴 상태는 제외돼요.

    docs / api / agent / settings

  • b111

    제공자 키 테스트

    저장해 둔 제공자 API 키가 유효한지 키를 노출하지 않고 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/providers/{id}/auth/test

    AI에 이렇게 말하세요
    저장해 둔 제공자 키를 테스트해 주세요.

    알아 두기판정 결과는 valid, invalid, inconclusive 중 하나예요. 키가 이미 저장돼 있어야 해요.

    docs / api / agent / models

  • b112

    계정별 사용량

    AI 사용량을 제공자와 계정별로 묶어서 전체 기간 또는 특정 날짜 이후로 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/usage/by-account

    AI에 이렇게 말하세요
    월요일부터 계정별 AI 사용량을 보여 주세요.

    알아 두기사용량은 렐름별이 아니라 전체 기준이에요. 시작 시각을 생략하면 전체 기간의 사용량을 보여 줘요.

    docs / api / agent / statistics

  • b113

    에이전트 렐름 선택

    새 세션에서 에이전트가 기본으로 쓸 렐름을 선택해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hoody/realm

    AI에 이렇게 말하세요
    새 에이전트 세션에는 업무용 렐름을 써 주세요.

    알아 두기선택은 모든 클라이언트에 적용돼요. 기존 세션은 자기 렐름을 그대로 유지하고, 렐름이 제한된 로그인은 허용된 렐름만 선택할 수 있어요.

    docs / api / agent / discovery

  • b114

    에이전트 로그 검색

    에이전트 로그를 세션, 시간, 수준, 텍스트로 필터링해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs

    AI에 이렇게 말하세요
    지난 1시간 동안 이 에이전트 세션의 오류를 찾아 주세요.

    알아 두기페이지당 최대 500개이고, 기본값은 200개예요.

    docs / api / agent / logs

  • b115

    민감 정보를 가린 로그 내보내기

    필터링한 에이전트 로그를 민감 정보를 가린 JSONL 또는 텍스트로 다운로드해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs/export

    AI에 이렇게 말하세요
    에이전트 오류를 민감 정보를 가린 텍스트 파일로 내보내 주세요.

    알아 두기내보내기에서는 민감한 정보가 항상 가려져요. 플랫폼 소스 내보내기는 한 페이지이고, 기본값은 2000행이에요.

    docs / api / agent / logs

hoody / capabilities / api

03 64 항목

API

Hoody에서 할 수 있는 일은 AI나 스크립트도 할 수 있어요.

Hoody 위에 만들기 13

  • a01

    모든 것을 API 하나로

    Hoody에서 할 수 있는 일은 AI나 스크립트도 할 수 있어요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    Hoody API로 이걸 설정해 줘요.

    docs / foundation / hoody-api

  • a02

    필요할 때 만드는 컴퓨터

    AI가 내 프로젝트에 컴퓨터를 만들고, 시작하거나 중지하거나 삭제해요.

    입력POST https://api.hoody.com/api/v1/projects/{p}/computers

    AI에 이렇게 말하세요
    이 클라이언트 프로젝트에 컴퓨터를 추가해 줘요.

    docs / foundation / computers / create-edit-delete

  • a03

    설정 복사

    컴퓨터 하나를 다른 프로젝트나 서버로 복제해요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    내 스테이징 설정을 복사해 줘요.

    알아 두기복제본에는 SSH 키가 생기지 않아요. 방화벽 규칙, 프록시 별칭, 스냅샷은 원본에 남아요.

    docs / foundation / computers / copy-sync

  • a04

    바로 쓸 수 있는 Debian 13

    컴퓨터는 Debian 13으로 시작하고, 개발 도구가 준비돼 있어요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    내 사이드 프로젝트용 새 컴퓨터를 설정해 줘요.

    docs / foundation / computers / images

  • a05

    프로젝트와 렐름(컴퓨터 묶음)

    컴퓨터를 프로젝트로 묶고, 렐름으로 토큰마다 보고 제어할 수 있는 범위를 제한해요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    이 클라이언트의 토큰은 해당 프로젝트만 볼 수 있게 해 줘요.

    docs / concepts / realms-projects

  • a06

    자동화용 토큰

    스크립트와 AI에 각자의 토큰을 주고, 필요한 범위로만 제한해요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    30일 뒤에 만료되고 내 서버 IP에서만 쓸 수 있는 배포 스크립트용 토큰을 만들어 주세요.

    docs / foundation / hoody-api / authentication

  • a07

    명령줄

    노트북에서 `hoody` 명령으로 Hoody 대부분을 실행해요.

    입력curl -fsSL https://install.hoody.com | sh

    AI에 이렇게 말하세요
    Hoody CLI를 설치하고 로그인해 줘요.

    알아 두기크론 작업을 지금 실행하는 등 일부 기능은 SDK나 HTTP API가 필요해요.

    docs / foundation / cli

  • a08

    오픈 소스 SDK

    오픈 소스 SDK로 TypeScript에서 Hoody를 기반으로 개발해요.

    입력npm install hoody-sdk

    AI에 이렇게 말하세요
    Hoody SDK로 내 컴퓨터 목록을 보여 주는 스크립트를 작성해 줘요.

    docs / getting-started / quickstart

  • a09

    어떤 AI든 읽는 매뉴얼

    AI는 매뉴얼 하나를 읽고 Hoody 사용법을 익혀요.

    링크https://hoody.com/SKILLS/

    AI에 이렇게 말하세요
    hoody.com/SKILLS를 읽고 설정해 줘요.

    알아 두기로그인하려면 AI가 네트워크에 접근할 수 있는 코드를 실행할 수 있어야 해요.

    docs / foundation / agent-skill-bundle

  • a19

    스냅샷에서 복사

    원본의 스냅샷 중 선택한 것으로 독립된 컴퓨터를 만들어요.

    링크https://api.hoody.com/api/v1/computers/{id}/copy

    AI에 이렇게 말하세요
    테스트를 마친 스냅샷으로 스테이징 컴퓨터를 만들어 주세요.

    알아 두기복사본은 원본 컴퓨터의 현재 환경 변수를 가져와요. 스냅샷 기록과 SSH 키는 복사되지 않아요.

    docs / foundation / computers / copy-sync

  • a20

    네트워크 규칙 복사

    컴퓨터의 방화벽과 네트워크 규칙을 새 복사본으로 가져가요.

    링크https://api.hoody.com/api/v1/computers/{id}/copy

    AI에 이렇게 말하세요
    스테이징 컴퓨터를 방화벽과 네트워크 규칙까지 함께 복사해 주세요.

    알아 두기규칙은 기본적으로 복사되지 않아요. 네트워크나 시작에 실패하면 복사본이 중지된 상태로 남을 수 있어요.

    docs / foundation / computers / copy-sync

  • a21

    환경 변수 병합

    다른 설정은 그대로 두고 환경 변수 여러 개를 업데이트해요.

    링크https://api.hoody.com/api/v1/computers/{id}/env

    AI에 이렇게 말하세요
    내 컴퓨터에 데이터베이스 URL과 로그 수준을 설정해 주세요.

    알아 두기요청 한 번에 변수 1~256개를 보낼 수 있어요. 실행 중인 프로세스는 다시 실행(re-exec)되기 전까지 변경을 반영하지 않아요.

    docs / api / computer-env

  • a22

    컴퓨터 상태 기록

    컴퓨터의 상태 변경을 살펴보고 예기치 않은 중지나 느린 시작을 조사해요.

    링크https://api.hoody.com/api/v1/computers/{id}/status-logs

    AI에 이렇게 말하세요
    내 컴퓨터가 언제 중지됐고 원인이 무엇인지 보여 주세요.

    docs / foundation / computers / managing

프로젝트, 토큰, 로그인 11

  • a23

    프로젝트 접근 수준

    다른 사용자에게 프로젝트의 읽기, 편집, 삭제 권한을 부여해요.

    링크https://api.hoody.com/api/v1/projects/{id}/permissions

    AI에 이렇게 말하세요
    Sam에게 내 프로젝트 읽기 권한을 주세요.

    알아 두기소유자이거나 편집 권한이 있어야 해요. 접근 설정은 바로 적용돼요.

    docs / api / projects

  • a24

    프로젝트 컴퓨터 할당량

    프로젝트를 만들거나 업데이트할 때 컴퓨터 수 제한을 설정해요.

    링크https://api.hoody.com/api/v1/projects/{id}

    AI에 이렇게 말하세요
    이 프로젝트를 컴퓨터 5대로 제한해 주세요.

    알아 두기소유자이거나 편집 권한이 있어야 해요. 최소 할당량은 0이에요.

    docs / api / projects

  • a25

    프로젝트 리소스 통계

    프로젝트에 있는 컴퓨터별 리소스 통계를 한 번의 응답으로 가져와요.

    링크https://api.hoody.com/api/v1/projects/{id}/stats

    AI에 이렇게 말하세요
    내 프로젝트에 있는 컴퓨터의 리소스 사용량을 보여 주세요.

    알아 두기통계를 읽지 못한 컴퓨터는 자리 표시용 항목이 나올 수 있어요.

    docs / api / projects

  • a26

    월별 프로젝트 트래픽

    프로젝트 전체에서 프록시를 거친 요청 수와 응답 바이트를 월별로 가져와요.

    링크https://api.hoody.com/api/v1/projects/{id}/proxy-usage

    AI에 이렇게 말하세요
    최근 3개월 동안 내 프로젝트의 프록시 트래픽을 보여 주세요.

    알아 두기최대 12개월까지 요청하세요. 합계가 불완전할 수 있고, 삭제된 컴퓨터, 직접 SSH, 원시 아웃바운드 트래픽 등 다른 트래픽은 포함되지 않아요.

    docs / api / projects

  • a27

    현재 토큰 확인

    현재 API 토큰의 권한과 렐름 제한을 확인해요.

    링크https://api.hoody.com/api/v1/auth/tokens/me

    AI에 이렇게 말하세요
    현재 토큰으로 접근할 수 있는 범위를 보여 주세요.

    docs / api / auth-tokens

  • a28

    토큰 권한 템플릿

    토큰을 만들기 전에 권한 템플릿과 실제로 적용되는 권한을 나열해요.

    링크https://api.hoody.com/api/v1/auth/tokens/templates

    AI에 이렇게 말하세요
    사용할 수 있는 토큰 권한 템플릿을 보여 주세요.

    docs / api / auth-tokens

  • a29

    토큰 권한 복사

    다른 토큰의 권한, 렐름, IP 허용 목록으로 토큰을 만들어요.

    링크https://api.hoody.com/api/v1/auth/tokens/{id}/copy

    AI에 이렇게 말하세요
    이 토큰의 제한을 새 토큰으로 복사해 주세요.

    알아 두기복사본에는 새 비밀 값이 들어가요.

    docs / api / auth-tokens

  • a30

    토큰 렐름 조정

    제한이 걸린 기존 토큰에 렐름을 추가하거나 제거해요.

    AI에 이렇게 말하세요
    이 토큰에 스테이징 렐름을 추가해 주세요.

    알아 두기렐름이 제한된 토큰의 마지막 렐름은 제거할 수 없어요.

    docs / api / auth-tokens

  • a31

    렐름별 리소스 수 세기

    렐름별로 프로젝트, 컴퓨터, 서버, 토큰의 수를 나열해요.

    링크https://api.hoody.com/api/v1/realms/?include_usage=true

    AI에 이렇게 말하세요
    내 렐름별 리소스 수를 세어 주세요.

    알아 두기이 요청에는 resources.realms 권한이 필요해요.

    docs / api / realms

  • a32

    기기 코드 로그인

    사용자가 입력할 수 있는 짧은 코드로 기기 로그인을 시작해요.

    링크https://api.hoody.com/api/v1/auth/device/code

    AI에 이렇게 말하세요
    내 앱에서 기기 코드 로그인을 시작해 주세요.

    알아 두기이 흐름은 RFC 8628에서 착안했지만, 표준을 따르는 디바이스 승인은 아니에요.

    docs / api / authentication

  • a33

    앱 신원 클레임

    Hoody가 이 사용자의 로그인을 처리했다는 사실을 앱에 증명해요. 공개 키로 오프라인에서 확인할 수 있어요.

    링크https://api.hoody.com/api/v1/users/auth/identity-claim

    AI에 이렇게 말하세요
    내 앱에 신원 클레임을 발급해 주세요.

    알아 두기로그인한 세션만 쓸 수 있고, 인증 토큰은 쓸 수 없어요. 클레임은 기본적으로 1시간 유지되고, 세션보다 오래 가지 않아요.

    docs / api / authentication

명령줄 도구 5

  • a34

    CLI 계정 프로필

    계정이나 환경에 따라 CLI 설정과 로그인을 전환해요.

    AI에 이렇게 말하세요
    스테이징용 CLI 프로필을 따로 만들어 주세요.

    docs / foundation / cli

  • a35

    CLI 요청 미리 보기

    CLI 명령이 보낼 HTTP 요청을 보거나 curl 한 줄로 받아요.

    AI에 이렇게 말하세요
    이 컴퓨터를 삭제하는 HTTP 요청을 보여 주세요.

    알아 두기비밀 값은 가려지고 일부 본문은 제공되지 않아요. 이름 조회는 여전히 GET 요청을 보낼 수 있어요.

    docs / foundation / cli

  • a36

    CLI 작업 대기

    오래 걸리는 작업이 끝날 때까지 스크립트가 기다리게 해요.

    AI에 이렇게 말하세요
    이 컴퓨터를 복사하고 복사가 끝날 때까지 기다려 주세요.

    알아 두기기본 대기 제한 시간은 10분이에요.

    docs / foundation / cli / reference

  • a37

    CLI 목록 지켜보기

    리소스가 바뀌는 동안 CLI 목록을 계속 새로 고쳐요.

    AI에 이렇게 말하세요
    내 컴퓨터 목록을 5초마다 업데이트해서 보여 주세요.

    알아 두기대화형 터미널이 필요해요. 기본 간격은 2초예요.

    docs / foundation / cli / reference

  • a38

    로컬 CLI 인증 정보 잠금

    저장된 CLI 토큰과 기본 ID를 비밀번호로 암호화해요.

    AI에 이렇게 말하세요
    저장된 내 CLI 인증 정보를 비밀번호로 보호해 주세요.

    알아 두기잠금을 켜면 저장된 계정 비밀번호가 삭제돼요.

    docs / foundation / cli / reference

에이전트 구성 요소 4

  • a39

    단발성 모델 응답

    에이전트 세션 없이 앱에서 쓸 모델 응답 하나를 JSON 또는 스트리밍으로 받아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/completions

    AI에 이렇게 말하세요
    이 텍스트에 단발성 모델 응답을 받아 주세요.

    알아 두기세션, 대화 기록, 도구 사용이 없어요. 호출마다 요금이 청구돼요.

    docs / api / agent / models

  • a40

    도구 직접 실행

    에이전트 도구를 직접 호출하고 결과를 내 애플리케이션에서 받아요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools/{name}/run

    AI에 이렇게 말하세요
    이 에이전트 도구를 호출해서 결과를 알려 주세요.

    알아 두기무언가를 바꾸는 도구는 직접 사용 설정했을 때만 실행되고, 먼저 확인을 요청할 수 있어요. 이 컴퓨터에서만 실행돼요.

    docs / api / agent / tools

  • a41

    에이전트 도구 확인

    에이전트의 기본 제공 도구를 나열하고 입력 스키마를 확인해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools

    AI에 이렇게 말하세요
    에이전트 기본 제공 도구의 입력 항목을 보여 주세요.

    docs / api / agent / tools

  • a42

    에이전트 데이터 변경 감시

    변경 알림을 스트리밍해서 앱이 영향받은 에이전트 데이터를 새로 고치게 해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/changes/stream

    AI에 이렇게 말하세요
    에이전트 데이터가 바뀌면 내 대시보드를 업데이트해 주세요.

    알아 두기토큰은 어떤 목록이 바뀌었는지만 알려 줘요. 앱이 해당 목록을 다시 읽어요.

    docs / api / agent / changes

내 앱과 AI 모델 14

  • a10

    실시간 도구 삽입

    내 페이지에 실시간 터미널, 데스크톱, 에디터, 데이터베이스를 넣어요.

    링크https://{p}-{c}-terminal-1.{node}.computers.hoody.com iframe 안에서

    AI에 이렇게 말하세요
    대시보드 페이지 안에 내 실시간 터미널을 보여 줘요.

    알아 두기다른 사람이 볼 수 있는 링크를 삽입하기 전에 프록시 권한을 설정하세요.

    docs / guides / embed-urls

  • a11

    모든 요청에서 실행되는 Exec 스크립트

    조건에 맞는 요청은 먼저 Exec 스크립트로 가요. 스크립트가 요청을 확인하거나, 바꾸거나, 직접 응답해요.

    AI에 이렇게 말하세요
    내 헤더가 없는 요청을 차단하는 검사를 추가해 줘요.

    알아 두기일치하는 경로의 WebSocket 업그레이드는 거부되므로 해당 경로는 일치 대상에서 빼세요. 훅은 500ms 후 시간 초과되며, 최대 30초까지 설정할 수 있어요.

    docs / foundation / proxy / hooks

  • a12

    링크로 쓰는 AI 모델

    API 키 없이 내 컴퓨터에서 많은 AI 모델을 호출해요.

    AI에 이렇게 말하세요
    저렴한 모델로 사진 1,000장에 태그를 달아 줘요.

    알아 두기유료 모델은 사용할 때마다 AI 잔액에서 차감되고, 무료 모델은 서버마다 한도가 있어요. OpenAI, Anthropic, Google 모델은 없어요.

    docs / foundation / hoody-ai

  • a13

    AI 호출 지켜보기

    AI 호출을 Exec 스크립트로 보내 기록하거나, 캐시하거나, 바꿔요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AI에 이렇게 말하세요
    내 앱의 AI 호출을 모두 기록해 줘요.

    docs / foundation / hoody-ai / mitm

  • a14

    음성 입력과 출력

    텍스트를 음성으로, 음성을 텍스트로 바꿔요.

    링크https://ai.hoody.com/api/v1/audio/speech · `.../audio/transcriptions`

    AI에 이렇게 말하세요
    이 글을 소리 내어 읽어서 오디오 파일로 만들어 줘요.

    알아 두기컴퓨터 안에서 서버의 음성 한도 안이면 무료예요.

    docs / foundation / hoody-ai / usage

  • a16

    무료 웹 검색

    컴퓨터의 코드에서 API 키 없이 웹을 검색할 수 있고, 서버 한도 안에서는 무료예요.

    입력POST https://ai.hoody.com/api/v1/coding_plan/search

    AI에 이렇게 말하세요
    다른 사람들이 이 오류를 어떻게 해결했는지 웹에서 검색해 주세요.

    알아 두기컴퓨터 안에서 서버의 한도 안이면 무료예요.

    docs / foundation / hoody-ai / usage

  • a17

    AI의 예/아니요 답변

    Hoody AI에 예 또는 아니요, 하나 고르기, 점수 매기기 질문을 하면 답마다 가능성이 얼마인지 알려 줘요.

    입력POST https://ai.hoody.com/api/v1/decisions

    AI에 이렇게 말하세요
    고객지원 티켓마다 급한 건지 AI가 판단하게 해 주세요.

    알아 두기컴퓨터 안에서 서버의 한도 안이면 무료예요.

    docs / foundation / hoody-ai / decisions

  • a18

    컴퓨터별 AI 스위치

    컴퓨터마다 AI를 켜거나 끄고, 각각 얼마나 썼는지 확인해요.

    AI에 이렇게 말하세요
    내 고객 컴퓨터의 AI를 꺼 주세요.

    docs / foundation / hoody-ai / security

  • a43

    특정 뷰 열기

    원하는 파일 편집기, 터미널 세션, 데이터베이스 테이블 뷰로 가는 링크를 만들어요.

    AI에 이렇게 말하세요
    users 테이블 뷰 링크를 만들어 주세요.

    알아 두기일부 보기에는 매개변수가 필요하고, 프레임 삽입을 허용하지 않는 보기는 새 탭에서 열어야 해요.

    docs / guides / embed-urls

  • a44

    API 가져오기

    다른 API의 OpenAPI 문서를 스크립트 엔드포인트로 바꿔요. 이 엔드포인트는 호출을 전달해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/sdk/import

    AI에 이렇게 말하세요
    이 API 사양을 스크립트 엔드포인트로 가져와 주세요.

    docs / kit / exec / reference

  • a45

    스크립트 API 문서화

    스크립트용 OpenAPI 사양을 생성해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/user-openapi/generate

    AI에 이렇게 말하세요
    내 스크립트의 OpenAPI 사양을 생성해 주세요.

    docs / api / exec / routing

  • a46

    서비스 응답 다시 쓰기

    서비스의 응답이 호출자에게 닿기 전에 확인하고 바꿔요.

    AI에 이렇게 말하세요
    내 앱의 응답에 헤더를 추가해 주세요.

    알아 두기훅에 일치하는 경로의 WebSocket 업그레이드는 거부돼요. 서비스 하나에는 훅을 최대 8개, 컴퓨터 한 대에는 최대 32개까지 둘 수 있어요.

    docs / foundation / proxy / hooks

  • a47

    방문자 IP 확인

    Hoody 링크로 접속하는 앱에서 방문자의 실제 IP 주소를 읽어요.

    AI에 이렇게 말하세요
    내 앱의 접속 로그에 방문자 IP를 표시해 주세요.

    알아 두기프록시 훅이 요청을 전달하면, 앱에는 대신 훅의 연결 주소가 보여요.

    docs / foundation / proxy

  • a48

    방문자 네트워크 조회

    방문자의 공개 IPv4 주소로 국가와 네트워크 정보를 조회해요.

    링크https://api.hoody.com/api/v1/ip/lookup?ip={ips}

    AI에 이렇게 말하세요
    이 방문자 IP의 국가를 보여 주세요.

    알아 두기조회 한 번에 공개 IPv4 주소를 최대 25개까지 넣을 수 있어요. Hoody에 데이터가 없는 주소는 null을 반환해요.

    docs / foundation / proxy

Hoody AI 모델 8

  • a49

    모델 카탈로그 둘러보기

    사용할 수 있는 모델을 컨텍스트 길이, 모달리티, 현재 가격과 함께 나열해요.

    링크https://api.hoody.com/api/v1/ai/models

    AI에 이렇게 말하세요
    사용할 수 있는 AI 모델과 컨텍스트 길이를 나열해 주세요.

    알아 두기카탈로그는 캐시돼요. OpenAI, Anthropic, Google 모델은 제외돼요.

    docs / api / ai-models

  • a50

    모델 답변 스트리밍

    모델이 답변을 생성하는 대로 사용자에게 텍스트를 보여 줘요.

    AI에 이렇게 말하세요
    답변을 내 채팅 앱으로 스트리밍해 주세요.

    알아 두기AI를 켠 컴퓨터 안에서 호출하세요.

    docs / foundation / hoody-ai / usage

  • a51

    코딩 어시스턴트 연결

    내 컴퓨터의 Cline, Cursor, Windsurf가 Hoody AI를 쓰도록 연결해요.

    AI에 이렇게 말하세요
    내 컴퓨터의 Cline을 Hoody AI에 연결해 주세요.

    알아 두기도구는 컴퓨터 안에서 실행해야 해요. Cursor Tab 자동 완성은 계속 Cursor 내장 모델을 사용해요.

    docs / foundation / hoody-ai

  • a52

    모델 도구 호출 사용

    지원하는 모델이 쓸 수 있도록 채팅 요청에 도구 정의를 함께 보내요.

    AI에 이렇게 말하세요
    내 모델이 날씨 함수를 호출하게 해 주세요.

    알아 두기답변하는 모델이 도구를 지원할 때 작동해요. AI를 켠 컴퓨터 안에서 호출하세요.

    docs / foundation / hoody-ai / models

  • a53

    스크린샷으로 판단

    스크린샷에 대해 예 또는 아니요로 답할 수 있는 질문을 Hoody AI에 해요. 예를 들어 페이지가 깨졌는지 물어봐요.

    AI에 이렇게 말하세요
    이 결제 화면 스크린샷이 깨져 보이는지 확인해 주세요.

    알아 두기PNG, JPEG, WebP, GIF를 쓸 수 있고, 요청 하나에 이미지 최대 4개, 디코딩 후 각 1MiB까지예요. 원격 이미지 URL은 거부돼요.

    docs / foundation / hoody-ai / decisions

  • a54

    내가 고른 모델로 판단

    예 또는 아니요, 하나 고르기, 점수 매기기 질문을 에이전트에 맡기면 내가 고른 모델이 답해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jev/decide

    AI에 이렇게 말하세요
    에이전트에게 내가 설정한 모델로 이 티켓을 분류해 달라고 해 주세요.

    알아 두기다른 제공업체의 모델에는 그 제공업체의 키가 필요해요.

    docs / foundation / hoody-ai / decisions

  • a55

    무료 AI 허용량 확인

    서버별 무료 AI 허용량 중 내 계정이 대략 얼마나 썼는지 확인해요.

    링크https://api.hoody.com/api/v1/users/me/free-ai-usage

    AI에 이렇게 말하세요
    서버별 무료 AI 사용량을 보여 주세요.

    알아 두기측정값은 대략적이에요. 인증 토큰에는 `computers.read`가 필요하고, 렐름으로 제한된 토큰은 `403`을 받아요.

    docs / foundation / hoody-ai / models

  • a56

    AI 사용 기록 삭제

    선택한 시점보다 오래된 컴퓨터의 AI 사용 기록을 삭제해요.

    AI에 이렇게 말하세요
    이 컴퓨터의 1월 이전 AI 사용 기록을 삭제해 주세요.

    알아 두기삭제는 호출한 컴퓨터에만 적용돼요. 처리 중인 요청의 행은 삭제되지 않아요.

    docs / foundation / hoody-ai / security / reference

음성과 오디오 5

  • a57

    일반 오디오 형식 텍스트 변환

    WAV, MP3, WebM, OGG, M4A, FLAC 녹음을 텍스트로 바꿔요. 업로드하거나 base64로 보낼 수 있어요.

    AI에 이렇게 말하세요
    이 M4A 음성 메모를 텍스트로 바꿔 주세요.

    알아 두기오디오는 최대 25MB(25,000,000바이트), 600초까지예요. 오디오 URL은 거부돼요. 컴퓨터 안에서 작동해요.

    docs / foundation / hoody-ai / models / reference

  • a58

    음성 선택

    음성 네 가지 중 하나를 골라 텍스트를 PCM 또는 MP3 오디오로 받아요.

    AI에 이렇게 말하세요
    이 메모를 Bella 음성으로 읽어서 MP3로 만들어 주세요.

    알아 두기텍스트는 4,096자까지예요. Hoody Voice는 컴퓨터 안에서 해당 서버의 음성 한도 안에서 작동해요.

    docs / foundation / hoody-ai / models / reference

  • a59

    음성 오디오 스트리밍

    생성된 음성을 만들어지는 대로 앱으로 스트리밍해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/speech/stream

    AI에 이렇게 말하세요
    음성 답변을 내 앱으로 스트리밍해 줘요.

    알아 두기음성을 스트리밍하는 모델에만 해당돼요.

    docs / api / agent / audio

  • a60

    전사본에 타임스탬프 추가

    구간과 시간 정보가 있으면 함께 담긴 전사본을 요청해요.

    AI에 이렇게 말하세요
    이 녹음을 구간별 타임스탬프와 함께 텍스트로 변환해 줘요.

    알아 두기오디오는 25MB(25,000,000바이트), 600초까지예요. 세그먼트 필드는 없거나 null일 수 있어요.

    docs / foundation / hoody-ai / models / reference

  • a61

    음성 모델 찾기

    음성 모델 목록을 불러와 전사 또는 음성 기능으로 필터링해요.

    링크https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/models

    AI에 이렇게 말하세요
    내 에이전트가 쓸 수 있는 음성 텍스트 변환 모델을 보여 줘요.

    알아 두기목록에 있는 모델도 호출에 쓸 수 없을 수 있어요.

    docs / api / agent / audio

AI 요청 프록시 4

  • a62

    위험한 AI 요청 검토

    사람이 승인하거나 거부할 때까지 프록시에서 AI 요청을 보류해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AI에 이렇게 말하세요
    위험한 AI 요청은 내가 승인할 때까지 보류해 줘요.

    알아 두기승인 스크립트와 거부 스크립트는 직접 추가해야 해요. 없으면 보류된 요청은 408로 끝나요.

    docs / foundation / hoody-ai / mitm

  • a63

    프롬프트에 지식 추가

    프록시 스크립트로 지식 베이스 검색 결과를 프롬프트에 추가해요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AI에 이렇게 말하세요
    관련 회사 문서를 AI 프롬프트마다 추가해 줘요.

    알아 두기공유하기 전에 스크립트 토큰과 프록시 권한으로 프록시를 보호하세요.

    docs / foundation / hoody-ai / mitm

  • a64

    다른 제공업체로 전달

    프록시 스크립트로 AI 요청을 선택한 제공업체로 보내요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AI에 이렇게 말하세요
    이 앱의 AI 요청을 내 제공업체로 보내 줘요.

    알아 두기제공업체 키와 프록시 보안은 직접 관리해야 해요.

    docs / foundation / hoody-ai / mitm

  • a65

    AI 도구 호출 바꾸기

    클라이언트가 실행하기 전에 프록시에서 모델의 도구 호출을 바꿔요.

    링크https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AI에 이렇게 말하세요
    AI의 파일 쓰기를 내 검토 폴더로 돌려 줘요.

    알아 두기재작성은 라우팅일 뿐 격리가 아니에요. 제한은 호출을 실행하는 도구에서 적용하세요.

    docs / foundation / hoody-ai

hoody / capabilities / across

04 58 항목

모든 기능 공통

어떤 방법으로 들어와도 똑같이 적용되는 내용이에요.

링크, 공유, 안전 12

  • x01

    모든 것이 URL

    도구, 파일, 앱, Bot마다 고유한 링크가 있어요.

    링크https://{p}-{c}-<kit>-1.{node}.computers.hoody.com

    AI에 이렇게 말하세요
    링크를 보내 줘요.

    docs / concepts / everything-is-a-url

  • x02

    실시간으로 함께 작업

    링크를 공유하면 같은 터미널, 데스크톱, 에디터에서 동시에 작업해요.

    AI에 이렇게 말하세요
    Sam과 같이 고칠 수 있게 내 터미널을 공유해 줘요.

    알아 두기링크에 ?sharing=true&steal=false가 없으면, 데스크톱에 들어온 두 번째 사람이 첫 번째 사람에게서 제어권을 가져가요.

    docs / guides / multiplayer

  • x03

    사람과 AI가 함께

    사람과 AI가 같은 도구에서 나란히 작업해요. 어떤 조합이든 괜찮아요.

    AI에 이렇게 말하세요
    내가 지켜보는 동안 AI가 같은 데스크톱에서 작업하게 해 줘요.

    docs / guides / multiplayer

  • x04

    스냅샷과 되돌리기

    컴퓨터 저장 공간의 스냅샷을 만들고 한 번에 복원해요.

    링크https://api.hoody.com

    AI에 이렇게 말하세요
    바꾸기 전에 스냅샷부터 만들어 줘요.

    알아 두기같은 서버에 있는 되돌리기 지점이며 백업이 아니에요. 컴퓨터를 삭제하면 함께 삭제돼요. 복원하면 현재 저장 공간이 교체되고 이후 변경은 사라져요. 마운트된 스토리지와 실행 중인 프로세스는 저장되지 않아요.

    docs / concepts / snapshots

  • x05

    비공개 링크

    생성된 링크는 추측하기 어렵지만, 열린 링크는 유출될 수 있고 링크를 얻은 사람은 누구나 쓸 수 있어요. 짧은 링크는 추측될 수 있어요. 제대로 접근을 제어하려면 어떤 링크든 잠그세요.

    AI에 이렇게 말하세요
    이 링크는 비공개인가요?

    docs / concepts / security

  • x06

    모든 링크 잠그기

    내 컴퓨터 링크에 비밀번호, 로그인 또는 IP 목록을 추가한 뒤, 그룹이 열 수 있는 프로그램을 골라요.

    AI에 이렇게 말하세요
    공유하기 전에 내 데스크톱 링크에 비밀번호를 걸어 줘요.

    docs / foundation / proxy / permissions

  • x07

    무슨 일이 있었는지 확인

    로그인 기록, 인증된 내 API 호출과 사용한 토큰, 컴퓨터별로 처리한 트래픽을 확인해요.

    AI에 이렇게 말하세요
    이번 주에 내 AI의 토큰이 보낸 API 호출을 보여 주세요.

    docs / concepts / auditing

  • x08

    암호화된 보관함

    비밀번호와 키를 보관함에 저장하고, 항목마다 암호화를 켜요.

    AI에 이렇게 말하세요
    내 Stripe 키를 보관함에 저장해 줘요.

    docs / kit / agent / reference

  • x23

    암호화된 디스크

    모든 Hoody 서버에서 컴퓨터 디스크에 저장된 데이터는 암호화돼요.

    AI에 이렇게 말하세요
    내 컴퓨터 디스크는 암호화돼 있나요?

    알아 두기디스크 암호화는 실행 중인 서버의 데이터를 보호하지 않아요.

    docs / concepts / security

  • x24

    URL 접근 일시 중지

    사고를 조사하는 동안 컴퓨터 URL로 들어오는 새 요청을 차단해요.

    링크https://api.hoody.com/api/v1/computers/{c}/proxy/permissions/state

    AI에 이렇게 말하세요
    이 컴퓨터의 URL 접근을 일시 중지해 줘요.

    알아 두기적용되는 데 몇 초 이상 걸릴 수 있어요. SSH와 이미 연결된 WebSocket 또는 CONNECT 터널은 열린 채로 유지돼요.

    docs / concepts / security

  • x25

    만료되는 스냅샷

    컴퓨터 스냅샷이 정한 일수 뒤에 만료되도록 설정해요.

    링크https://api.hoody.com/api/v1/computers/{id}/snapshots

    AI에 이렇게 말하세요
    배포 전 스냅샷을 만들고 30일 뒤에 만료되게 해 줘요.

    알아 두기만료 기간은 1~3650 사이의 정수 일수예요. 생성에 성공해도 값이 null일 수 있으니 나중에 `expires_at`을 확인하세요.

    docs / foundation / computers / snapshots

  • x26

    스냅샷에 라벨 붙이기

    스냅샷 라벨을 바꿔 정상 작동이 확인된 컴퓨터 상태를 표시해요.

    링크https://api.hoody.com/api/v1/computers/{id}/snapshots/{name}/alias

    AI에 이렇게 말하세요
    그 스냅샷에 테스트를 마친 릴리스라고 라벨을 붙여 줘요.

    알아 두기별칭은 최대 100자까지 쓸 수 있어요. 별칭을 바꿔도 스냅샷 이름은 바뀌지 않아요.

    docs / foundation / computers / snapshots

링크 접근 규칙 8

  • x27

    Hoody 사용자만

    로그인한 Hoody 사용자나 지정한 사용자 ID만 내 서비스를 호출하게 해요.

    AI에 이렇게 말하세요
    로그인한 Hoody 사용자만 내 API를 호출하게 해 줘요.

    알아 두기호출하는 쪽이 서명된 Hoody 신원 클레임을 헤더에 담아 보내요. 허용 목록에는 사용자 ID를 최대 256개까지 담을 수 있어요.

    docs / api / proxy-permissions

  • x28

    파트너 액세스 토큰

    헤더, 쿠키 또는 쿼리 파라미터에 담긴 토큰으로 파트너에게 접근을 허용해요.

    AI에 이렇게 말하세요
    파트너에게 API 토큰을 발급해 줘요.

    알아 두기그룹에는 프로그램 권한 부여가 있어야 하고, 어느 그룹에도 맞지 않는 호출자에게는 기본 정책이 계속 적용돼요.

    docs / foundation / proxy / permissions

  • x29

    앱용 JWT 접근

    앱이 발급한 토큰으로 앱 사용자가 선택한 서비스를 열 수 있게 해요.

    AI에 이렇게 말하세요
    내 앱의 서비스에는 앱의 JWT를 요구해 줘요.

    알아 두기그룹에는 프로그램 권한 부여가 있어야 하고, 어느 그룹에도 맞지 않는 호출자에게는 기본 정책이 계속 적용돼요.

    docs / foundation / proxy / permissions

  • x30

    새 서비스 보호

    기본값을 거부로 설정하면 나중에 추가한 프로그램은 접근을 허용하기 전까지 닫혀 있어요.

    AI에 이렇게 말하세요
    새 서비스는 내가 접근을 허용하기 전까지 닫아 줘요.

    알아 두기그룹을 먼저 설정하세요. allow 정책에서는 새 프로그램이 처음부터 열려 있어요.

    docs / foundation / proxy / permissions

  • x31

    프로젝트 전체 URL 규칙

    URL 접근 규칙을 프로젝트 전체에 적용하고, 컴퓨터마다 덮어쓸 수 있어요.

    AI에 이렇게 말하세요
    팀 접근 정책을 이 프로젝트에 적용해 줘요.

    알아 두기겹치는 값은 컴퓨터 값이 우선하고, 컴퓨터가 지정하지 않은 프로젝트 그룹은 그대로 적용돼요.

    docs / foundation / proxy / permissions

  • x32

    선택한 앱 포트 허용

    접근 그룹에 HTTP 또는 HTTPS 앱의 특정 포트를 허용해요.

    AI에 이렇게 말하세요
    파트너 그룹이 포트 8080에 접속하게 해 줘요.

    알아 두기셀 하나는 포트를 최대 16,384개까지 열어요. 권한을 부여하면 그 포트에서 수신 대기하는 모든 것이 열려요.

    docs / foundation / proxy / permissions

  • x33

    터미널 인스턴스 선택

    그룹에 컴퓨터의 특정 터미널 인스턴스 접근을 허용해요.

    AI에 이렇게 말하세요
    팀이 터미널 1번과 2번을 쓰게 해 줘요.

    알아 두기맞는 규칙이 없는 호출자를 막으려면 기본 거부 정책을 설정하세요.

    docs / foundation / proxy / permissions

  • x34

    서비스 접근 확인

    서비스의 그룹 접근, 훅, 실제로 적용되는 기본값을 한 번에 확인해요.

    링크https://api.hoody.com/api/v1/computers/{id}/proxy/services/{service}

    AI에 이렇게 말하세요
    내 터미널의 접근 규칙을 보여 줘요.

    docs / api / proxy-discovery

접속 방법 7

  • x09

    @hoody.com이라고 말하기

    시작하려면 AI에게 “@https://hoody.com Connect to Hoody”라고 말하세요.

    입력@https://hoody.com

    AI에 이렇게 말하세요
    @https://hoody.com Connect to Hoody

    알아 두기로그인하려면 AI가 네트워크에 접근할 수 있는 코드를 실행할 수 있어야 해요.

    docs / getting-started / quickstart

  • x10

    ssh hoody.com

    아무 터미널에서 `ssh hoody.com`을 입력하세요. 클릭하면 브라우저에서 열려요.

    입력ssh hoody.com · `https://ssh.hoody.com`

    AI에 이렇게 말하세요
    터미널에서 어떻게 접속하나요?

    docs / foundation / cli

  • x11

    어떤 브라우저에서든 열기

    아무 기기에서나 hub.hoody.com에 로그인하면 Hub가 열려요. 내 컴퓨터와 에이전트가 들어 있어요.

    링크https://hub.hoody.com

    AI에 이렇게 말하세요
    브라우저에서 내 Hoody를 열어 줘요.

    docs / kit / agent

  • x12

    휴대폰 우선

    휴대폰에서 모든 기능을 쓰고, 만든 것을 앱으로 설치해요.

    AI에 이렇게 말하세요
    이 대시보드를 내 휴대폰에 설치할 수 있게 만들어 줘요.

    docs / vision / embeddability

  • x13

    나만의 OS 만들기

    일반 HTML로 나만의 웹 데스크톱이나 전체 워크플로를 만들어요.

    AI에 이렇게 말하세요
    터미널, 메모, 사이트를 올린 홈 화면을 만들어 줘요.
  • x35

    터미널의 Hub

    대화형 터미널에서 내 계정의 Hub를 전체 화면으로 열어요.

    AI에 이렇게 말하세요
    터미널에서 내 Hub를 열어 줘요.

    알아 두기독립형 터미널 Hub는 Linux x64와 arm64용으로 제공되며, 컴퓨터 안이나 호스팅 CLI에서도 쓸 수 있어요. npm 버전은 Node.js 26 이상이 필요해요.

    docs / foundation / cli

  • x36

    샘플 계정 체험

    로그인 없이 샘플 계정으로 터미널 Hub를 둘러봐요.

    AI에 이렇게 말하세요
    Hub의 샘플 계정을 열어 줘요.

    알아 두기터미널 Hub에는 대화형 터미널이 필요해요.

    docs / foundation / cli

내 AI, 내 요금제 6

  • x14

    내 ChatGPT 또는 Claude 요금제

    ChatGPT 요금제를 쓰거나, Claude Code로 Claude 요금제를 쓰거나, 무료 내장 AI를 쓰세요.

    AI에 이렇게 말하세요
    내 ChatGPT 요금제로 로그인해 줘요.

    알아 두기Claude 요금제는 컴퓨터에서 Claude Code를 통해 사용해요. Claude Code 자체 계정으로 로그인해요. 새 Hub 대화에 적용되고 Bot에는 적용되지 않아요.

    docs / kit / agent

  • x15

    Hoody AI (무료)

    키나 설정 없이 컴퓨터 안에서 쓰는 무료 내장 AI예요.

    AI에 이렇게 말하세요
    우선 무료 모델을 써 줘요.

    알아 두기한도는 서버마다 적용되고, 서버의 모든 컴퓨터가 함께 써요.

    docs / foundation / hoody-ai / models

  • x16

    AI를 바꿔도 모두 그대로

    AI는 언제든 바꿀 수 있어요. 파일, 프로젝트, 기억, 작업은 그대로 남아요.

    AI에 이렇게 말하세요
    내 작업을 새 AI로 옮겨 줘요.
  • x17

    Free로 시작

    무료로 시작해요. 무료 서버 1대와 계속 실행되는 컴퓨터 최대 3대가 포함되고, 만료되지 않아요.

    AI에 이렇게 말하세요
    Free 요금제로 설정해 줘요.

    알아 두기자격이 되는 계정당 무료 서버 1대이며, 무료 용량이 남아 있는 동안만 제공돼요.

    docs / foundation / pricing

  • x18

    성과가 나면 확장

    더 많은 자원이 필요하면 Plus나 Pro 서버를 추가하거나, Bare metal 서버를 통째로 빌려요.

    AI에 이렇게 말하세요
    이 프로젝트용으로 더 큰 서버를 임대해 줘요.

    알아 두기무료 서버는 기존 상태 그대로 업그레이드할 수 없어요. 유료 서버는 월 10달러부터예요.

    docs / foundation / pricing

  • x19

    원하는 방식으로 결제

    카드나 암호화폐로 결제하고, 팀과 역할별로 서버를 공유해요.

    AI에 이렇게 말하세요
    암호화폐로 잔액을 충전해 줘요.

    docs / foundation / billing

서버와 요금제 9

  • x37

    리전별 서버 찾기

    임대하기 전에 위치, 사양, 가격으로 이용 가능한 서버를 필터링해요.

    AI에 이렇게 말하세요
    유럽 사용자와 가까운 서버를 찾아 줘요.

    알아 두기임대는 하루부터 시작해요. 가격은 상품과 임대 기간에 따라 달라요.

    docs / foundation / servers

  • x38

    판매 중인 요금제 보기

    판매 중인 유료 서버 요금제를 짧은 링크와 Bot URL 한도와 함께 나열해요.

    링크https://api.hoody.com/api/v1/subserver-plans

    AI에 이렇게 말하세요
    판매 중인 유료 서버 요금제를 보여 줘요.

    알아 두기구매 견적에서 그 시점에 요금제를 구매할 수 있는지 알려 줘요.

    docs / foundation / pricing

  • x39

    Plus에서 Pro로 업그레이드

    Plus 서버를 ID와 데이터는 그대로 두고 Pro로 업그레이드해요.

    AI에 이렇게 말하세요
    내 Plus 서버를 Pro로 업그레이드해 줘요.

    알아 두기업그레이드하면 현재 기간의 남은 기간만큼 차액이 청구돼요. 실행 중인 컴퓨터는 다시 시작되고, 중지된 컴퓨터는 중지된 상태로 있어요.

    docs / foundation / pricing

  • x40

    서버 요금제 견적 확인

    구매하기 전에 유료 서버 요금제의 현재 가격과 이용 가능한 수량을 확인해요.

    링크https://api.hoody.com/api/v1/subserver-subscriptions/quote

    AI에 이렇게 말하세요
    Plus 서버 요금제의 현재 가격을 알려 줘요.

    docs / api / servers

  • x41

    무료 서버 신청 자격 확인

    내 계정이 무료 서버를 받을 수 있는지, 받을 수 없다면 이유가 무엇인지 확인해요.

    링크https://api.hoody.com/api/v1/users/me/free-tier-status

    AI에 이렇게 말하세요
    내 계정으로 무료 서버를 받을 수 있나요?

    알아 두기엔드포인트는 상태만 알려 주고 서버를 할당하지 않아요. 인증 토큰에는 resources.read_account 권한이 필요해요.

    docs / api / users

  • x42

    서버 갱신 설정

    유료 서버의 자동 갱신을 켜거나 꺼요.

    링크https://api.hoody.com/api/v1/subserver-subscriptions/{id}/auto-renew

    AI에 이렇게 말하세요
    이 서버의 자동 갱신을 꺼 줘요.

    알아 두기계정 소유자 또는 인증 토큰만 켤 수 있어요. 끄면 서버가 결제한 기간이 끝날 때 중지될 수 있어요.

    docs / api / servers

  • x43

    서버 임대 연장

    API로 기존 서버 임대에 일수를 추가해요.

    링크https://api.hoody.com/api/v1/rentals/{id}/extend

    AI에 이렇게 말하세요
    내 서버 임대를 30일 연장해 줘요.

    알아 두기추가 일수는 1~3650이고 서버 가격과 맞아야 해요.

    docs / api / servers

  • x44

    제안된 서버 예약

    재고가 없는 서버를 지출 상한과 함께 예약해 인도받아요.

    링크https://api.hoody.com/api/v1/offers/{id}/reserve

    AI에 이렇게 말하세요
    이 서버 제안을 30일간 예약해 줘요.

    알아 두기예약은 즉시 청구돼요. 유료 예약에는 최대 청구액과 멱등성 키가 필요해요.

    docs / api / servers

  • x45

    Bare metal 서버 명령

    API로 임대한 Bare metal 서버의 가동 시간이나 메모리를 확인하거나 재부팅해요.

    링크https://api.hoody.com/api/v1/servers/{serverId}/execute-command

    AI에 이렇게 말하세요
    내 Bare metal 서버의 가동 시간을 확인해 줘요.

    알아 두기기본 제공 명령만, 현재 활성 임대 중인 전용 Bare metal 서버에서 쓸 수 있어요.

    docs / api / server-management

내 계정 12

  • x20

    2단계 인증 로그인

    인증 앱과 백업 코드로 내 계정을 보호해요.

    AI에 이렇게 말하세요
    내 계정에 2단계 인증 로그인을 켜 주세요.

    docs / api / authentication

  • x21

    추천 크레딧 받기

    추천 링크를 공유하면, 초대한 사람이 결제할 때 서버 크레딧을 받아요.

    AI에 이렇게 말하세요
    내 Hoody 추천 링크를 알려 주세요.

    알아 두기카드나 암호화폐로 서버 요금을 결제하면 열려요. 크레딧은 60일 보류 후 지급되고, 고객당 12개월 동안 받을 수 있으며, 서버 요금에만 쓸 수 있어요.

    docs / foundation / wallet / referral-program

  • x22

    고객지원 티켓

    CLI나 API로 고객지원 티켓을 열고 답변을 확인해요.

    링크https://api.hoody.com/api/v1/support/tickets

    AI에 이렇게 말하세요
    내 컴퓨터가 시작되지 않는 문제로 고객지원 티켓을 열어 주세요.

    docs / foundation / support

  • x46

    세션 하나 로그아웃

    다른 세션은 유지한 채 잊고 있던 기기 하나만 로그아웃해요.

    링크https://api.hoody.com/api/v1/users/auth/sessions/{id}

    AI에 이렇게 말하세요
    예전 노트북의 세션을 로그아웃해 줘요.

    알아 두기내 로그인 세션에서만 호출할 수 있어요. 세션을 종료해도 그 세션에서 만든 토큰은 삭제되지 않아요.

    docs / api / authentication

  • x47

    다른 기기 로그아웃

    현재 로그인은 유지한 채 다른 계정 세션을 모두 종료해요.

    링크https://api.hoody.com/api/v1/users/auth/sessions/revoke-others

    AI에 이렇게 말하세요
    내 다른 기기를 모두 로그아웃해 줘요.

    알아 두기내 로그인 세션에서만 호출할 수 있어요. 여러 세션을 종료해도 그 세션들에서 만든 토큰은 삭제되지 않아요.

    docs / api / authentication

  • x48

    백업 코드 교체

    기존 2단계 인증 백업 코드가 노출됐다면 새 코드를 만들어요.

    링크https://api.hoody.com/api/v1/users/auth/2fa/backup-codes/regenerate

    AI에 이렇게 말하세요
    내 계정의 2단계 인증 백업 코드를 새로 만들어 줘요.

    알아 두기비밀번호와 현재 OTP 코드가 필요해요. 기존 백업 코드는 무효가 돼요.

    docs / api / authentication

  • x49

    거부된 로그인 검토

    계정 보안 기록을 볼 때 실패한 로그인 시도도 포함해요.

    링크https://api.hoody.com/api/v1/users/me/security-history?include_failed=true

    AI에 이렇게 말하세요
    내 계정에서 거부된 로그인 시도를 보여 줘요.

    알아 두기API 토큰에는 resources.read_account가 필요해요. 계정 감사 기록은 180일 동안 보관돼요.

    docs / concepts / auditing

  • x50

    계정 이메일 변경

    새 계정 이메일을 요청하고 새 주소로 확인해요.

    링크https://api.hoody.com/api/v1/users/me/email-change

    AI에 이렇게 말하세요
    내 계정의 이메일 주소를 바꿔 줘요.

    알아 두기내 로그인 세션과 현재 비밀번호가 필요하고, 2단계 인증을 켰다면 인증 코드도 필요해요. 확인 링크는 24시간 동안 유효해요.

    docs / api / users

  • x51

    고객지원 답변 알림

    고객지원이 티켓에 답변하면 앱 안에서 알림을 받아요.

    AI에 이렇게 말하세요
    고객지원이 답변하면 알려 줘요.

    알아 두기한 티켓에 답변이 여러 개 달리면 알림 하나로 묶일 수 있고, 티켓당 알림은 10분에 최대 한 번이에요. 알림만으로는 어떤 티켓인지 알 수 없어요.

    docs / foundation / support

  • x52

    커스텀 추천 코드

    Hoody에 초대하는 사람들을 위해 기억하기 쉬운 추천 코드를 만들어요.

    링크https://api.hoody.com/api/v1/referrals/me/codes

    AI에 이렇게 말하세요
    alex-builds라는 추천 코드를 만들어 줘요.

    알아 두기동시에 활성 상태인 맞춤 코드는 최대 3개, 계정 전체로는 통틀어 최대 10개까지 만들 수 있어요. 만들려면 로그인 세션과 추천 프로그램 회원 자격이 필요해요.

    docs / foundation / wallet / referral-program

  • x53

    추천 수익 확인

    추천 코드, 레벨, 건수, 크레딧 합계를 확인해요.

    링크https://api.hoody.com/api/v1/referrals/me

    AI에 이렇게 말하세요
    내 추천 레벨과 크레딧 합계를 보여 줘요.

    알아 두기추천받은 사람의 이름과 계정 정보는 표시되지 않아요. 인증 토큰에는 financial.wallet.read가 필요하고, 렐름으로 제한되어 있으면 안 돼요.

    docs / foundation / wallet / referral-program

  • x54

    추천 크레딧 출금

    Creator 레벨에서는 사용 가능한 추천 크레딧을 고객지원에 요청해 현금으로 받을 수 있어요.

    AI에 이렇게 말하세요
    고객지원에 추천 크레딧 출금을 문의해 줘요.

    알아 두기기본값은 꺼짐이고, 고객지원이 요청마다 확인해요. 경우에 따라 은행 송금이나 암호화폐로 처리해요. 보류 중인 크레딧은 출금할 수 없어요.

    docs / foundation / wallet / referral-program

잔액과 청구서 4

  • x55

    모든 잔액 확인

    일반 잔액, 추천 크레딧, AI 잔액을 한 번의 호출로 확인해요.

    링크https://api.hoody.com/api/v1/wallet/balances

    AI에 이렇게 말하세요
    내 Hoody 잔액을 모두 보여 줘요.

    알아 두기로그인 세션이나 해당 권한이 있는 계정 전체 인증 토큰을 쓰세요. 렐름으로 제한된 토큰은 잔액을 읽을 수 없어요.

    docs / foundation / billing

  • x56

    지갑 거래 내역 검토

    결제, 청구, 이체, 환불을 거래 내역 한 곳에서 확인해요.

    링크https://api.hoody.com/api/v1/wallet/transactions

    AI에 이렇게 말하세요
    최근 Hoody 청구와 환불 내역을 보여 줘요.

    알아 두기로그인 세션이나 해당 권한이 있는 계정 전체 인증 토큰을 쓰세요. 렐름으로 제한된 토큰은 거래 내역을 읽을 수 없어요.

    docs / foundation / billing

  • x57

    청구서 PDF 다운로드

    회계, 세금 신고, 고객 청구에 쓸 청구서를 PDF로 다운로드해요.

    링크https://api.hoody.com/api/v1/wallet/invoices/{id}/pdf

    AI에 이렇게 말하세요
    가장 최근 청구서의 PDF를 다운로드해 줘요.

    알아 두기로그인 세션이나 해당 권한이 있는 계정 전체 인증 토큰을 쓰세요. 렐름으로 제한된 토큰은 청구서를 읽을 수 없어요.

    docs / foundation / billing

  • x58

    결제 확인

    intent ID로 카드 또는 암호화폐 결제를 조회해요.

    AI에 이렇게 말하세요
    내 암호화폐 충전이 반영됐는지 확인해 줘요.

    알아 두기결제 조회에는 로그인 세션이 필요해요. 인증 토큰은 거부돼요.

    docs / foundation / billing

2021년부터

프라이버시에서 에이전트 인프라로

hoody / kit

컴퓨터에 기본으로 들어 있는 것

서비스마다 고유한 링크가 있어요. 열거나, 공유하거나, AI에게 넘기세요. 링크를 아는 사람은 잠그기 전까지 누구나 열 수 있어요. Kit 링크 형태는 다음과 같아요. https://{p}-{c}-<kit>-1.{node}.computers.hoody.com 여기서 {p} 자리는 내 프로젝트, {c} 자리는 내 컴퓨터 중 하나, {node} 자리는 컴퓨터의 서버예요.

컴퓨터

Bots

API