Skip to content
Your AI@https://hoody.com Connect to Hoody
hoody / capabilities

Everything Hoody can do

What Hoody can do.
Five ideas, 500 rows.

Hoody is a few ideas, used many times. Start with the five ideas, then go through the building blocks in plain English: 500 rows in 52 groups. Each row says what to tell your AI. Most rows also include what to know before you rely on it and a link to the docs. Your AI combines them into more.

Link to a row with its id, for example /capabilities/#c120. Use your browser's find to search the page.

hoody / capabilities / ideas

Before the list

Five ideas behind every row.

The list is long. The ideas are few. Each row below is one of these five at work.

Your AI

The thinking and talking.

Hoody AI is free and built in. Or use your ChatGPT or Claude plan, or another AI.

Hoody

The foundation you keep.

Hoody hosts and runs the infrastructure for you. Your AI can use every part of it.

Kit

Every service included. Each at a URL.

Terminal, desktop, files, browser, databases and more, inside each computer. See the Kit

  1. A computer that stays on

    A Hoody computer is a full Linux machine in the cloud. It keeps running after you close the tab.

    One request creates itPOST https://api.hoody.com/api/v1/projects/{p}/computers
    What it means for you

    Your sites, jobs and files keep going while you are away. Ask your AI for a computer and it is ready.

    c01 Always-on computersa02 Computers on demandx04 Snapshots and undodocs / concepts / computers

  2. Everything at a URL

    Every tool in a computer has its own HTTPS link. Change one word in the link and you are in another tool.

    Same computer, two toolshttps://{p}-{c}-terminal-1.{node}.computers.hoody.comhttps://{p}-{c}-display-1.{node}.computers.hoody.com
    What it means for you

    Nothing to install. You, a script and your AI all open the same link.

    x01 Everything is a URLc24 Sites and apps livex02 Work together livedocs / concepts / everything-is-a-url

  3. One API, plain HTTP

    Anything you can do in Hoody, your AI or a script can do too. The API is plain REST over HTTP.

    List your projectscurl "https://api.hoody.com/api/v1/projects/" \ -H "Authorization: Bearer $HOODY_TOKEN"Or with the SDKnpm install hoody-sdk
    What it means for you

    The SDK is optional. Anything that can send a web request can run Hoody: curl, a script or your AI.

    a01 One API for everythingx09 Say @hoody.comx10 ssh hoody.comdocs / foundation / hoody-apigithub / hoody-sdk

  4. Bots and agents do the work

    A Bot is one long-lived chat. It hands your task to agents in your computers and reports what they did.

    A Bot at its own addresshttps://<label>.hoody.bot
    What it means for you

    Say what you want in plain English. The same Bot answers in Telegram, Slack and Discord.

    b01 Your Botb10 One Bot in every chat appb11 Hoody Agent in all your computersThe Bots page

  5. Private links, real locks

    Generated links are unguessable, so a link stays hidden until you share it. Lock any link with a password, a login or an IP list.

    Refuse everyone outside your groups"default": "deny"
    What it means for you

    You decide who opens which tool. Until you set a rule, a link works for anyone who has it.

    x05 Private linksx06 Lock any linkx23 Encrypted disksdocs / concepts / security

hoody / capabilities / computers

01 264 rows

Computers

Always-on computers in your browser. Each tool has its own link.

Always on, with a desktop 10

  • c01

    Always-on computers

    Your computers stay on and keep running after you close the tab.

    Say this to your AI
    Keep this running on my Hoody computers.

    docs / foundation / computers / managing

  • c02

    Desktop in a tab

    Open a full desktop in your browser.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    Say this to your AI
    Open a desktop on my computers.

    Good to knowAnyone with the link can use the desktop until you set proxy permissions.

    docs / kit / displays

  • c03

    Any Linux app

    Run any Linux app and use it from any browser, phone included.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    Say this to your AI
    Run LibreOffice and send me the link.

    docs / kit / displays

  • c04

    Your AI uses the screen

    Let your AI click, type, read windows and take screenshots on a desktop.

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

    Say this to your AI
    Take a screenshot of my desktop and click Save.

    docs / kit / displays

  • c05

    Copy and paste across

    Copy and paste between your device and the desktop.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    Say this to your AI
    Paste this text into the desktop app.

    Good to knowYour browser may ask for clipboard permission before pasting works.

    docs / kit / displays

  • c55

    Pause a computer

    Pause your computer and resume it in seconds with sessions and memory intact.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/pause

    Say this to your AI
    Pause my development computer until tomorrow.

    Good to knowA paused computer keeps its RAM and disk usage, and its service URLs return errors until resumed. A server reboot loses the paused state.

    docs / foundation / computers / managing

  • c56

    Several separate displays

    Run separate desktops with their own resolutions, windows, and applications.

    Say this to your AI
    Give my browser and editor separate displays.

    Good to knowA session must set up each display number before it can start.

    docs / kit / displays

  • c57

    Choose a desktop environment

    Start your display with an Xfce or MATE desktop environment.

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

    Say this to your AI
    Start a display with the MATE desktop.

    Good to knowAn existing terminal session keeps its settings.

    docs / kit / displays

  • c58

    Plain computer setup

    Create a computer without Kit services and run your own HTTP servers.

    Linkhttps://api.hoody.com/api/v1/projects/{p}/computers

    Say this to your AI
    Create a plain computer for my own web server.

    Good to knowA plain computer has no built-in browser shell. Set an SSH public key for initial SSH access.

    docs / foundation / computers / create-edit-delete

  • c59

    Stop a display

    Stop a display and end the programs running on it.

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

    Say this to your AI
    Stop display 1 and its programs.

    Good to knowStopping the display ends every program on it, including unsaved work.

    docs / kit / displays

Desktop viewer options 9

  • c60

    Transfer desktop files

    Transfer files between your browser and your display.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com/

    Say this to your AI
    Transfer this file to my display.

    docs / api / displays / feature-flags

  • c61

    Hear desktop audio

    Play your display's audio through the browser viewing it.

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

    Say this to your AI
    Play my desktop audio in this browser.

    docs / api / displays / web-client

  • c62

    Watch a presentation

    Open a shared desktop as a viewer who cannot click or type.

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

    Say this to your AI
    Give me a viewer link for the desktop presentation.

    Good to knowRead-only viewer mode is not access control: the HTTP API still accepts input, and proxy permissions have no view-only level.

    docs / kit / displays

  • c63

    Print from your desktop

    Forward print jobs from your display to your browser.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com/

    Say this to your AI
    Print this document from my desktop.

    docs / api / displays / feature-flags

  • c64

    Choose keyboard layout

    Choose a keyboard layout for your desktop viewer.

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

    Say this to your AI
    Use the British keyboard layout on my desktop.

    docs / kit / displays

  • c65

    Touchscreen keyboard

    Show a virtual keyboard when you use your desktop on a touchscreen.

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

    Say this to your AI
    Show the virtual keyboard on my touchscreen laptop.

    docs / kit / displays / reference

  • c66

    Cap display bandwidth

    Set a bandwidth cap for your desktop viewer on a slow connection.

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

    Say this to your AI
    Limit my desktop viewer to 500 Kbps.

    docs / kit / displays / reference

  • c67

    Focus an app on opening

    Open your viewer with a named window maximized and focused.

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

    Say this to your AI
    Open my desktop with Firefox in front.

    Good to knowThis minimizes the other windows for every viewer of the display.

    docs / api / displays / web-client

  • c68

    Customize the viewer

    Use a dark desktop viewer with a floating menu.

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

    Say this to your AI
    Open my desktop with a dark viewer and floating menu.

    docs / kit / displays

Desktop automation 7

  • c69

    Move and resize windows

    Move, resize, minimize, restore or close your desktop windows through the API.

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

    Say this to your AI
    Resize my browser window to fill the desktop.

    Good to knowSome window actions need a desktop with a window manager.

    docs / kit / displays

  • c70

    Wait for a window

    Wait for your application window to appear before continuing an automation.

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

    Say this to your AI
    Wait for Firefox to open before continuing.

    Good to knowThe wait lasts up to 25 seconds. Expiry returns HTTP 200 with timedOut set to true.

    docs / kit / displays

  • c71

    Batch desktop actions

    Run a sequence of desktop actions in one API call.

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

    Say this to your AI
    Open hoody.com in the desktop browser in one batch.

    Good to knowA batch runs 1 to 50 actions and stops at the first failure. Earlier actions stay done, and other input can run between them.

    docs / kit / displays

  • c72

    Act and capture

    Run a desktop action and capture its result in one call.

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

    Say this to your AI
    Click the button and capture the resulting screen.

    Good to knowIf the screenshot fails after the action, the action has already completed.

    docs / api / displays / input-actions

  • c73

    Desktop clipboard by API

    Read or set the text on your desktop clipboard with one API call.

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

    Say this to your AI
    Put this address on my desktop clipboard.

    docs / api / displays / screenshots

  • c74

    Stored desktop screenshots

    List the screenshots stored for your desktop and fetch any one by time or file name.

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

    Say this to your AI
    Show me the desktop screenshot from 10 minutes ago.

    Good to knowLookups search the newest 500 stored captures.

    docs / api / displays / screenshots

  • c75

    Desktop thumbnails

    Capture a small image of your desktop for a gallery.

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

    Say this to your AI
    Make a thumbnail of my desktop.

    Good to knowThe thumbnail is scaled to 20% of the screen dimensions.

    docs / api / displays / screenshots

Terminals and browsers 12

  • c06

    Terminal at a link

    Use a full terminal in any browser, with no SSH keys to set up.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    Say this to your AI
    Open a terminal on my computers.

    Good to knowAnyone with the link can use the terminal until you set proxy permissions.

    docs / kit / terminals

  • c07

    Commands by link

    Your AI runs commands and gets the output and errors back.

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

    Say this to your AI
    Run the tests and tell me what failed.

    docs / kit / terminals

  • c08

    Full-screen terminal apps

    Your AI can operate full-screen terminal programs, key by key.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    Say this to your AI
    Open htop and tell me what uses the most memory.

    docs / kit / terminals / automation

  • c09

    Reach your other servers

    SSH into your other servers from the web terminal, no client needed.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    Say this to your AI
    Connect to my old server and check its disk space.

    docs / kit / terminals

  • c10

    Browsers your AI drives

    Run Chromium or Firefox that your AI can browse, read and click.

    Linkhttps://{p}-{c}-browser-1.{node}.computers.hoody.com

    Say this to your AI
    Open the pricing page and put the plans in a table.

    Good to knowBy default, a browser left unused for an hour stops and loses its tabs and cookies. The next call starts a fresh one.

    docs / kit / browser

  • c11

    Screenshots and PDFs of pages

    Screenshot any web page, or save it as a PDF from a background browser.

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

    Say this to your AI
    Save that article as a PDF.

    Good to knowPDFs need a background Chromium; the default browser is the visible one.

    docs / kit / browser

  • c76

    Separate terminal sessions

    Open separate shell sessions that share your computer's files and processes.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    Say this to your AI
    Open a second terminal for the build.

    Good to knowNew sessions take IDs 1 to 9999. IDs 4501 to 5000 are reserved for agents; how many run at once depends on the computer's resources.

    docs / kit / terminals

  • c77

    Keep shell state

    Run related commands in one session and keep your working directory and variables.

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

    Say this to your AI
    Change to my project directory and run the build there.

    Good to knowA session ends on deletion, a computer restart, a terminal service restart, or idle cleanup.

    docs / kit / terminals

  • c78

    Check long commands

    Start a long command and check its output and status while it runs.

    Say this to your AI
    Start the build and check its progress.

    Good to knowA persistent session timeout is a reporting deadline and does not stop a running command.

    docs / kit / terminals

  • c79

    Stop a command

    Interrupt a running terminal command or cancel it while it waits.

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

    Say this to your AI
    Stop the build command I started.

    Good to knowAfter a timeout, abort works only while no other input has reached the terminal and its shell is still running.

    docs / kit / terminals / reference

  • c80

    Watch without typing

    Open a terminal in read-only mode to watch its session without sending input.

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

    Say this to your AI
    Give me a view-only link to the terminal.

    Good to knowRead-only mode blocks input for that client alone. Proxy permissions decide who can open the URL.

    docs / kit / terminals

  • c81

    Exact command output

    Run a command and get its exact output bytes, with stdout and stderr kept apart.

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

    Say this to your AI
    Run this command and give me its exact binary output.

    Good to knowRaw mode waits for the command to finish and runs outside a terminal session. Each stream is captured up to the server's limit.

    docs / api / terminal / commands

Terminal options 10

  • c82

    Choose your shell

    Start your browser terminal with bash, zsh, fish, sh or tmux.

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

    Say this to your AI
    Open my terminal with zsh.

    Good to knowShell settings apply when a session starts. Add reset=true to change the shell of a running session.

    docs / kit / terminals / reference

  • c83

    Start graphical apps

    Pair your terminal with a display and open programs on that display.

    Say this to your AI
    Start Firefox from terminal 2 on display 2.

    Good to knowAn API-created session reads its display setting from the create request body.

    docs / kit / terminals

  • c84

    Join tmux over SSH

    Join your browser's tmux session over SSH using its terminal number.

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

    Say this to your AI
    Show me how to join terminal 3 over SSH.

    docs / kit / terminals

  • c85

    Terminal side panel

    Show your Hoody Agent, a runbook or a dashboard beside your terminal on one page.

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

    Say this to your AI
    Open my agent beside terminal 1.

    Good to knowSharing the URL shares the terminal and its panel.

    docs / api / terminal / web-interface

  • c86

    Temporary shell sessions

    Create a temporary terminal with an assigned ID that cleans itself up.

    Say this to your AI
    Run this script in a temporary terminal.

    Good to knowThe service picks an ID from 5001 to 7999. The session has no display, and a finished result stays fetchable for 5 minutes by default.

    docs / kit / terminals / reference

  • c87

    Run on terminal startup

    Run your startup script before a local terminal's shell prompt appears.

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

    Say this to your AI
    Run my setup script when terminal 2 starts.

    Good to knowSSH sessions do not run the startup script. A script selected for a session must have an absolute path without `..`.

    docs / kit / terminals / reference

  • c88

    SSH through a proxy

    Route your terminal's SSH connection through a SOCKS5 proxy to reach a host.

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

    Say this to your AI
    Connect to my server through my SOCKS5 proxy.

    Good to knowSSH host keys are not checked. Put SSH credentials and SOCKS5 settings in the create request body.

    docs / kit / terminals / reference

  • c89

    Command environment

    Supply environment variables for one command in your local terminal session.

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

    Say this to your AI
    Run the tests with DEBUG set to 1.

    Good to knowOn an SSH session, supplied variables are exported in the remote shell and persist.

    docs / api / terminal / commands

  • c90

    Customize terminal view

    Set your terminal tab title, font size and background color through its link.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    Say this to your AI
    Make the terminal text larger and title the tab Build.

    Good to knowFont size ranges from 8 to 72 pixels. Tab titles have a maximum of 200 characters.

    docs / api / terminal / web-interface

  • c91

    Screen reader mode

    Turn on screen reader support for your browser terminal through its link.

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

    Say this to your AI
    Open the terminal with screen reader support.

    docs / api / terminal / web-interface

Terminal automation 6

  • c92

    Wait for terminal output

    Wait for a matching prompt or a stable screen before your next step.

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

    Say this to your AI
    Wait until the Python prompt appears.

    Good to knowThe wait timeout defaults to 5000 ms and accepts 10 to 300000 ms.

    docs / kit / terminals / automation

  • c93

    Search terminal screen

    Search your terminal screen or scrollback for a pattern and get match positions.

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

    Say this to your AI
    Find error messages in my terminal scrollback.

    Good to knowPatterns are at most 1024 bytes. Search returns up to 1000 hits and has a 500 ms time budget.

    docs / kit / terminals / automation

  • c94

    Terminal command history

    Retrieve a session's retained command records with their statuses and exit codes.

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

    Say this to your AI
    Show me the commands run in terminal 1.

    Good to knowHistory is a rolling window of 100 records by default. Pull it as you go for a complete record.

    docs / kit / terminals / reference

  • c95

    Export terminal output

    Download retained terminal output or retrieve its last lines as text or HTML.

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

    Say this to your AI
    Download the latest output from terminal 1.

    Good to knowOutput retains up to 8 MB by default, dropping the oldest.

    docs / kit / terminals / reference

  • c96

    Terminal screenshots

    Turn your terminal's output into an image for a tutorial or dashboard.

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

    Say this to your AI
    Save a PNG screenshot of my terminal.

    Good to knowChoose PNG, JPEG or GIF. The image is also saved by default.

    docs / kit / terminals / reference

  • c97

    Terminal mouse input

    Click or scroll in a terminal program that supports mouse reporting.

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

    Say this to your AI
    Click the menu item in my terminal program.

    Good to knowThe program sees mouse events only if it turned on mouse reporting. HTTP accepts up to 256 events per request.

    docs / kit / terminals / automation

Read web pages 8

  • c98

    Page as Markdown

    Turn a web page into Markdown with its title and metadata.

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

    Say this to your AI
    Read this article as Markdown.

    Good to knowOnly the main frame is converted, so iframe content and shadow DOM are excluded.

    docs / api / browser / interaction

  • c99

    Extract article content

    Get a page's main content without its navigation, sidebars and comments.

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

    Say this to your AI
    Extract the main article from this page.

    Good to knowOnly the main frame is converted, so iframe content and shadow DOM are excluded.

    docs / api / browser / interaction

  • c100

    Page HTML or text

    Get your browser tab's full HTML or just its visible text.

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

    Say this to your AI
    Show me the HTML of this tab.

    docs / kit / browser

  • c101

    Collect page links

    Get a sorted, deduplicated list of links from your page.

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

    Say this to your AI
    List the links on this article.

    Good to knowThe links array contains at most 10000 entries. Only the main frame is converted.

    docs / api / browser / interaction

  • c102

    Run page JavaScript

    Run JavaScript in your browser tab and get the result back.

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

    Say this to your AI
    Run JavaScript to read the page title.

    Good to knowOn the default stealth instance, scripts run in an isolated world and cannot read page globals. The default and maximum timeout is 30000 ms.

    docs / kit / browser

  • c103

    Screenshot one element

    Capture one visible page element at its own size.

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

    Say this to your AI
    Capture just the chart on this page.

    Good to knowThe selector captures the first matching element and cannot be combined with clip or fullPage=true.

    docs / api / browser / interaction

  • c104

    Mask screenshot details

    Cover selected page elements with opaque boxes in your screenshot.

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

    Say this to your AI
    Cover the account number in this screenshot.

    Good to knowMasking does not cover elements inside iframes. A selector matching nothing still succeeds, so check the image.

    docs / api / browser / interaction

  • c105

    Page accessibility snapshot

    Get a structured snapshot of your page with element references.

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

    Say this to your AI
    Show me the accessible controls on this page.

    Good to knowReferences expire after a newer snapshot or top-document navigation. Entered form values are hidden by default.

    docs / api / browser / interaction

Browser control 15

  • c106

    Connect browser automation

    Connect your Playwright or Puppeteer client to a Hoody Chromium instance.

    Linkhttps://{p}-{c}-cdp-1.{node}.computers.hoody.com/

    Say this to your AI
    Connect my Playwright script to the Hoody browser.

    Good to knowRequires Chromium with remote debugging enabled; Firefox returns 501.

    docs / kit / browser

  • c107

    Separate browser sessions

    Run separate browser instances with their own tabs and cookies.

    Say this to your AI
    Open two separate browser sessions for these sites.

    Good to knowBy default, an instance unused for an hour is stopped and its tabs and cookies are discarded.

    docs / kit / browser

  • c108

    Wait for page changes

    Wait for your page to show text, reach a URL or load.

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

    Say this to your AI
    Wait until the page says the order is confirmed.

    Good to knowThe timeout is 10000 ms by default and 30000 ms at most. This call does not start a browser.

    docs / kit / browser / reference

  • c109

    Handle page dialogs

    Accept or dismiss a page dialog raised by your browser action.

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

    Say this to your AI
    Click delete and accept the confirmation dialog.

    Good to knowThe policy covers the first matching dialog raised by the action; unexpected dialogs are dismissed and the action fails.

    docs / kit / browser

  • c110

    Manage browser tabs

    List your open browser tabs, popups included, and close the ones you no longer need.

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

    Say this to your AI
    Close the old shopping tab in my browser.

    Good to knowThe last open tab cannot be closed.

    docs / kit / browser

  • c111

    Browser cookies

    Read, add or clear the cookies in your browser instance.

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

    Say this to your AI
    Show me the cookies for this site.

    Good to knowIf one added cookie is invalid, none are set. Stopping the instance discards its cookies.

    docs / kit / browser

  • c112

    Set browser location

    Set your browser's locale, time zone and geolocation when it starts.

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

    Say this to your AI
    Start a browser with a London time zone.

    Good to knowThese options apply only when the instance is created.

    docs / kit / browser

  • c113

    Browser through a proxy

    Route your browser traffic through an HTTP or SOCKS proxy.

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

    Say this to your AI
    Start my browser through my proxy.

    Good to knowThe proxy option applies only when the instance is created.

    docs / kit / browser

  • c114

    Chromium extensions

    Load Chromium extensions such as an ad blocker in your browser.

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

    Say this to your AI
    Start Chromium with my ad blocker.

    Good to knowExtensions require a visible Chromium instance and must be set when the instance is created.

    docs / kit / browser

  • c115

    Pin a Chrome version

    Choose a Chrome version or channel for your browser instance.

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

    Say this to your AI
    Start a browser using Chrome 136.

    Good to knowStart options apply only when the instance is created. An unresolved major version is treated as omitted, so check browserFullVersion in metadata.

    docs / kit / browser

  • c116

    Browser history

    Browse your browser's history by date or domain, or delete it.

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

    Say this to your AI
    Delete my browser history before October.

    Good to knowHistory is kept 30 days by default and survives restarts. Deletion is permanent.

    docs / kit / browser

  • c117

    Browser console logs

    Inspect your browser's recent console messages and page errors.

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

    Say this to your AI
    Show me the console errors from my test page.

    Good to knowKeeps the last 500 entries. The default stealth instance captures only browser-reported messages, not page console calls or uncaught errors.

    docs / api / browser / health

  • c118

    Browser network log

    Inspect recent network requests and responses across your browser tabs.

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

    Say this to your AI
    Show me the network requests from my test page.

    Good to knowKeeps the last 500 entries.

    docs / api / browser / health

  • c119

    Open browser DevTools

    Get a link to inspect your Chromium instance in DevTools.

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

    Say this to your AI
    Open DevTools for my browser.

    Good to knowDevTools Protocol is unavailable on Firefox or when Chromium remote debugging is disabled.

    docs / kit / browser

  • c120

    Resize browser tabs

    Set a fixed viewport size across your running browser's tabs.

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

    Say this to your AI
    Resize my browser tabs to 1280 by 800.

    Good to knowWidth and height are integers from 1 to 8192. Crashed tabs are skipped.

    docs / api / browser / control

Files and data 8

  • c12

    Files at a link

    Browse, edit and download your files in a web file manager.

    Linkhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    Say this to your AI
    Show me the files in my project folder.

    Good to knowAnyone with the link can see and change your files until you set proxy permissions.

    docs / kit / files

  • c13

    Cloud drives in one place

    Plug in Google Drive, Dropbox, S3 and more: 49 kinds of remote storage.

    Linkhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    Say this to your AI
    Copy my Dropbox invoices into my project.

    docs / kit / files

  • c14

    File history

    Bring back earlier versions of small text files you changed by link.

    Linkhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    Say this to your AI
    Show me yesterday's version of config.json.

    Good to knowText files up to 2 MiB changed through Hoody Files, kept 90 days or until the history reaches 2 GiB. Build folders and URL downloads are skipped, and recording is best effort, so it is not a backup.

    docs / kit / files

  • c15

    Files on your laptop

    Open your computers' files in Finder or Explorer.

    Say this to your AI
    Mount my Hoody files on my Mac.

    Good to knowAnyone with the WebDAV link can mount your files until you set proxy permissions.

    docs / foundation / storage / mount-locally

  • c16

    Laptop folder inside

    Make a folder on your laptop show up inside your computers.

    Say this to your AI
    Share my Downloads folder with my Hoody computers.

    Good to knowLinux or macOS with rclone 1.61 or newer; Windows not yet. The folder works only while your machine is online and the command runs, and stopping waits to deliver pending writes.

    docs / foundation / storage / share-local-folder

  • c17

    Folders shared across

    Share a folder between your computers on the same server, read-only or read-write.

    Say this to your AI
    Share the assets folder with all my computers in this project.

    Good to knowBetween computers on the same server. Across servers is a pilot, off by default.

    docs / foundation / storage / sharing-files

  • c18

    Databases with no server

    Keep SQL databases and key-value data, reachable by link.

    Linkhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    Say this to your AI
    Make a database for my reading list.

    Good to knowAnyone with the link can reach the database until you set proxy permissions.

    docs / kit / sqlite

  • c19

    Data undo

    See and undo past changes to your saved key-value data.

    Linkhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    Say this to your AI
    Undo the last change to my settings.

    Good to knowOnly changes made through the key-value API are recorded. SQL writes, and writes sent with history turned off, cannot be undone.

    docs / kit / sqlite

File tools by link 17

  • c121

    Download from a URL

    Fetch a remote file straight into your computer without using your device.

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

    Say this to your AI
    Download this dataset directly to my computer.

    Good to knowA download stops at 100 GiB or 12 hours.

    docs / kit / files

  • c122

    Copy and move files

    Copy or move your files and folders through the Files API.

    Say this to your AI
    Copy my report into the archive folder.

    Good to knowA move never replaces an existing destination. A copy replaces it only with `?overwrite=true`.

    docs / kit / files

  • c123

    Look inside an archive

    List your archive's contents or read one file without extracting it.

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

    Say this to your AI
    List the files in this archive and show me its README.

    Good to knowSupports ZIP, TAR and compressed TAR archives. A selected file over 100MB is refused.

    docs / api / files / directories

  • c124

    Resize and convert images

    Resize, convert, blur or gray out an image by link.

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

    Say this to your AI
    Make a 256-pixel WebP thumbnail of this photo.

    Good to knowSupports JPEG, PNG, WebP, GIF and BMP, up to a 2000 by 2000 pixel box. Blur radius is 0 to 50.

    docs / api / files / file-operations

  • c125

    Read selected lines

    Read a range or the last lines of your file by link.

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

    Say this to your AI
    Show me the last 20 lines of this log.

    Good to knowMax 100,000 lines or 64 MB per request.

    docs / api / files / reading

  • c126

    Read-only file page

    Open your text file on a page without editing controls.

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

    Say this to your AI
    Open this note in a read-only view.

    Good to knowThe view does not prevent writes through other requests. Set proxy permissions to control access.

    docs / kit / files

  • c127

    Compare file revisions

    See a diff between two recorded versions of your file.

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

    Say this to your AI
    Show me what changed between these two revisions.

    Good to knowHistory covers changes made through Files. Files over 2 MiB and binary files keep no diff, and history is pruned after 90 days or past 2 GiB.

    docs / kit / files

  • c128

    Append to a file

    Add data to the end of your file by link, creating it if missing.

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

    Say this to your AI
    Append this entry to my log file.

    docs / api / files / file-operations

  • c129

    Extract one archive member

    Extract one file or folder while leaving the rest of your archive untouched.

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

    Say this to your AI
    Extract only the images folder from this archive.

    Good to knowSupports ZIP, TAR and compressed TAR archives.

    docs / api / files / directories

  • c130

    Download file ranges

    Request selected bytes of your file instead of downloading it all.

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

    Say this to your AI
    Fetch the first megabyte of this file.

    Good to knowSeveral ranges on a remote file named with `backend` return the whole file.

    docs / api / files / reading

  • c131

    File details by link

    Check your file's size, owner and permissions without downloading its contents.

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

    Say this to your AI
    Check the size and owner of this file.

    docs / api / files / file-operations

  • c132

    Check file integrity

    Compare your file's SHA-256 hash with your copy to check a download.

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

    Say this to your AI
    Check whether my downloaded backup matches the original.

    docs / kit / files

  • c133

    Manage URL downloads

    Check progress, review history or cancel your computer's URL downloads.

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

    Say this to your AI
    Show my active downloads and cancel the stalled one.

    Good to knowCanceling requires write permission on the root. A canceled partial file is kept on a mount or network filesystem.

    docs / api / files / downloading

  • c134

    Track archive extraction

    Check progress or cancel your running archive extractions.

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

    Say this to your AI
    Check whether my archive is still extracting.

    Good to knowCanceling an extraction needs write permission on the root folder.

    docs / api / files / directories

  • c135

    File change audit

    Find recorded file changes across your computer by path, operation and time.

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

    Say this to your AI
    Show me file deletions recorded in this folder today.

    Good to knowThe journal records changes made through Hoody Files, not changes made by terminal commands, scripts or programs.

    docs / kit / files

  • c136

    Conditional file writes

    Write your file only when its version matches your expected version.

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

    Say this to your AI
    Save this only if nobody changed it since I read it.

    Good to knowWorks on files on the computer, not on connected cloud storage.

    docs / api / files / file-operations

  • c137

    Set upload permissions

    Set your new file's permission bits as you upload it.

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

    Say this to your AI
    Upload this key with owner-only permissions.

    Good to knowCheck that `GET /api/v1/version` lists `put_chmod` in `features`; older services ignore `?chmod`.

    docs / kit / files

Cloud and shared storage 11

  • c138

    Remote storage as folders

    Mount a connected storage account so programs can use it as a folder.

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

    Say this to your AI
    Mount my connected Drive for my programs to use.

    Good to knowWrites upload after `write_back`, 5 seconds by default. With two writers to one file, the last upload wins.

    docs / kit / files

  • c139

    Several cloud accounts

    Connect your personal and work accounts from the same storage provider.

    Say this to your AI
    Connect both my personal and work Google Drives.

    Good to knowConnections are capped at 100 in total and 10 per remote host by default.

    docs / foundation / storage / cloud

  • c140

    Copy between cloud providers

    Copy a file between your connected providers using your computer's bandwidth.

    Say this to your AI
    Copy this Drive backup to my S3 bucket.

    Good to knowThe file passes through a temporary copy on the computer.

    docs / foundation / storage / cloud

  • c141

    Connect file servers

    Connect your SFTP, SMB, WebDAV, FTP, HDFS or HTTP server to your computer.

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

    Say this to your AI
    Connect my team's SMB file server.

    Good to knowConnecting checks your login; mount it as a folder afterwards.

    docs / api / files / mount / protocols

  • c142

    Mount on a phone

    Open your computer's files from a WebDAV app on your phone.

    Linkhttps://{p}-{c}-files-1.{node}.computers.hoody.com/

    Say this to your AI
    Open my computer's files in a phone file app.

    Good to knowAnyone with the WebDAV link can mount your files until you set proxy permissions.

    docs / foundation / storage / mount-locally

  • c143

    One-off remote files

    Read or upload remote files without saving a storage connection.

    Say this to your AI
    Read this file from my SFTP server once.

    Good to knowAvailable for SFTP, WebDAV, FTP and S3.

    docs / kit / files

  • c144

    Read-only laptop folder

    Let your computer read a laptop folder while protecting it from writes.

    Say this to your AI
    Share my documents folder with the computer as read-only.

    Good to knowRequires Linux or macOS with rclone 1.61 or newer. The share works while your machine is online and the command runs.

    docs / foundation / storage / share-local-folder

  • c145

    Expiring folder shares

    Set an expiry time for a folder shared with another computer.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/storage/shares

    Say this to your AI
    Share this folder with the other computer until Friday.

    Good to knowWhen it expires, the share is deleted and unmounted from every target.

    docs / foundation / storage / sharing-files

  • c146

    Accept incoming shares

    Accept or turn off a folder share another computer sends to yours.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/storage/incoming/{shareId}/mount

    Say this to your AI
    Stop mounting the shared assets folder on this computer.

    Good to knowBoth the creator's enabled flag and the receiver's mount flag must be true for the share to be mounted.

    docs / api / storage-shares

  • c147

    Read-only cloud mount

    Make your mounted remote folder refuse writes through its mount path.

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

    Say this to your AI
    Make this mounted cloud folder read-only.

    Good to knowThe `?backend=` route can still write. Custom settings are unsupported for `box`, `onedrive` and `protondrive`.

    docs / kit / files / reference

  • c148

    Files that failed to upload

    Find files your cloud mount could not upload and download the held copies.

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

    Say this to your AI
    Show me the files waiting to reach my cloud storage.

    Good to knowHeld files stay until you deliver or discard them. A held copy may be incomplete.

    docs / kit / files

Databases and key-value 13

  • c149

    SQL transactions

    Run several SQL statements together and roll them back if one fails.

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

    Say this to your AI
    Update the order and its inventory in one transaction.

    Good to knowA result set stops at 10,000 rows with truncated: true; page with LIMIT.

    docs / kit / sqlite

  • c150

    Share a live query

    Share a link that runs your read-only SQL query against live data.

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

    Say this to your AI
    Make a link that shows the current order count.

    Good to knowThe URL carries one read-only SELECT encoded in Base64URL.

    docs / kit / sqlite

  • c151

    Native and HTTP SQLite

    Use your SQLite database from local code and over HTTP at once.

    Say this to your AI
    Let my local worker and my dashboard use the same database.

    Good to knowSQLite permits one writer per database file at a time. Do not share the database file between computers through a storage share.

    docs / foundation / storage / sqlite-drive

  • c152

    Database backup copy

    Make a consistent copy of your SQLite database while it is in use.

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

    Say this to your AI
    Make a consistent backup of my database.

    Good to knowThe copy is written to a new path.

    docs / kit / sqlite

  • c153

    Follow database changes

    Stream changes to your key-value table as they happen, including SQL writes.

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

    Say this to your AI
    Tell me whenever a key in my app database changes.

    Good to knowThe log keeps 24 hours and at most 1,000,000 changes.

    docs / kit / sqlite

  • c154

    Expire temporary keys

    Give your saved keys an expiry, or change it later.

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

    Say this to your AI
    Expire this session key in an hour.

    docs / kit / sqlite

  • c155

    Race-safe counters

    Count up a shared counter from many clients without losing an update.

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

    Say this to your AI
    Count each visit to my homepage.

    docs / kit / sqlite

  • c156

    Update JSON fields

    Read, write or increment one part of your saved JSON value.

    Say this to your AI
    Change the theme field without replacing the other settings.

    Good to knowThe stored value needs a JSON content type for a path set.

    docs / kit / sqlite

  • c157

    Prevent conflicting writes

    Update a shared key only if its version has not changed.

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

    Say this to your AI
    Update the settings only if nobody changed them first.

    Good to knowA 412 means another client wrote first: read again and redo the change.

    docs / kit / sqlite

  • c158

    Keys as files

    Store your keys in a directory where other tools can edit them as files.

    Say this to your AI
    Store these settings as files in a directory.

    docs / kit / sqlite

  • c159

    Batch SQL values

    Run one SQL statement against multiple sets of your values.

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

    Say this to your AI
    Insert these rows with one SQL statement.

    docs / kit / sqlite

  • c160

    Batch key operations

    Read, write or delete up to 100 keys in one request.

    Say this to your AI
    Save these settings together in one batch.

    Good to knowA batch write applies every key or none.

    docs / kit / sqlite

  • c161

    Race-safe lists

    Push, pop or remove items in a saved list without races between clients.

    Say this to your AI
    Add this item to the shared shopping cart.

    docs / kit / sqlite

Sites, scripts and links 10

  • c20

    Scripts become endpoints

    Save a JavaScript or TypeScript file in your scripts folder and it is a live web endpoint.

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

    Say this to your AI
    Write an endpoint that turns a CSV into JSON.

    docs / kit / exec

  • c21

    AI inside scripts

    Your scripts can call AI models with no key to set up.

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

    Say this to your AI
    Make an endpoint that summarizes any web page.

    Good to knowThe default model is free, within server limits. Paid models are billed per use.

    docs / kit / exec / ai-integration

  • c22

    Private endpoints

    Protect any script endpoint with its own secret token.

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

    Say this to your AI
    Lock that endpoint so only my app can call it.

    docs / kit / exec / authentication

  • c23

    Live script events

    Stream live events from a running script to any page.

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

    Say this to your AI
    Push live order updates to my dashboard.

    Good to knowTurned on per script. Events are not stored, so a page only sees events sent while it is connected. Add a token or proxy permissions before sending private data.

    docs / kit / exec / remote

  • c24

    Sites and apps live

    HTTP apps you run are live at their own HTTPS link, no deploy step.

    Linkhttps://{p}-{c}-http-8080.{node}.computers.hoody.com

    Say this to your AI
    Build me a landing page and send me the link.

    Good to knowOpen to anyone with the link until you set proxy permissions on it.

    docs / concepts / everything-is-a-url

  • c25

    Your own domain

    Put any site or tool on a domain you own, HTTPS included.

    Linkhttps://www.yourdomain.com

    Say this to your AI
    Put my site on www.example.com.

    Good to knowSubdomains only, like www.example.com, not example.com. Point each one at a short link; several can share one.

    docs / foundation / proxy / connect-domain

  • c26

    Short links

    Give any site or tool a short, memorable link.

    Linkhttps://{alias}.{node}.computers.hoody.com

    Say this to your AI
    Give my dashboard a short link.

    Good to knowShort links are easy to guess and open to anyone until you set proxy permissions. 3 per free server, 50 on Plus, 250 on Pro.

    docs / foundation / proxy / aliases

  • c162

    Expiring demo links

    Set an expiration time for your demo or event link.

    Linkhttps://api.hoody.com/api/v1/proxy/aliases

    Say this to your AI
    Make this demo link expire on Friday.

    Good to knowAfter expiration the alias answers 404 and keeps its configuration. Disabled and expired aliases count toward the server's alias limit.

    docs / foundation / proxy / aliases

  • c163

    Pin a link to one page

    Make your alias open one fixed page or API endpoint.

    Linkhttps://api.hoody.com/api/v1/proxy/aliases

    Say this to your AI
    Make this link open only the report page.

    Good to knowWith path override disabled, other paths return 404. Methods, bodies, WebSocket upgrades and other parameters still pass.

    docs / foundation / proxy / aliases

  • c164

    Pause a short link

    Disable your alias and restore it later without losing its configuration.

    Linkhttps://api.hoody.com/api/v1/proxy/aliases/{id}/state

    Say this to your AI
    Pause the demo link until tomorrow.

    Good to knowThe URL answers 404 while disabled. Changes reach the alias URL in about 30 seconds, sometimes longer.

    docs / foundation / proxy / aliases

Writing scripts 12

  • c165

    Packages in scripts

    Import an npm package and have it installed before your script runs.

    Say this to your AI
    Use axios in my script to fetch that API.

    Good to knowThat first request is slower and needs the computer to reach the npm registry. Computed package names are not detected.

    docs / kit / exec / writing-scripts

  • c166

    Dynamic script routes

    Capture values from a URL path for your script to use.

    Say this to your AI
    Make a user endpoint that reads the ID from its URL.

    docs / kit / exec / routing

  • c167

    Structured AI responses

    Have your script request AI output in a defined JSON shape.

    Say this to your AI
    Extract names and dates from this text as JSON.

    Good to knowA Zod schema validates the response automatically; a `jsonSchema(...)` schema is only sent to the model unless you pass a `validate` function.

    docs / kit / exec / ai-integration

  • c168

    Stream AI responses

    Stream generated text from your script as the response is produced.

    Say this to your AI
    Stream the answer from my AI endpoint as it writes.

    docs / kit / exec / ai-integration

  • c169

    Script WebSocket servers

    Accept WebSocket connections in your own worker script.

    Say this to your AI
    Make a WebSocket endpoint for my chat app.

    Good to knowWebSocket needs both `// @mode worker` and `// @websocket`.

    docs / kit / exec / execution-modes

  • c170

    Script request middleware

    Run your own code before and after requests to scripts in a folder.

    Say this to your AI
    Add request logging around the scripts in my API folder.

    docs / kit / exec / routing

  • c171

    Script environment keys

    Set environment values for a script, a folder, or your scripts root.

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

    Say this to your AI
    Set the API key for my invoice script.

    Good to knowThe request requires the current file revision to prevent conflicting changes.

    docs / api / exec / script-management

  • c172

    Shared script cache

    Keep temporary values available across requests to your scripts.

    Say this to your AI
    Cache the latest exchange rates between requests.

    Good to knowA restart loses it completely, and clearing or idle eviction empties it.

    docs / kit / exec

  • c173

    Fresh context per request

    Run each request in a fresh JavaScript context for independent tasks.

    Say this to your AI
    Make this webhook receiver use a fresh context for each request.

    Good to knowA fresh context isolates variables, not side effects: files written, subprocesses started and network calls made persist.

    docs / kit / exec / execution-modes

  • c174

    Generate from templates

    Generate your script from a built-in or custom template.

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

    Say this to your AI
    Generate my new script from a template.

    docs / api / exec / templates

  • c175

    Check scripts before running

    Check your script's syntax, dependencies, directives, and optional types in one call.

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

    Say this to your AI
    Check this script for errors before saving it.

    docs / api / exec / validation

  • c176

    Pin script dependencies

    Pin versions of your script dependencies in the package manifest.

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

    Say this to your AI
    Pin the dependency versions used by my scripts.

    docs / api / exec / package-management

Running scripts 8

  • c177

    Script version history

    Bring back an earlier version of your script, or a deleted one you kept a copy of.

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

    Say this to your AI
    Restore the previous version of my webhook script.

    Good to knowA deleted script can be restored only if it was deleted with `keepCopy=true`.

    docs / api / exec / script-management

  • c178

    Search script logs

    Search your script logs for text or a regular expression.

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

    Say this to your AI
    Find timeout errors in my script logs.

    docs / api / exec / logs

  • c179

    Script performance history

    See hourly call counts, failures, and latency for your script.

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

    Say this to your AI
    Show me when my webhook was slow today.

    Good to knowThe history covers the last 24 hours.

    docs / api / exec / monitoring

  • c180

    Message running scripts

    Send a message to your running script and receive its handler's reply.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    Say this to your AI
    Send a start message to my running build script.

    Good to knowTurn on `@remote-messages` for the script. Remote operations do not run directory middleware, so protect them with tokens.

    docs / kit / exec / remote

  • c181

    Call exposed functions

    Call a function your running script exposes and get its response.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    Say this to your AI
    Call the status function on my running worker.

    Good to knowTurn on `@remote-call` for the script. Remote operations do not run directory middleware, so protect them with tokens.

    docs / kit / exec / remote

  • c182

    Inspect a live script

    Evaluate an expression against your script's latest run while debugging.

    Say this to your AI
    Inspect the counter in my running worker.

    Good to knowIt needs `@remote-eval` and a `@remote-token` with the `eval` scope; `@token` never unlocks it.

    docs / kit / exec / remote

  • c183

    Script schedule history

    Review past scheduled script runs and filter them by script or time.

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

    Say this to your AI
    Show me when my scheduled report script ran.

    docs / api / exec / scheduling

  • c184

    Test script routes

    Check several URL paths against your script routing rules at once.

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

    Say this to your AI
    Check which scripts handle these URL paths.

    docs / api / exec / routing

Running on its own 17

  • c27

    Programs that stay up

    Run servers and workers that restart on their own if they crash.

    Linkhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com

    Say this to your AI
    Keep my scraper running all the time.

    Good to knowA program that keeps failing right at startup is marked fatal and stops being retried.

    docs / kit / daemons

  • c28

    Fence in a program

    Limit what one program can write, reach and use.

    Linkhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com

    Say this to your AI
    Run that worker with only TCP ports 443 and 53 open.

    Good to knowFor Daemons programs. Limits TCP ports, not hosts; some Unix sockets stay reachable, and a read-only root blocks writes, not reads.

    docs / kit / program-sandbox

  • c29

    Docker ready, Kubernetes too

    Docker and Compose come ready with the dev kit, and Kubernetes runs inside after a short setup.

    Say this to your AI
    Run the test suite in a Docker container.

    docs / foundation / computers / images

  • c30

    Scheduled jobs

    Run anything on a schedule, and set jobs to remove themselves at a set time.

    Linkhttps://{p}-{c}-cron-1.{node}.computers.hoody.com

    Say this to your AI
    Back up my database every night at 3.

    docs / kit / cron

  • c31

    Web requests as links

    Turn any API call into a link you can click, share or schedule.

    Linkhttps://{p}-{c}-curl-1.{node}.computers.hoody.com

    Say this to your AI
    Make a link that posts to my webhook.

    Good to knowAnyone with the link can read every header and value in it, credentials included.

    docs / kit / curl

  • c32

    Repeat calls, keep answers

    Call an API on a schedule and save each response as a file.

    Linkhttps://{p}-{c}-curl-1.{node}.computers.hoody.com

    Say this to your AI
    Check this API every hour and keep the results.

    docs / kit / curl

  • c185

    Start programs at boot

    Start your program automatically whenever the computer boots.

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

    Say this to your AI
    Start my API server whenever the computer boots.

    Good to knowAn enabled boot program can start as soon as you create, enable or edit it.

    docs / kit / daemons

  • c186

    Start on first request

    Start your service when someone first requests its port.

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

    Say this to your AI
    Start my app only when someone opens it.

    Good to knowRequires lazy_load and a port_range. lazy_load is refused alongside boot: true.

    docs / kit / daemons

  • c187

    Read program logs

    Read the last lines of your program's output or error log, or follow it live.

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

    Say this to your AI
    Show me the last 200 error lines from my worker.

    Good to knowLogs rotate at 5 MiB with two backups by default; both settings can be adjusted.

    docs / kit / daemons

  • c188

    Run a temporary command

    Launch a one-off program and collect its exit result.

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

    Say this to your AI
    Run my migration once and check its exit code.

    Good to knowA command that outlasts its startup window returns running. Status and logs remain reachable for 10 minutes after it finishes.

    docs / kit / daemons

  • c189

    Wait for server readiness

    Start your server and get an answer only once its port accepts connections.

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

    Say this to your AI
    Wait until my API port is ready before continuing.

    Good to knowSet ready_port on the program and use a waiting start.

    docs / kit / daemons

  • c190

    One program per port

    Run separate instances of your program across a range of ports.

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

    Say this to your AI
    Run four copies of my service on ports 8000 through 8003.

    Good to knowEach instance receives its port as a command-line flag; leave the port out of the command.

    docs / kit / daemons

  • c191

    Interactive daemon program

    Watch and type into your supervised program through a terminal.

    Say this to your AI
    Run my worker in a terminal so I can interact with it.

    Good to knowA sandboxed program cannot have a terminal_id.

    docs / kit / daemons

  • c192

    Program status overview

    Show your programs' states without exposing commands or environment variables.

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

    Say this to your AI
    Show a safe status overview of my programs.

    docs / kit / daemons

  • c193

    Offline sandbox worker

    Run a worker with IP networking switched off, so it cannot reach the internet.

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

    Say this to your AI
    Run this worker without IP network access.

    Good to knowUnix sockets reachable by path still work. The program must be a persistent non-root Daemons program.

    docs / kit / program-sandbox

  • c194

    Sandbox connection rate

    Set a per-source connection rate for your sandboxed service.

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

    Say this to your AI
    Limit new connections to my app to 50 per second per source.

    Good to knowIngress covers new IPv4 TCP connections. Budgets reset when rules are rebuilt, and past 65535 sources new ones are not metered.

    docs / kit / program-sandbox

  • c195

    Private temporary space

    Give your sandboxed program its own empty temporary directories.

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

    Say this to your AI
    Give this worker private temporary space capped at 256 MiB each.

    Good to knowThe program must be a persistent non-root Daemons program. Temporary space is in memory and counts against max_memory.

    docs / kit / program-sandbox / reference

Scheduled job tools 7

  • c196

    Run scheduled jobs now

    Run your existing scheduled job immediately and receive a receipt.

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

    Say this to your AI
    Run my scheduled backup now.

    Good to knowThe entry must exist and be enabled. Paused or expired entries and entries with an earlier Run now still running do not run.

    docs / kit / cron

  • c197

    Check a cron schedule

    Check a cron schedule, read it in plain words and see up to its next three runs.

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

    Say this to your AI
    Check this cron expression and show its next runs.

    Good to knowNext run times are null for a reboot-only or never-firing schedule.

    docs / kit / cron

  • c198

    Pause a scheduled job

    Pause your scheduled job and resume it when needed.

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

    Say this to your AI
    Pause the nightly backup job for now.

    Good to knowA paused job remains in the crontab as a commented-out line.

    docs / kit / cron

  • c199

    Scheduled job history

    Inspect your managed job's status, exit code and run duration.

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

    Say this to your AI
    Did my nightly backup finish successfully?

    Good to knowHistory keeps up to 50 ended runs per entry, for 30 days, and 10,000 ended runs in all. Raw lines have no runs.

    docs / kit / cron

  • c200

    Live scheduled job events

    Follow your job starts, finishes and crontab changes as they happen.

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

    Say this to your AI
    Watch for changes and runs of my scheduled jobs.

    Good to knowOnly managed entries report job starts and finishes; raw crontab lines you wrote do not.

    docs / kit / cron

  • c201

    Audit jobs across users

    List managed jobs and parsed handwritten jobs across your computer's users.

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

    Say this to your AI
    List the scheduled jobs across all users.

    Good to knowRetrieve every page and check unreadable_users and job_lines before treating the audit as complete.

    docs / kit / cron

  • c202

    Edit a raw crontab

    Read and replace the complete crontab for your chosen user.

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

    Say this to your AI
    Show me the raw crontab for my worker account.

    Good to knowReplacing a crontab overwrites everything, managed entries included. Bodies larger than 256 KiB (262,144 bytes) are refused.

    docs / kit / cron

Background web requests 5

  • c203

    Background web requests

    Run your slow web request in the background and collect its result later.

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

    Say this to your AI
    Start this slow API request and give me the result later.

    Good to knowFinished job records are deleted after 7 days by default.

    docs / kit / curl

  • c204

    Retry failed requests

    Retry your failed web transfers with a delay between attempts.

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

    Say this to your AI
    Retry this download if the transfer fails.

    Good to knowAt most 5 retries. A retry resends a POST body.

    docs / kit / curl

  • c205

    Cookie sessions

    Keep cookies between your requests to a site using a named session.

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

    Say this to your AI
    Log in and use the session to fetch my account data.

    Good to knowA session lasts until deleted or unused for 30 days; after that the same ID starts with no cookies.

    docs / kit / curl

  • c206

    Stream API events

    Get an API's live event stream, such as an AI chat stream, as it arrives.

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

    Say this to your AI
    Stream events from this API as they arrive.

    Good to knowThe upstream response must be a body-bearing 2xx with Content-Type text/event-stream. Each stream is capped at 30 minutes by default.

    docs / kit / curl

  • c207

    Request job events

    Follow events when your background requests start, progress and finish.

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

    Say this to your AI
    Tell me when my background download finishes.

    docs / kit / curl

Between devices and networks 11

  • c33

    Send anything live

    Stream a file, screen, camera or data from one device to another.

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

    Say this to your AI
    Send this file to my phone.

    Good to knowNothing is stored: sender and receiver must both connect, and the first waits up to 5 minutes by default. Set a sender key before sharing a live broadcast link.

    docs / kit / pipe

  • c34

    Desktop notifications

    Pop a notification on your computers' desktop from any script, and get it as an alert on your phone.

    Linkhttps://{p}-{c}-n-1.{node}.computers.hoody.com

    Say this to your AI
    Notify me on my phone when the build finishes.

    Good to knowTurn alerts on once in each device's browser. Delivery is best effort. On an iPhone, add the page to the Home Screen first.

    docs / kit / notifications

  • c35

    Put your laptop online

    Publish a server on your laptop at your computers' link for that port.

    Linkhttps://{p}-{c}-http-3000.{node}.computers.hoody.com

    Say this to your AI
    Put my local port 3000 online.

    Good to knowOpen to anyone with the port’s link until you set proxy permissions. Visitors use the port’s own link; the tunnel link only manages the tunnel.

    docs / kit / tunnel

  • c36

    Reach your laptop

    Let a computer reach a database or service on your laptop, while your laptop stays connected.

    Linkhttps://{p}-{c}-tunnel-1.{node}.computers.hoody.com

    Say this to your AI
    Let my Hoody app use the database on my laptop.

    docs / kit / tunnel

  • c37

    Choose where traffic exits

    Point an app at your computer's proxy link and its requests exit through a proxy you choose, or your own machine.

    Linkhttps://{p}-{c}-egress.{node}.computers.hoody.com

    Say this to your AI
    Route my scraper through my own proxy.

    Good to knowOpen to anyone with the link until you set proxy permissions on it.

    docs / kit / egress

  • c208

    Route computer traffic

    Route your computer's outbound TCP through a SOCKS5, HTTP or HTTPS proxy.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/network

    Say this to your AI
    Route this computer through my SOCKS5 proxy.

    Good to knowWhile a route runs, it carries TCP only. DNS goes to the platform resolver, and other outbound UDP and ICMP are blocked.

    docs / foundation / networking / network

  • c209

    Reconnect a dropped tunnel

    Resume your tunnel after a connection drop and keep its ports.

    Say this to your AI
    Keep my tunnel available after a brief network drop.

    Good to knowListeners stay up for 60 seconds by default. Open connections are cut during a drop.

    docs / kit / tunnel

  • c210

    Serve a local handler

    Expose your laptop's request handler without starting a separate server.

    Say this to your AI
    Expose this local request handler through my computer.

    Good to knowThe serve helper requires Bun. On Node, use expose with your own HTTP server.

    docs / kit / tunnel

  • c211

    Inspect tunnel bindings

    See your active tunnel sessions and the ports they bind.

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

    Say this to your AI
    Show me my tunnel sessions and their bindings.

    docs / kit / tunnel

  • c212

    Temporary proxy exit

    Set an upstream proxy that switches off unless your client renews it.

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

    Say this to your AI
    Use this proxy only while my client keeps renewing it.

    Good to knowLeases run from 5 to 3600 seconds. Existing HTTPS tunnels keep their original exit until they close.

    docs / kit / egress

  • c213

    Separate proxy credentials

    Give different clients their own credentials for your outbound proxy.

    Linkhttps://{p}-{c}-egress-1.{node}.computers.hoody.com

    Say this to your AI
    Give each client its own proxy credential.

    Good to knowEgress indexes share one upstream. Proxy permissions must be configured per index.

    docs / kit / egress

Live transfers 6

  • c214

    Browser transfer pages

    Send typed text, a file or a pasted image from your browser.

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

    Say this to your AI
    Open a browser page where I can send a pasted image.

    Good to knowThe browser must itself be allowed by the computer's access rule.

    docs / kit / pipe

  • c215

    Live broadcast viewers

    Broadcast your live stream while viewers join and leave as they like.

    Say this to your AI
    Broadcast this log so viewers can join while it runs.

    Good to knowUp to 256 viewers at a time. Viewers receive the stream from when they join; bytes sent with nobody watching are dropped.

    docs / kit / pipe

  • c216

    Forward a TCP port

    Carry a TCP connection between two machines through your pipes.

    Say this to your AI
    Reach my database from the other machine through a pipe.

    docs / kit / pipe

  • c217

    Two-way pipe

    Connect two WebSocket peers to exchange text and binary messages.

    Say this to your AI
    Connect these two programs for a two-way conversation.

    Good to knowA third peer gets 409.

    docs / kit / pipe

  • c218

    Transfer progress

    Watch your transfer's progress without taking a receiver slot.

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

    Say this to your AI
    Show me the progress of this transfer.

    docs / kit / pipe

  • c219

    Transfer checksums

    Check your transferred bytes against a server-calculated SHA-256 digest.

    Say this to your AI
    Send this disk image and verify its checksum.

    Good to knowA hashed or self-named transfer keeps its receipt for up to 10 minutes.

    docs / kit / pipe

Alerts and notifications 4

  • c220

    Live notification feed

    Stream notifications from your selected displays into a dashboard.

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

    Say this to your AI
    Stream display 1 notifications into my dashboard.

    Good to knowDisplay filtering is routing, not access control. Anyone who can reach the stream URL can request all displays.

    docs / kit / notifications

  • c221

    Notification history

    Read recent notifications from one or more of your displays.

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

    Say this to your AI
    Show me the recent notifications on display 1.

    Good to knowHistory excludes dismissed and expired notifications and keeps the newest 1,000 per history file.

    docs / kit / notifications

  • c222

    Choose notification urgency

    Set your notification's urgency and how long it stays visible.

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

    Say this to your AI
    Show a critical alert when the backup fails.

    Good to knowExpiry can be 0 to 300000 milliseconds. Each caller can send 10 notifications a minute.

    docs / kit / notifications

  • c223

    Manage alert devices

    List subscribed browsers and remove a device from your alerts.

    Say this to your AI
    Remove my old browser from notification alerts.

    Good to knowThe default limit is 50 push subscriptions per kit.

    docs / kit / notifications

Tools and full machines 16

  • c38

    VS Code in the browser

    Use full VS Code from any browser, phone included.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com

    Say this to your AI
    Open my project in VS Code.

    Good to knowExtensions come from Open VSX; others can be added as a .vsix file.

    docs / kit / code

  • c39

    Watch for file changes

    Get a live feed whenever files change.

    Linkhttps://{p}-{c}-watch-1.{node}.computers.hoody.com

    Say this to your AI
    Tell me whenever a new upload lands.

    Good to knowA watcher is lost when the watch service restarts, so create it again afterward.

    docs / api / watch

  • c40

    Find any app

    Find an app by name across many catalogs and get the command to run it.

    Linkhttps://{p}-{c}-run-1.{node}.computers.hoody.com

    Say this to your AI
    Find me a way to run Blender.

    docs / api / run

  • c41

    Traffic log

    See every request that reached your computers, live or after the fact.

    Linkhttps://{p}-{c}-logs-1.{node}.computers.hoody.com

    Say this to your AI
    Who opened my site today?

    Good to knowKeeps the last 7 days, up to 50,000 entries or 100 MB, per computer by default.

    docs / api / proxy-logs

  • c42

    Firewall

    Decide what can reach your computers and where they can connect.

    Say this to your AI
    Close my database port to outside connections.

    Good to knowIPv4 addresses and ranges only, no domain names. SSH through Hoody's SSH gateway is not affected by these rules.

    docs / foundation / networking / firewall

  • c43

    Linux software

    Install the Linux software you need. Computers share Hoody's kernel, so for another kernel use a virtual machine.

    Say this to your AI
    Install Postgres and set up a database for my app.

    docs / concepts / computers

  • c44

    Full virtual machines

    Run Windows or another Linux as a full virtual machine inside your computer.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com

    Say this to your AI
    Start a Windows 11 VM on my computer.

    Good to knowRented or dedicated servers only, with KVM turned on while the computer is stopped.

    docs / kit / vm

  • c224

    Find failed requests

    Filter your traffic log by service, path, HTTP status or request ID.

    Linkhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    Say this to your AI
    Find failed requests to my app today.

    Good to knowLog access follows the computer's proxy permissions and configured retention.

    docs / api / proxy-logs

  • c225

    Read logged bodies

    Request stored request or response bodies when examining your computer's traffic.

    Linkhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    Say this to your AI
    Show the logged response body for that request.

    Good to knowFields named like secrets are redacted before storage. Past 4 MiB of bodies in one page, the rest come without them.

    docs / concepts / auditing

  • c226

    Count traffic over time

    Count your matching proxy log entries in time buckets.

    Linkhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs/stats

    Say this to your AI
    Count my app's errors per hour today.

    Good to knowEach bucket is at least 60000 ms, with at most 240 buckets per window.

    docs / api / proxy-logs

  • c227

    Filter watched files

    Watch your selected paths and filter events by filename pattern or change type.

    Linkhttps://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers

    Say this to your AI
    Watch for new CSV files in my uploads folder.

    Good to knowWatchers do not survive a service restart. Exclude patterns take precedence over include patterns.

    docs / api / watch

  • c228

    Replay file changes

    Retrieve your watcher's retained file events after an event ID or timestamp.

    Linkhttps://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers/{id}/events

    Say this to your AI
    Show me retained file changes since this morning.

    Good to knowHistory is a ring buffer, so older events can be evicted. Watchers do not survive a service restart.

    docs / api / watch

  • c229

    Find listening ports

    List listening ports and see which programs and users own them.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/ports

    Say this to your AI
    Find the program listening on port 3000.

    docs / api / terminal / monitoring

  • c230

    Pause and resume work

    Pause a process or process tree and resume it with its memory state intact.

    Say this to your AI
    Pause my build and resume it later.

    Good to knowSome system and service PIDs are guarded and cannot be frozen or resumed through these endpoints.

    docs / api / terminal / monitoring

  • c231

    Server resource usage

    Inspect your server's CPU, memory and storage usage.

    Linkhttps://api.hoody.com/api/v1/rentals/{id}/runtime

    Say this to your AI
    Show me the CPU and memory usage on my server.

    Good to knowThe live call needs a signed-in session. A rented server shared with subservers returns 409.

    docs / foundation / servers

  • c232

    Pause firewall rules

    Disable an individual firewall rule and re-enable it when you need it.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/firewall/ingress

    Say this to your AI
    Temporarily disable this inbound firewall rule.

    Good to knowSSH through Hoody's SSH gateway is not affected by these rules.

    docs / foundation / networking / firewall

Code editor options 6

  • c233

    Open a folder by link

    Open any folder in your editor by link, without restarting it.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}

    Say this to your AI
    Open my project folder in the editor.

    Good to knowSend an absolute, already normalized path.

    docs / api / code

  • c234

    Separate team editors

    Give teammates separate editor instances that use the same computer's files.

    Say this to your AI
    Give us separate editors on the same project files.

    Good to knowThe editors have separate settings and extensions; shared cursors are not available.

    docs / guides / multiplayer

  • c235

    Separate editor instances

    Open separate editor instances with their own settings and extensions.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com/

    Say this to your AI
    Open a separate editor for my client project.

    Good to knowInstances share the computer's files and service account, so give people who do not trust each other separate computers.

    docs / kit / code

  • c236

    Extensions for every editor

    Add a VS Code extension file from a URL to every editor on your computer.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code/extensions/install

    Say this to your AI
    Stage this VSIX extension for my editor.

    Good to knowAn editor installs it only when it starts, so restart a running one with `restart=true`.

    docs / kit / code

  • c237

    Extension-only editor view

    Open an editor link focused on one extension's sidebar view.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&extension={extension}

    Say this to your AI
    Open the Python extension view on its own.

    Good to knowIf Code finds no matching sidebar view, it shows Explorer instead.

    docs / kit / code

  • c238

    Editor language choice

    Choose the display language for your editor when the instance starts.

    Linkhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&locale={locale}

    Say this to your AI
    Open my editor in Japanese.

    Good to knowStartup options take effect when the instance starts; a running instance needs `restart=true`.

    docs / api / code

Finding and running apps 4

  • c239

    Browse starter apps

    Browse tested starter apps and see where each opens.

    Linkhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/catalog

    Say this to your AI
    Show me the starter apps on my computer.

    docs / api / run / resolve

  • c240

    Preflight app launches

    Check an app's execution plan and missing requirements before running it.

    Linkhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/preflight

    Say this to your AI
    Check what is needed to run this app.

    docs / api / run / resolve

  • c241

    Save app recipes

    Save how you pick and run an app as a named recipe, then reuse it by name.

    Linkhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/recipes

    Say this to your AI
    Save my preferred Firefox selection as a recipe.

    docs / api / run / recipes

  • c242

    Batch app lookups

    Search for multiple apps or resolve their commands in one request.

    Linkhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/batch

    Say this to your AI
    Find launch commands for these ten apps.

    Good to knowA request lists at most 100 items. A longer request is refused as a whole with 400 `BATCH_TOO_LARGE`.

    docs / api / run / resolve

Virtual machines 14

  • c243

    VM screen in browser

    Open your virtual machine's screen and send it keys and clicks.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/display

    Say this to your AI
    Open my VM's screen so I can finish installing Linux.

    Good to knowThe VM needs its own configured display. Browser copy and paste is not supported, and the display has its own proxy permissions.

    docs / kit / vm

  • c244

    VM snapshots

    Snapshot your stopped VM before a risky change and restore it after.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/snapshots

    Say this to your AI
    Snapshot my VM before the operating system upgrade.

    Good to knowThe VM must be stopped. Restore replaces its disk, UEFI varstore and TPM state and has no undo.

    docs / kit / vm

  • c245

    VM installer downloads

    Download an installer image by URL for your virtual machine.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/isos/downloads

    Say this to your AI
    Download this Linux installer for my VM.

    Good to knowSupply the vendor's SHA-256 when available. Without it, the image is trusted on first use.

    docs / kit / vm

  • c246

    Pause a virtual machine

    Freeze your VM's CPUs and resume it with its memory intact.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/pause

    Say this to your AI
    Pause my test VM until I need it again.

    Good to knowA paused VM keeps its memory; stop it to release the memory.

    docs / kit / vm

  • c247

    VM port forwarding

    Forward a computer port to a service inside your virtual machine.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    Say this to your AI
    Forward port 2222 to SSH in my VM.

    Good to knowThe forward opens the host port on every address of the computer. Stop the VM to change forwards.

    docs / kit / vm

  • c248

    VM shared folder

    Share a folder between your computer and its virtual machine.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    Say this to your AI
    Give my VM a shared folder for project files.

    Good to knowVM snapshot exports do not include the shared folder's files.

    docs / kit / vm

  • c249

    Clone a VM disk

    Create a virtual machine from a copy of another VM's disk.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    Say this to your AI
    Clone my test VM so I can try the upgrade.

    Good to knowThe source VM must be stopped. The copy gets a new identity and TPM.

    docs / kit / vm

  • c250

    Move a virtual machine

    Export a VM snapshot and create a VM on another computer.

    Say this to your AI
    Move my test VM to my other computer.

    Good to knowShared-folder files are not included. Use the original disk bus and verify the destination before deleting the original.

    docs / kit / vm

  • c251

    Resize a VM

    Change your stopped VM's memory, CPUs and disk size for its next start.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    Say this to your AI
    Give my stopped VM more memory and CPUs.

    Good to knowThe VM must be stopped. Disk size only grows and must be sent alone.

    docs / kit / vm / reference

  • c252

    VM autostart

    Start your VM automatically when its computer comes back after a restart.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    Say this to your AI
    Start my VM automatically after the computer restarts.

    Good to knowAutostart is off by default. Updating it requires the VM to be stopped.

    docs / kit / vm

  • c253

    VM serial console

    Read your VM's serial console and send it commands by link.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/console

    Say this to your AI
    Read the console output from my VM's failed boot.

    Good to knowMany guest consoles are root shells, so treat write access like shell access.

    docs / kit / vm

  • c254

    Nested virtual machines

    Run hardware-accelerated virtual machines inside your VM for testing or CI.

    Say this to your AI
    Set up VM-based CI inside my guest.

    Good to knowRequires a dedicated server with nested virtualization enabled on request through Hoody support.

    docs / foundation / servers / virtual-machines

  • c255

    VM guest inventory

    Read your VM guest's operating system, network addresses and logged-in users.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/agent/inventory

    Say this to your AI
    Show me the IP addresses inside my VM.

    Good to knowThe guest agent must report the information. Unsupported or unavailable sections can be absent.

    docs / api / vm / console

  • c256

    Live VM events

    Stream your VM's state and snapshot events as they happen.

    Linkhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/events

    Say this to your AI
    Watch my VM for state and snapshot changes.

    Good to knowEvents are not replayed after a disconnect; reconnect and read the current state.

    docs / kit / vm

Also built in 10

  • c45

    Shared notes

    Write notes with tables, files and comments, and edit them together live.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com

    Say this to your AI
    Write up today's plan as a shared note.

    docs / api / notes

  • c46

    Your usual SSH

    Connect with your own SSH, SFTP or VS Code Remote.

    Typessh root@{p}-{c}-ssh.{node}.computers.hoody.com

    Say this to your AI
    Give me the SSH command for my computers.

    Good to knowPublic key only, one key per computer.

    docs / foundation / networking / ssh

  • c47

    Upload, search, zip

    Upload and search files, unpack archives and download folders as ZIP.

    Linkhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    Say this to your AI
    Zip the reports folder and give me a download link.

    Good to knowThe ZIP leaves out protected service state and holds up to 1,000,000 files.

    docs / kit / files

  • c48

    See what's running

    Check CPU, memory and disk activity at a glance, and list the programs running.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/resources Programs: use /api/v1/system/processes.

    Say this to your AI
    Why are my computers slow right now?

    docs / kit / terminals

  • c49

    Settings that stay

    Keep settings and keys as environment variables that survive restarts.

    Linkhttps://api.hoody.com/api/v1/computers/{c}/env

    Say this to your AI
    Set my app's API key as an environment variable.

    Good to knowRunning programs see a change after they restart. Anyone who can run commands in the computer can read them.

    docs / api / computer-env

  • c50

    Memory-fast storage

    Use fast memory-backed storage for caches and temporary work.

    Say this to your AI
    Put the build cache in RAM storage.

    Good to know512 MiB by default, at most half the server's memory, shared by all its computers. Wiped when the server reboots.

    docs / foundation / storage / ramdisk

  • c52

    VPN inside

    Run your VPN provider's WireGuard file inside a computer and keep its links working.

    Say this to your AI
    Connect this computer to my Mullvad VPN.

    Good to knowStart the WireGuard file with wg-quick, not the provider's app. Remove its IPv6 entries, keep Network Configuration routes stopped, and add an SSH key first.

    docs / foundation / networking / vpn

  • c53

    Record the desktop

    Record what happens on a desktop as a video file, right from the viewer.

    Linkhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?record=true

    Say this to your AI
    Record the desktop while the AI runs the demo.

    Good to knowYour browser records and saves it as MP4, WebM or GIF. A GIF stops at 30 seconds, and long recordings may stay in browser memory until saved.

    docs / kit / displays

  • c54

    Drop files into terminals

    Hand files to a program in a terminal as if you dragged them in.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/drop

    Say this to your AI
    Drop this screenshot into my Claude Code terminal.

    docs / api / terminal / file-drop

  • c257

    Secrets off disk

    Keep decrypted keys in memory so they never land on a disk, snapshot or backup.

    Say this to your AI
    Keep this decrypted credential in memory for the job.

    Good to knowFree server and paid subservers only. Lost when the host server reboots.

    docs / foundation / storage / ramdisk

Working with notes 8

  • c258

    Read a note as Markdown

    Get one note page as Markdown or HTML, whole or by line range.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document

    Say this to your AI
    Read my meeting notes page as Markdown.

    Good to knowReturns one page. For a page with its sub-pages, use the notebook export.

    docs / api / notes / nodes

  • c259

    Find recent notes

    See the notebook pages whose title or text changed most recently, newest first.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/recent

    Say this to your AI
    Show me the pages changed most recently.

    docs / api / notes / nodes

  • c260

    Append note blocks

    Add text or structured blocks to the end of your note.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document/append

    Say this to your AI
    Append today's meeting notes to that page.

    Good to knowUp to 100 blocks per request.

    docs / api / notes / nodes

  • c261

    Save note versions

    Capture your note as a version and restore it later.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

    Say this to your AI
    Save a version of this note before editing it.

    Good to knowRestoring saves the content it replaces as a new version.

    docs / api / notes / versions

  • c262

    Export notes as a ZIP

    Download your notebook, or one section, folder, page or database, as a Markdown or HTML ZIP.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/export

    Say this to your AI
    Export my notebook as a Markdown ZIP.

    Good to knowThe archive contains only items you can read. Channels and messages, database views and field definitions are left out.

    docs / api / notes / notebooks

  • c263

    Note collaborator roles

    Add a collaborator to your note and choose their role.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/collaborators

    Say this to your AI
    Add Sam as a collaborator on this note.

    Good to knowRoles are admin, editor, collaborator or viewer. You need admin permission on the page.

    docs / api / notes / collaborators

  • c264

    Filter note records

    Filter, sort or search by name the records in your notes database.

    Linkhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/databases/{databaseId}/records

    Say this to your AI
    Show my notes database records sorted by name.

    Good to knowThe list is paginated.

    docs / api / notes / databases

  • c265

    Resumable note uploads

    Upload a file to your notebook in resumable chunks.

    Say this to your AI
    Upload this large attachment to my notebook in chunks.

    Good to knowOnly the user who created the file node can upload to it.

    docs / api / notes / files

hoody / capabilities / bots

02 114 rows

Bots

The plain-English way to run all of Hoody. A Bot hands your task to a team of agents.

Your Bot 17

  • b01

    Your Bot

    One long-lived chat that runs all of Hoody in plain English.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}?realm={realm}

    Say this to your AI
    Ask my Bot to set up a blog for me.

    docs / api / agent / bots

  • b02

    Team of agents

    Hand off any task and a team of agents does it, then reports back.

    Say this to your AI
    Have a team of agents fix the failing tests and report back.

    docs / api / agent / bots

  • b03

    Never re-explain

    Your Bot keeps the conversation across messages; long ones may be summarised.

    Say this to your AI
    Pick up where we left off yesterday.

    docs / api / agent / bots

  • b04

    Rules and scope

    Choose which computers it may touch and the rules it must follow.

    Say this to your AI
    Only let my Bot work on my web projects, never push to main.

    Good to knowChanges reach new delegates only. Agents already running keep the limits they were given.

    docs / api / agent / bots

  • b05

    Share your Bot

    Share your Bot's .hoody.bot link with people you trust. They chat with it in any browser with their own key, no account needed.

    Linkhttps://<label>.hoody.bot

    Say this to your AI
    Give my cofounder access to my Bot.

    Good to knowEveryone shares one conversation, and every call runs on your credits or provider keys. Pause, revoke or restrict each key by address. Request limits apply to every key alike, and there is no spending cap yet. A Bot URL works over IPv4 only.

    docs / kit / agent / bot-urls

  • b06

    Your Bot in other AI apps

    Connect other AI apps and agents with your Bot's .hoody.bot URL and a named key.

    Linkhttps://<label>.hoody.bot/v1

    Say this to your AI
    Use my Hoody Bot as the model in this app.

    Good to knowThe Bot keeps its own shared conversation. Only the app's last message is used; its system prompt, tools and earlier messages are ignored.

    docs / kit / agent / bot-urls / calling

  • b07

    Talk to your Bot

    Speak to your Bot live, or send it a voice recording.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/voice

    Say this to your AI
    Let me talk to my Bot while I drive.

    Good to knowOne voice connection per Bot at a time, and speech has daily limits.

    docs / kit / agent / voice

  • b08

    Your Bot in voice apps

    Voice apps built on OpenAI Realtime, like LiveKit or Pipecat, can talk to your Bot.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/realtime

    Say this to your AI
    Connect my voice assistant to my Bot.

    Good to knowOne voice connection per Bot at a time.

    docs / api / agent / bots / voice

  • b10

    One Bot in every chat app

    Telegram, Slack and Discord all reach the same Bot and the same conversation.

    Say this to your AI
    Connect my Bot to our team's Slack too.

    Good to knowThe Bot reads text only. Files, images and voice messages are not passed on, only their caption or text. Anyone you pair shares the same conversation.

    docs / kit / agent / chat-apps

  • b29

    A model for each Bot

    Choose a model for your Bot's own replies.

    Say this to your AI
    Give my research Bot its own model.

    Good to knowThe tasks a Bot starts use the default model unless you turn on per-task models for that Bot.

    docs / kit / agent / ai-models

  • b30

    Separate Bot default

    Set a default model for Bots separately from your AI helper.

    Say this to your AI
    Use a different default model for my Bots.

    Good to knowBots that follow the default switch to it when their conversation restarts.

    docs / kit / agent / ai-models

  • b31

    Hands-free voice

    Talk hands-free while your Bot detects when you start and stop speaking.

    Say this to your AI
    Start a hands-free conversation with my Bot.

    Good to knowUse headphones. Full duplex lets you interrupt the reply by speaking.

    docs / kit / agent / voice

  • b32

    Voice with text replies

    Speak your question and read your Bot's answer without speech playback.

    Say this to your AI
    Let me speak to my Bot and read its replies.

    Good to knowSpeech-to-text still runs: Hoody Voice counts against your server's voice limits, and other providers bill for it.

    docs / kit / agent / voice

  • b33

    Choose worker agents

    Choose which agents your Bot may use for the work it hands off.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    Say this to your AI
    Let this Bot use only my reviewer agent.

    Good to knowAn empty list means any agent.

    docs / api / agent / bots

  • b34

    Check tasks against rules

    Have your Bot check each new task against its guardrails before starting.

    Say this to your AI
    Check new tasks against my Bot's guardrails.

    Good to knowA Bot in strict mode refuses every task while its checker cannot run.

    docs / kit / agent / ai-models

  • b35

    Automatic worker approvals

    Let your Bot's delegated agents receive tool approvals automatically.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    Say this to your AI
    Turn on automatic tool approvals for this Bot's workers.

    Good to knowOff by default. Workers then act without asking you first.

    docs / api / agent / bots

  • b36

    Daily speech budgets

    Set daily limits on how much your Bot speaks and transcribes.

    Say this to your AI
    Set a daily speech budget for my Bot.

    Good to knowDefaults are 200000 characters read aloud and 14400 seconds transcribed per UTC day.

    docs / api / agent / bots

Your Bot in chat apps 11

  • b37

    Pair chat app users

    Give someone a pairing code to talk to your Bot in a chat app.

    Say this to your AI
    Make a pairing code for Sam to talk to my Bot.

    Good to knowSet the direct message policy to pairing. A new code replaces the previous one.

    docs / kit / agent / chat-apps

  • b38

    Updates in a chat

    Send your Bot's completed work, approval requests and errors to a home chat.

    Say this to your AI
    Send my Bot's work updates to my direct messages.

    Good to knowThe home chat is one direct message or one approved group of the chat app.

    docs / kit / agent / chat-apps

  • b39

    Stop from chat

    Stop what your Bot is doing with a chat command.

    Say this to your AI
    Stop my Bot from Telegram.

    Good to knowThe sender needs the control right.

    docs / kit / agent / chat-apps

  • b40

    Choose chat rights

    Choose whether paired people can chat, run commands or decide approvals.

    Say this to your AI
    Let Sam chat with my Bot but not decide approvals.

    Good to knowOpen guests can only chat.

    docs / kit / agent / chat-apps / settings

  • b41

    Approve group chats

    Approve a group before its members can talk to your Bot.

    Say this to your AI
    Approve our project group to talk to my Bot.

    Good to knowEvery member of an approved group can read the Bot's answers.

    docs / kit / agent / chat-apps

  • b42

    Block chat users

    Drop messages from selected users across your Bot's chats.

    Say this to your AI
    Block this user from messaging my Bot.

    Good to knowA chat app's blocked user list holds at most 200 platform user IDs.

    docs / kit / agent / chat-apps / settings

  • b43

    Mirror replies to chat

    Send replies from your Bot's other access points to its home chat.

    Say this to your AI
    Mirror my Bot's app replies to its home chat.

    Good to knowThis setting is off by default.

    docs / kit / agent / chat-apps / settings

  • b44

    Pause all chat apps

    Pause every chat app connected to your Bot at once.

    Say this to your AI
    Pause all chat apps for my Bot.

    Good to knowEach chat app keeps its own enabled value.

    docs / kit / agent / chat-apps / settings

  • b45

    Choose reply format

    Choose rich formatting or plain text for your Bot's chat replies.

    Say this to your AI
    Send my Bot's replies as plain text.

    docs / kit / agent / chat-apps / settings

  • b46

    Chat message limits

    Set message rates for people and chats using your Bot.

    Say this to your AI
    Limit each person to ten Bot messages per minute.

    Good to knowBy default one person may send 10 messages a minute. 0 means no limit, up to 600.

    docs / kit / agent / chat-apps / settings

  • b47

    Chat notice language

    Choose a language for your Bot's chat app notices.

    Say this to your AI
    Show my chat app notices in French.

    Good to knowThe Bot's own answers are not translated. Available languages are en, de, fr, es, pt, it, ja and zh.

    docs / kit / agent / chat-apps / settings

Bot URL keys and limits 6

  • b48

    Bot status by key

    Check whether your Bot is working and see its pending approvals.

    Say this to your AI
    Check whether my Bot is working or waiting for approval.

    Good to knowA Bot URL key is required.

    docs / kit / agent / bot-urls / calling

  • b49

    Follow Bot events

    Follow your Bot's live events and resume from a saved cursor.

    Say this to your AI
    Follow my Bot's live events from the last cursor.

    Good to knowA Bot URL key is required. At most 4 streams can be open per key.

    docs / kit / agent / bot-urls / calling

  • b50

    Expiring Bot keys

    Give your Bot URL key an expiration time for temporary access.

    Linkhttps://api.hoody.com/api/v1/bot-urls/{id}/keys/{keyId}

    Say this to your AI
    Make Sam's Bot key expire at the end of December.

    docs / api / bot-urls

  • b51

    Bot URL access log

    Review which named keys called your Bot and from which addresses.

    Say this to your AI
    Check my Bot's access log for unexpected addresses.

    Good to knowBest effort: some refusals leave no line. The log never holds what was said or the key itself.

    docs / kit / agent / bot-urls / status

  • b52

    Limit Bot URL traffic

    Set request and concurrency limits for your Bot URL and its keys.

    Say this to your AI
    Lower the per-key request limit on my Bot URL.

    Good to knowThe per-key setting applies to every key. Limits count requests, not money.

    docs / kit / agent / bot-urls / security

  • b53

    Revoke all Bot keys

    Turn off your Bot URL and revoke all its keys at once.

    Linkhttps://api.hoody.com/api/v1/bot-urls/{id}/panic

    Say this to your AI
    Turn off my Bot URL and revoke all its keys.

    Good to knowA call already running finishes, and work the Bot already started continues until you stop it.

    docs / kit / agent / bot-urls / security

The agent in your computers 22

  • b11

    Hoody Agent in all your computers

    An AI agent lives in your computers: open it in a tab, by ssh or the CLI.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    Say this to your AI
    Open my Hoody agent.

    docs / kit / agent

  • b12

    Sessions that keep going

    Close the tab and your AI keeps working; pick it up on any device.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    Say this to your AI
    Keep working on this while I am away.

    docs / kit / agent

  • b13

    Any model

    Pick from 100+ AI providers or add your own model server.

    Say this to your AI
    Switch this chat to a faster model.

    Good to knowYour own model server must speak the OpenAI or Anthropic API at a public HTTPS address.

    docs / kit / agent

  • b14

    Many models at once

    Ask several models at once and get one combined answer.

    Say this to your AI
    Ask three models and give me the best answer.

    docs / kit / agent / ai-models

  • b15

    GitHub built in

    Clone, commit and open pull requests straight from your agent.

    Say this to your AI
    Open a pull request with this fix.

    docs / kit / agent

  • b16

    Add tools to your AI

    Connect MCP servers to give your agent new tools.

    Say this to your AI
    Add my team's MCP server to my agent.

    Good to knowA local server runs with your privileges and is not sandboxed, and a remote server receives the headers you give it. Add only servers you trust.

    docs / kit / agent

  • b17

    Memory any AI can use

    Your agent saves and searches memory, not locked to one AI app.

    Say this to your AI
    Remember that my site uses Postgres.

    docs / api / agent / memory

  • b18

    Skills

    Install skills that teach your agent new jobs.

    Say this to your AI
    Install a skill for writing release notes.

    docs / api / agent / skills

  • b19

    AI on a schedule

    Have your agent check in and act on a schedule.

    Say this to your AI
    Every hour today, check my site and tell me if anything broke.

    Good to knowRepeats at a set interval of 1 minute or more, 50 runs by default (you can set another number), and up to 8 active loops. It stops when its chat closes or the agent restarts. For a lasting schedule, use cron.

    docs / api / agent / loops

  • b20

    Saved AI workflows

    Save AI workflows and run them again whenever you want.

    Say this to your AI
    Save this as a workflow I can run again.

    docs / api / agent / workflows

  • b21

    Your AI's to-do list

    See the tasks your AI has lined up and what it is working on.

    Say this to your AI
    What's on your to-do list for my project?

    docs / api / agent / todos

  • b22

    Branch a chat

    Fork a chat to try another approach and keep the first one.

    Say this to your AI
    Fork this chat and try it with a different design.

    docs / api / agent / sessions

  • b23

    See your AI usage

    See how much AI each chat and each model used.

    Say this to your AI
    How much AI did I use this week?

    docs / api / agent / statistics

  • b24

    Jobs without a chat

    Send your agent a job and collect the result later, no chat needed.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    Say this to your AI
    Run this report in the background and give me a job I can check later.

    Good to knowA headless job approves every confirmation by itself and can run commands on the computer, so lock the agent's link with proxy permissions first. You fetch the result from the job.

    docs / api / agent / headless

  • b25

    Hooks on agent events

    Run your own commands when your agent starts, uses a tool or finishes, Claude Code style.

    Say this to your AI
    Don't let my agent finish until the tests pass.

    Good to knowEdited hooks wait for your OK before they run.

    docs / api / agent / hooks

  • b26

    Your own agents

    Make your own agents, each with its own model, tools and instructions.

    Say this to your AI
    Make a read-only reviewer agent that uses a cheap model.

    docs / api / agent / agents

  • b27

    Ask before acting

    Make your agent ask you before every action that changes something.

    Say this to your AI
    Ask me before you change or run anything.

    Good to knowReads pass without asking. Subagents, workflow runs and other nested runs that cannot ask are refused, your hooks are skipped and MCP servers are not started. A locked mode stays on for the whole session.

    docs / api / agent / sessions / approvals

  • b28

    Approve from your phone

    When your Bot's agents ask before a risky step, tap Approve or Deny in Telegram, Slack or Discord.

    Say this to your AI
    Ask me in Telegram before you deploy anything.

    Good to knowOnly people you allow can press the buttons.

    docs / kit / agent / chat-apps / approvals

  • b54

    Plan before building

    Switch your agent to plan mode to design work before implementing it.

    Say this to your AI
    Plan the architecture before you build the app.

    Good to knowSwitch back to the general agent to build from the plan.

    docs / guides / vibe-coding

  • b55

    Live app preview

    Watch your app preview update as your agent changes its files.

    Say this to your AI
    Start a live preview while you build my app.

    Good to knowThe documented workflow starts a Vite development server and opens it in a browser on the computer's display.

    docs / guides / vibe-coding

  • b56

    Explore without edits

    Use explore mode to investigate your code with read-only tools.

    Say this to your AI
    Explore this codebase and explain how login works.

    docs / guides / vibe-coding / reference

  • b57

    Stream agent work

    Watch your agent's tool calls, results and messages as a turn runs.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{session_id}/prompt:stream

    Say this to your AI
    Show me the agent's tool calls as it works.

    Good to knowWith no proxy permissions configured, the computer's URL itself is the credential.

    docs / guides / ai-agents

Agent sessions 14

  • b58

    Rename a chat

    Give your agent session a title that makes it easier to find.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}

    Say this to your AI
    Rename this chat to Release planning.

    Good to knowTitles are capped at 120 characters.

    docs / api / agent / sessions

  • b59

    Read a chat transcript

    Retrieve your saved conversation, including tool calls and their results.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/transcript

    Say this to your AI
    Show me the transcript of my last session.

    docs / api / agent / sessions / streaming

  • b60

    Trim a conversation

    Remove later turns from your session and continue from an earlier point.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/trim

    Say this to your AI
    Trim this chat back to the turn before my last request.

    Good to knowWorks between turns only, not while a turn runs.

    docs / api / agent / sessions

  • b61

    Watch several sessions

    Follow events from up to 32 live sessions in one stream.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions:events

    Say this to your AI
    Monitor these agent sessions together.

    Good to knowOnly live sessions can be watched.

    docs / api / agent / sessions / streaming

  • b62

    Adjust reasoning effort

    Choose how much reasoning effort your session's model should use.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/effort

    Say this to your AI
    Set this session's reasoning effort to high.

    Good to knowLevels are low, medium, high, xhigh and max.

    docs / api / agent / sessions / settings

  • b63

    Shorter agent replies

    Set your session's response verbosity to match how much detail you want.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/verbosity

    Say this to your AI
    Make this session's replies concise.

    docs / api / agent / sessions / settings

  • b64

    Pending agent questions

    See the questions and confirmations waiting for you across your sessions.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/gates

    Say this to your AI
    Show me which agent sessions need my input.

    Good to knowOnly sessions this agent holds live are listed.

    docs / api / agent / sessions / approvals

  • b65

    Allow or deny a tool

    Set a session rule to allow or deny a particular agent tool.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/approval/rules/{tool}

    Say this to your AI
    Deny this tool for the current session.

    Good to knowAn allow rule is refused when the session's policy is locked or asks before every action.

    docs / api / agent / sessions / approvals

  • b66

    Suggested question answers

    Get a helper model's proposed answers to your agent's parked question.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/answer:assist

    Say this to your AI
    Suggest answers to the question my agent is waiting on.

    Good to knowThe suggestion does not answer the question; the real answer is sent separately.

    docs / api / agent / sessions / approvals

  • b67

    Guide a running workflow

    Send feedback to your workflow while it is running.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/workflow/messages

    Say this to your AI
    Tell the running workflow to focus on the release notes.

    Good to knowUse only while a workflow is running. Messages sent while a gate is parked are discarded and must be sent again after the turn ends.

    docs / api / agent / sessions / turns

  • b68

    Check a turn's outcome

    Look up your turn's state and outcome after a disconnect or restart.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/turns/{turn_id}

    Say this to your AI
    Check whether my last agent turn finished.

    Good to knowWorks for live and dormant sessions.

    docs / api / agent / sessions / turns

  • b69

    Wait for another session

    Have your session wait for a named outcome in another session's work.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/waiters

    Say this to your AI
    Wait for the other session to report that the build finished.

    Good to knowThe target must be another live session in the same realm. A waiter does not survive an agent restart.

    docs / api / agent / sessions / waiters

  • b70

    Instructions after summaries

    Reintroduce your chosen instructions whenever the agent compacts a conversation.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/after-compaction

    Say this to your AI
    Remind the agent to run tests after every conversation summary.

    Good to knowAt most 16 KiB. Not available on Claude Code sessions.

    docs / api / agent / sessions / settings

  • b71

    Pause agent work

    Pause your agent's sessions and resume them where they stopped.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/pause

    Say this to your AI
    Pause my agent until I'm ready to continue.

    Good to knowThe pause covers every session in every realm. Work already running finishes first, and some independent Claude Code work is not held.

    docs / api / agent / system

Agent memory 4

  • b72

    Switch memory off

    Turn your agent's memory privacy switch on or off.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/enabled

    Say this to your AI
    Turn off memory for this realm.

    docs / api / agent / memory

  • b73

    Edit a memory

    Update a saved memory record while keeping fields you leave out.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items/{id}

    Say this to your AI
    Update my saved project preference to use TypeScript.

    docs / api / agent / memory

  • b74

    Delete saved memories

    Remove one or several specific records from your agent's memory.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items

    Say this to your AI
    Delete these outdated memory records.

    Good to knowDeleting individual records does not erase project summaries, relation graphs, or consolidation residue.

    docs / api / agent / memory

  • b75

    View memory relationships

    Explore the nodes and connections in your project's memory graph.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/graph

    Say this to your AI
    Show me the relationships in this project's memory.

    docs / api / agent / memory

Background work 9

  • b76

    Run a loop now

    Trigger your scheduled agent loop immediately without waiting for its next interval.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}/run-now

    Say this to your AI
    Run my scheduled check now.

    Good to knowA paused loop fires once and remains paused. A loop paused by the circuit breaker resumes its schedule.

    docs / api / agent / loops

  • b77

    Set loop budgets

    Set cost and time ceilings for your recurring agent loop.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}

    Say this to your AI
    Set a cost and time budget for this loop.

    Good to knowEach update changes one thing: pause state, expiry or budgets. 0 removes a ceiling.

    docs / api / agent / loops

  • b78

    Stop loops on conditions

    Set your recurring agent loop to stop when a chosen condition is met.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops

    Say this to your AI
    Repeat this check until its stop condition is met.

    Good to knowThe minimum accepted interval is 60 seconds. Omitted, 0, or negative max_runs applies the default ceiling of 50 runs.

    docs / api / agent / loops

  • b79

    Stream headless runs

    Receive your headless agent run as a live stream of events.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/headless/runs

    Say this to your AI
    Run this task headlessly and stream its progress.

    Good to knowHeadless runs auto-approve confirmations, plans, and questions and can execute code. Protect the agent URL with proxy permissions.

    docs / api / agent / headless

  • b80

    Cancel an agent job

    Stop a pending or running asynchronous agent job.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jobs/{id}

    Say this to your AI
    Cancel that agent job.

    Good to knowDeleting a finished job removes its historical record.

    docs / api / agent / jobs

  • b81

    Read subagent transcripts

    Inspect the transcript and summary of your background subagent's task.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/transcript

    Say this to your AI
    Show me what the background reviewer did.

    docs / api / agent / tasks

  • b82

    Cancel a subagent task

    Stop one background subagent task while your session is working.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/cancel

    Say this to your AI
    Cancel the background research task.

    Good to knowThe session must be live.

    docs / api / agent / tasks

  • b83

    See and stop background shells

    List the background shells your agent session started, and stop one.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/bash-jobs

    Say this to your AI
    Show me the background shells this session started.

    docs / api / agent / tasks

  • b84

    Pause a hook

    Disable or re-enable one of your agent's lifecycle hooks.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hooks/toggle

    Say this to your AI
    Turn off my lint hook.

    Good to knowNeeds a live agent session.

    docs / api / agent / hooks

Skills, workflows and tasks 10

  • b85

    Import existing skills

    Bring selected Claude or Codex skills into your agent's local skill store.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/import/apply

    Say this to your AI
    Import my existing Claude skills into my agent.

    Good to knowScan for skills first. Existing destinations are refused unless overwrite is requested.

    docs / api / agent / skills

  • b86

    Preview a skill

    Preview a skill from the hub before installing it on your computer.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/hub/preview

    Say this to your AI
    Preview the release notes skill before installing it.

    Good to knowThe preview requires the provider, source and skill ID from a search result.

    docs / api / agent / skills

  • b87

    Turn skills off

    Disable a skill by name and enable it again when you need it.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/toggle

    Say this to your AI
    Disable my web search skill for now.

    docs / api / agent / skills

  • b88

    Edit skill instructions

    Read and replace a skill's source to change what your agent learns.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/source

    Say this to your AI
    Update my release notes skill with our new format.

    docs / api / agent / skills

  • b89

    Resume a workflow

    Continue a failed or canceled workflow from its first incomplete step.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}/resume

    Say this to your AI
    Resume the failed workflow where it left off.

    Good to knowThe live session must be idle and match the run's realm, owner, working directory and computer. A run is resumable once.

    docs / api / agent / workflows

  • b90

    Inspect workflow steps

    See each workflow step's status, duration, token use and errors.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}

    Say this to your AI
    Show me which step failed in that workflow.

    Good to knowRuns are available only while retained.

    docs / api / agent / workflows

  • b91

    Run a task

    Start a background worker to work autonomously on your task.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/run

    Say this to your AI
    Start a worker on this task.

    Good to knowThe request counts as human approval and the worker asks for no further confirmation. Check the task itself for completion.

    docs / api / agent / todos

  • b92

    Filter your tasks

    Find tasks by state, tag or search text in your agent's list.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos

    Say this to your AI
    Show me my open tasks tagged billing.

    docs / api / agent / todos

  • b93

    Snooze a task

    Snooze a task until a wake time or clear its existing snooze.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/snooze

    Say this to your AI
    Snooze this task until tomorrow.

    docs / api / agent / todos

  • b94

    Comment on a task

    Add a comment to your task's timeline without starting another agent turn.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/messages

    Say this to your AI
    Add this customer detail to the task.

    docs / api / agent / todos

GitHub from your agent 6

  • b95

    Review repository changes

    Read your repository's staged or unstaged changes as a unified diff.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/diff

    Say this to your AI
    Show me the staged changes in my repository.

    Good to knowCaptured output is capped at 1 MiB.

    docs / api / agent / github

  • b96

    Draft commit messages

    Have a model draft a commit message from your pending repository changes.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/commit/suggest-message

    Say this to your AI
    Suggest a commit message for my changes.

    Good to knowThe diff is sent to the model's provider and the call is billed. It does not commit.

    docs / api / agent / github

  • b97

    GitHub issues

    List repository issues or open a new issue from your agent.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/issues

    Say this to your AI
    Open an issue for the broken login page.

    Good to knowIssue lists return at most 200 issues, sorted by most recently updated.

    docs / api / agent / github

  • b98

    Linked worktrees

    Create a linked worktree to work with another branch of your repository.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/worktrees

    Say this to your AI
    Create a worktree for my feature branch.

    docs / api / agent / github

  • b99

    GitHub account switching

    Switch the linked GitHub account used for your agent's subsequent operations.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/auth/active

    Say this to your AI
    Switch my agent to my work GitHub account.

    Good to knowThe account must already be linked.

    docs / api / agent / github

  • b100

    Check remote branch

    Check which commit a GitHub branch points to without changing your checkout.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/remote-branch

    Say this to your AI
    Check whether my last push reached the remote branch.

    Good to knowIt reads GitHub with your active account and changes nothing in your checkout.

    docs / api / agent / github

Agent setup 15

  • b101

    Set AI spend caps

    Set chat and turn spending caps that stop work or warn you.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/spend-caps

    Say this to your AI
    Set a spending cap for my agent's chats.

    Good to knowCaps are in US dollars, from 0 (off) to 1000000. Work already running is never stopped.

    docs / api / agent / settings

  • b102

    Rotate provider accounts

    Your agent switches to another signed-in account of a provider when one hits its limit.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/features

    Say this to your AI
    Turn on account rotation for my agent.

    docs / api / agent / settings

  • b103

    Import MCP settings

    Bring MCP server definitions from Claude, Cursor or VS Code into your agent.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/import

    Say this to your AI
    Import my MCP server settings from Cursor.

    Good to knowImported servers start disabled. One invalid entry stops the whole import.

    docs / api / agent / mcp

  • b104

    Test an MCP server

    Test a server configuration and see its tools before saving it.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/probe

    Say this to your AI
    Test this MCP server configuration before I save it.

    Good to knowProbing is human-only and can start a process or make an outbound request.

    docs / api / agent / mcp

  • b105

    Disable an MCP server

    Turn off one MCP server while keeping its saved settings and credentials.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/servers/enable

    Say this to your AI
    Disable my issue tracker MCP server for now.

    Good to knowDisabling cuts the server off in every live session right away.

    docs / api / agent / mcp

  • b106

    Realm-wide instructions

    Set instructions shared by your realm's chats, helpers and workflow steps.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/agent-instructions

    Say this to your AI
    Tell every agent in this realm to use American English.

    Good to knowRunning chats get the change from their next turn.

    docs / api / agent / settings

  • b107

    Copy an agent

    Copy an agent's definition under a new name to make your own variation.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/copy

    Say this to your AI
    Copy my reviewer agent so I can customize it.

    Good to knowCopying onto the product-owned Bot agent's name is refused.

    docs / api / agent / agents

  • b108

    Set agent turn limits

    Set the maximum number of turns one of your agents takes per run.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/turns

    Say this to your AI
    Set a turn limit for my reviewer agent.

    Good to knowThe Bot agent cannot be changed this way.

    docs / api / agent / agents

  • b109

    Restore agent defaults

    Restore a shipped agent's original definition after customizing it.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/reset-to-shipped

    Say this to your AI
    Reset this agent to its shipped default.

    Good to knowResetting discards local customizations.

    docs / api / agent / agents

  • b110

    Copy Claude settings

    Preview and copy Claude Code configuration between your computers.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/acp/agents/{agent}/file-syncs

    Say this to your AI
    Copy my Claude Code settings to my other computer.

    Good to knowAt most 200 files, 8 MiB in all and 2 MiB per file. Credential files and state carrying logins or conversations are excluded.

    docs / api / agent / settings

  • b111

    Test a provider key

    Check whether your stored provider API key is valid without revealing it.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/providers/{id}/auth/test

    Say this to your AI
    Test my stored provider key.

    Good to knowThe verdict can be valid, invalid or inconclusive. The key must already be stored.

    docs / api / agent / models

  • b112

    Usage by account

    See your AI usage grouped by provider and account, all time or since a date.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/usage/by-account

    Say this to your AI
    Show my AI usage by account since Monday.

    Good to knowUsage is global, not scoped to a realm. Omit the start time for all-time usage.

    docs / api / agent / statistics

  • b113

    Choose agent realm

    Select the realm your agent uses by default for new sessions.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hoody/realm

    Say this to your AI
    Use my work realm for new agent sessions.

    Good to knowThe selection applies to every client. Existing sessions keep their own realm, and a realm-limited login can select only an allowed realm.

    docs / api / agent / discovery

  • b114

    Search agent logs

    Filter your agent logs by session, time, level, or text.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs

    Say this to your AI
    Find errors in this agent session from the last hour.

    Good to knowUp to 500 entries per page, 200 by default.

    docs / api / agent / logs

  • b115

    Export redacted logs

    Download your filtered agent logs as redacted JSONL or text.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs/export

    Say this to your AI
    Export the agent errors as a redacted text file.

    Good to knowExports are always redacted. A platform-source export holds one page, 2000 rows by default.

    docs / api / agent / logs

hoody / capabilities / api

03 64 rows

API

Anything you can do in Hoody, your AI or a script can do too.

Build on Hoody 13

  • a01

    One API for everything

    Anything you can do in Hoody, your AI or a script can do too.

    Linkhttps://api.hoody.com

    Say this to your AI
    Use the Hoody API to set this up for me.

    docs / foundation / hoody-api

  • a02

    Computers on demand

    Your AI creates computers in your projects, then starts, stops or deletes them.

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

    Say this to your AI
    Add computers for this client project.

    docs / foundation / computers / create-edit-delete

  • a03

    Copy a setup

    Duplicate one of your computers into another project or server.

    Linkhttps://api.hoody.com

    Say this to your AI
    Make a copy of my staging setup.

    Good to knowThe copy gets no SSH key. Firewall rules, proxy aliases and snapshots stay with the source.

    docs / foundation / computers / copy-sync

  • a04

    Debian 13, ready to go

    Your computers start on Debian 13, with dev tools ready.

    Linkhttps://api.hoody.com

    Say this to your AI
    Set up new computers for my side project.

    docs / foundation / computers / images

  • a05

    Projects and realms

    Group computers into projects, and limit what each token can see and control with realms.

    Linkhttps://api.hoody.com

    Say this to your AI
    Make sure this client's token only sees their project.

    docs / concepts / realms-projects

  • a06

    Tokens for automation

    Give scripts and AIs their own tokens, limited to what they need.

    Linkhttps://api.hoody.com

    Say this to your AI
    Make a token for my deploy script that expires in 30 days and only works from my server's IP.

    docs / foundation / hoody-api / authentication

  • a07

    Command line

    Run most of Hoody from the `hoody` command on your laptop.

    Typecurl -fsSL https://install.hoody.com | sh

    Say this to your AI
    Install the Hoody CLI and log me in.

    Good to knowA few things, like running a cron job now, need the SDK or the HTTP API.

    docs / foundation / cli

  • a08

    Open source SDK

    Build on Hoody from TypeScript with the open source SDK.

    Typenpm install hoody-sdk

    Say this to your AI
    Write a script with the Hoody SDK that lists my computers.

    docs / getting-started / quickstart

  • a09

    A manual for any AI

    Any AI can read one manual and learn to use Hoody.

    Linkhttps://hoody.com/SKILLS/

    Say this to your AI
    Read hoody.com/SKILLS and set me up.

    Good to knowYour AI needs to run code with network access to sign you in.

    docs / foundation / agent-skill-bundle

  • a19

    Copy from a snapshot

    Create an independent computer from a chosen snapshot of your source.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/copy

    Say this to your AI
    Create a staging computer from my tested snapshot.

    Good to knowThe copy takes the source computer's current environment variables. Snapshot history and SSH keys are not copied.

    docs / foundation / computers / copy-sync

  • a20

    Copy network rules

    Carry your computer's firewall and network rules into a new copy.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/copy

    Say this to your AI
    Copy my staging computer with its firewall and network rules.

    Good to knowRules are not copied by default. A network or startup failure can leave the copy stopped.

    docs / foundation / computers / copy-sync

  • a21

    Merge environment variables

    Update several environment variables without removing your other settings.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/env

    Say this to your AI
    Set the database URL and log level on my computer.

    Good to knowOne request takes 1 to 256 variables. Running processes do not pick up changes until they re-exec.

    docs / api / computer-env

  • a22

    Computer status history

    Inspect your computer's state changes to investigate unexpected stops or slow starts.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/status-logs

    Say this to your AI
    Show me when my computer stopped and what triggered it.

    docs / foundation / computers / managing

Projects, tokens and sign-in 11

  • a23

    Project access levels

    Grant another user read, edit or delete access to your project.

    Linkhttps://api.hoody.com/api/v1/projects/{id}/permissions

    Say this to your AI
    Give Sam read access to my project.

    Good to knowYou must be the owner or have edit permission. Access applies immediately.

    docs / api / projects

  • a24

    Project computer quotas

    Set a computer limit for your project when you create or update it.

    Linkhttps://api.hoody.com/api/v1/projects/{id}

    Say this to your AI
    Limit this project to five computers.

    Good to knowYou must be the owner or have edit permission. The minimum quota is 0.

    docs / api / projects

  • a25

    Project resource statistics

    Get resource statistics for each computer in your project in one response.

    Linkhttps://api.hoody.com/api/v1/projects/{id}/stats

    Say this to your AI
    Show resource usage for the computers in my project.

    Good to knowA computer whose statistics could not be read can have a placeholder entry.

    docs / api / projects

  • a26

    Monthly project traffic

    Get monthly proxied request counts and response bytes across your project.

    Linkhttps://api.hoody.com/api/v1/projects/{id}/proxy-usage

    Say this to your AI
    Show my project's proxied traffic for the last three months.

    Good to knowRequest at most 12 months. Totals can be incomplete and exclude deleted computers, direct SSH, raw egress and other traffic.

    docs / api / projects

  • a27

    Inspect your current token

    Check the permissions and realm restrictions of your current API token.

    Linkhttps://api.hoody.com/api/v1/auth/tokens/me

    Say this to your AI
    Show me what my current token can access.

    docs / api / auth-tokens

  • a28

    Token permission templates

    List permission templates and their resolved permissions before creating your token.

    Linkhttps://api.hoody.com/api/v1/auth/tokens/templates

    Say this to your AI
    Show me the available token permission templates.

    docs / api / auth-tokens

  • a29

    Copy token permissions

    Create a token with another token's permissions, realms and IP whitelist.

    Linkhttps://api.hoody.com/api/v1/auth/tokens/{id}/copy

    Say this to your AI
    Copy this token's restrictions into a new token.

    Good to knowThe copy has a new secret value.

    docs / api / auth-tokens

  • a30

    Adjust token realms

    Add or remove a realm from an existing restricted token.

    Say this to your AI
    Add the staging realm to this token.

    Good to knowThe last realm of a realm-restricted token cannot be removed.

    docs / api / auth-tokens

  • a31

    Count resources by realm

    List your realms with counts of projects, computers, servers and tokens.

    Linkhttps://api.hoody.com/api/v1/realms/?include_usage=true

    Say this to your AI
    Count the resources in each of my realms.

    Good to knowThe request requires resources.realms permission.

    docs / api / realms

  • a32

    Device code sign-in

    Start a device sign-in with a short code your user can type.

    Linkhttps://api.hoody.com/api/v1/auth/device/code

    Say this to your AI
    Start a device code sign-in for my app.

    Good to knowThe flow is inspired by RFC 8628 but is not a standards-compliant device grant.

    docs / api / authentication

  • a33

    App identity claims

    Prove to your app that Hoody signed in this user, checked offline with a public key.

    Linkhttps://api.hoody.com/api/v1/users/auth/identity-claim

    Say this to your AI
    Issue an identity claim for my app.

    Good to knowSigned-in sessions only, not auth tokens. Claims last one hour by default and never outlast your session.

    docs / api / authentication

Command line tools 5

  • a34

    CLI account profiles

    Switch CLI settings and sign-ins between your accounts or environments.

    Say this to your AI
    Set up a separate CLI profile for staging.

    docs / foundation / cli

  • a35

    Preview CLI requests

    See the HTTP request a CLI command would send, or get it as a curl line.

    Say this to your AI
    Show me the HTTP request for deleting this computer.

    Good to knowSecret values are redacted and some bodies are withheld. A name lookup can still send a GET request.

    docs / foundation / cli

  • a36

    Wait for CLI operations

    Have your script wait for a long-running operation to finish.

    Say this to your AI
    Copy this computer and wait until the copy finishes.

    Good to knowThe default wait timeout is 10 minutes.

    docs / foundation / cli / reference

  • a37

    Watch CLI lists

    Refresh a CLI list repeatedly as your resources change.

    Say this to your AI
    Watch my computer list update every five seconds.

    Good to knowRequires an interactive terminal. The default interval is 2 seconds.

    docs / foundation / cli / reference

  • a38

    Lock local CLI credentials

    Encrypt your saved CLI tokens and default IDs with a password.

    Say this to your AI
    Protect my saved CLI credentials with a password.

    Good to knowTurning the lock on deletes any saved account password.

    docs / foundation / cli / reference

Agent building blocks 4

  • a39

    One-off model replies

    Get one model reply for your app, as JSON or streamed, with no agent session.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/completions

    Say this to your AI
    Get a one-off model reply for this text.

    Good to knowNo session, transcript or tool use. Every call is billed.

    docs / api / agent / models

  • a40

    Run a tool directly

    Call an agent tool directly and receive its result in your application.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools/{name}/run

    Say this to your AI
    Call this agent tool and return its result.

    Good to knowA tool that changes something runs only when you opt in, and it may ask for confirmation first. Runs on this computer only.

    docs / api / agent / tools

  • a41

    Inspect agent tools

    List your agent's built-in tools and inspect their input schemas.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools

    Say this to your AI
    Show me the inputs for the agent's built-in tools.

    docs / api / agent / tools

  • a42

    Watch agent data changes

    Stream change notifications so your app can refresh affected agent data.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/changes/stream

    Say this to your AI
    Update my dashboard when agent data changes.

    Good to knowTokens only say which lists changed; your app re-reads those lists.

    docs / api / agent / changes

Your apps and AI models 14

  • a10

    Embed live tools

    Put a live terminal, desktop, editor or database in your own page.

    Linkhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com in an iframe

    Say this to your AI
    Show my live terminal inside my dashboard page.

    Good to knowSet proxy permissions before you embed a link others can see.

    docs / guides / embed-urls

  • a11

    Your Exec script on every request

    Matching requests go to your Exec script first: check, change or answer them.

    Say this to your AI
    Add a check that blocks requests without my header.

    Good to knowWebSocket upgrades on a matching path are refused, so keep those paths out of the match. A hook times out after 500 ms unless you set up to 30 seconds.

    docs / foundation / proxy / hooks

  • a12

    AI models by link

    Call many AI models from your computers with no API key.

    Say this to your AI
    Use a cheap model to tag these 1,000 photos.

    Good to knowPaid models bill your AI Balance per use, and free ones have limits per server. No OpenAI, Anthropic or Google models.

    docs / foundation / hoody-ai

  • a13

    Watch your AI calls

    Route your AI calls through an Exec script to log, cache or change them.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    Say this to your AI
    Log every AI call my app makes.

    docs / foundation / hoody-ai / mitm

  • a14

    Speech in and out

    Turn text into speech and speech into text.

    Linkhttps://ai.hoody.com/api/v1/audio/speech · `.../audio/transcriptions`

    Say this to your AI
    Read this article out loud as an audio file.

    Good to knowFree within your server's voice limits, from inside your computers.

    docs / foundation / hoody-ai / usage

  • a16

    Free web search

    Code in your computers can search the web with no API key, free within your server's limits.

    TypePOST https://ai.hoody.com/api/v1/coding_plan/search

    Say this to your AI
    Search the web for how others fixed this error.

    Good to knowFree within your server's limits, from inside your computers.

    docs / foundation / hoody-ai / usage

  • a17

    Yes/no answers from AI

    Ask Hoody AI yes/no, pick-one or score questions and get back how likely each answer is.

    TypePOST https://ai.hoody.com/api/v1/decisions

    Say this to your AI
    Have AI decide if each support ticket is urgent.

    Good to knowFree within your server's limits, from inside your computers.

    docs / foundation / hoody-ai / decisions

  • a18

    AI switch per computer

    Turn AI on or off for each computer, and see what each one used.

    Say this to your AI
    Turn off AI on my client's computer.

    docs / foundation / hoody-ai / security

  • a43

    Open a specific view

    Build a link to your chosen file editor, terminal session or database table view.

    Say this to your AI
    Make a link to the users table view.

    Good to knowSome views require parameters, and views that refuse framing must be opened in a new tab.

    docs / guides / embed-urls

  • a44

    Import an API

    Turn another API's OpenAPI document into script endpoints that forward calls.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/sdk/import

    Say this to your AI
    Import this API specification as script endpoints.

    docs / kit / exec / reference

  • a45

    Document script APIs

    Generate an OpenAPI specification for your scripts.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/user-openapi/generate

    Say this to your AI
    Generate an OpenAPI specification for my scripts.

    docs / api / exec / routing

  • a46

    Rewrite service responses

    Inspect and change your service's response before it reaches the caller.

    Say this to your AI
    Add a header to responses from my app.

    Good to knowA WebSocket upgrade on a path matched by a hook is refused. Each service holds at most 8 hooks and a computer 32.

    docs / foundation / proxy / hooks

  • a47

    Read visitor IPs

    Read your visitors' real IP addresses in apps reached through your Hoody links.

    Say this to your AI
    Show visitor IPs in my app's access log.

    Good to knowWhen a proxy hook forwards the request, the app sees the hook's connection address instead.

    docs / foundation / proxy

  • a48

    Look up visitor networks

    Look up country and network information for your visitors' public IPv4 addresses.

    Linkhttps://api.hoody.com/api/v1/ip/lookup?ip={ips}

    Say this to your AI
    Show the countries for these visitor IPs.

    Good to knowUp to 25 public IPv4 addresses per lookup. An address Hoody holds no data for returns null.

    docs / foundation / proxy

Hoody AI models 8

  • a49

    Browse the model catalog

    List available models with their context lengths, modalities and current prices.

    Linkhttps://api.hoody.com/api/v1/ai/models

    Say this to your AI
    List the available AI models and their context lengths.

    Good to knowThe catalog is cached. OpenAI, Anthropic and Google models are excluded.

    docs / api / ai-models

  • a50

    Stream model answers

    Show your users text as the model generates its answer.

    Say this to your AI
    Stream the answer into my chat app.

    Good to knowCall from inside a computer with AI enabled.

    docs / foundation / hoody-ai / usage

  • a51

    Connect coding assistants

    Point Cline, Cursor or Windsurf at Hoody AI from your computer.

    Say this to your AI
    Connect Cline to Hoody AI on my computer.

    Good to knowThe tool must run inside the computer. Cursor Tab completion keeps using Cursor's built-in models.

    docs / foundation / hoody-ai

  • a52

    Use model tool calls

    Send tool definitions with your chat request for a supported model to use.

    Say this to your AI
    Let my model call the weather function.

    Good to knowWorks when the model answering supports tools. Call from inside a computer with AI enabled.

    docs / foundation / hoody-ai / models

  • a53

    Decide from a screenshot

    Ask Hoody AI yes/no questions about a screenshot, such as whether a page broke.

    Say this to your AI
    Check whether this checkout screenshot looks broken.

    Good to knowPNG, JPEG, WebP and GIF, up to 4 images per request and 1 MiB each after decoding. Remote image URLs are refused.

    docs / foundation / hoody-ai / decisions

  • a54

    Decisions with your own model

    Ask yes/no, pick-one or score questions through your agent, answered by the model you choose.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jev/decide

    Say this to your AI
    Ask the agent to classify this ticket with my configured model.

    Good to knowAnother provider's model requires that provider's key.

    docs / foundation / hoody-ai / decisions

  • a55

    Check free AI allowances

    See roughly how much of each server's free AI allowance your account has used.

    Linkhttps://api.hoody.com/api/v1/users/me/free-ai-usage

    Say this to your AI
    Show my free AI usage by server.

    Good to knowThe reading is approximate. An auth token needs `computers.read`, and one limited to realms gets `403`.

    docs / foundation / hoody-ai / models

  • a56

    Delete AI usage records

    Delete your computer's AI usage records older than a chosen time.

    Say this to your AI
    Delete this computer's AI usage records from before January.

    Good to knowThe delete applies only to the calling computer. Rows for in-flight requests are never deleted.

    docs / foundation / hoody-ai / security / reference

Speech and audio 5

  • a57

    Transcribe common audio formats

    Turn WAV, MP3, WebM, OGG, M4A or FLAC recordings into text, uploaded or as base64.

    Say this to your AI
    Transcribe this M4A voice memo.

    Good to knowAudio up to 25 MB (25,000,000 bytes) and 600 seconds. Audio URLs are refused. Works from inside a computer.

    docs / foundation / hoody-ai / models / reference

  • a58

    Choose a speech voice

    Choose one of four voices and get your text as PCM or MP3 audio.

    Say this to your AI
    Read this note in the Bella voice as an MP3.

    Good to knowText is limited to 4,096 characters. Hoody Voice works inside a computer within its server's voice limits.

    docs / foundation / hoody-ai / models / reference

  • a59

    Stream speech audio

    Stream generated speech to your app as it becomes available.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/speech/stream

    Say this to your AI
    Stream the spoken answer to my app.

    Good to knowOnly for models that stream speech.

    docs / api / agent / audio

  • a60

    Timestamp a transcript

    Request a transcript with segments and timing when those details are available.

    Say this to your AI
    Transcribe this recording with segment timestamps.

    Good to knowAudio is limited to 25 MB (25,000,000 bytes) and 600 seconds. Segment fields can be missing or null.

    docs / foundation / hoody-ai / models / reference

  • a61

    Find speech models

    List speech models and filter them by transcription or speech capability.

    Linkhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/models

    Say this to your AI
    List the speech-to-text models available to my agent.

    Good to knowA listed model can still be unavailable for a call.

    docs / api / agent / audio

AI request proxy 4

  • a62

    Review risky AI requests

    Hold an AI request in your proxy until a person approves or rejects it.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    Say this to your AI
    Hold risky AI requests until I approve them.

    Good to knowYou add the approve and reject scripts yourself. Without them, a held request ends with 408.

    docs / foundation / hoody-ai / mitm

  • a63

    Add knowledge to prompts

    Use your proxy script to add knowledge base results to prompts.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    Say this to your AI
    Add relevant company documentation to each AI prompt.

    Good to knowProtect the proxy with a script token and proxy permissions before sharing it.

    docs / foundation / hoody-ai / mitm

  • a64

    Route to another provider

    Use your proxy script to send AI requests to a provider you choose.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    Say this to your AI
    Route this app's AI requests to my provider.

    Good to knowYou manage your own provider keys and proxy security.

    docs / foundation / hoody-ai / mitm

  • a65

    Rewrite AI tool calls

    Use your proxy to change a model's tool call before the client runs it.

    Linkhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    Say this to your AI
    Redirect AI file writes to my review folder.

    Good to knowRewriting is routing, not confinement. Enforce restrictions in the tool that executes the call.

    docs / foundation / hoody-ai

hoody / capabilities / across

04 58 rows

Across everything

What holds for all of it, whichever way you come in.

Links, sharing and safety 12

  • x01

    Everything is a URL

    Every tool, file, app and Bot has its own link.

    Linkhttps://{p}-{c}-<kit>-1.{node}.computers.hoody.com

    Say this to your AI
    Send me the link to that.

    docs / concepts / everything-is-a-url

  • x02

    Work together live

    Share a link and work in the same terminal, desktop or editor at once.

    Say this to your AI
    Share my terminal with Sam so we can fix this together.

    Good to knowWithout ?sharing=true&steal=false on the link, a second person on a desktop takes it over from the first.

    docs / guides / multiplayer

  • x03

    People and AIs together

    People and AIs work side by side in the same tools, any mix.

    Say this to your AI
    Let my AI work in the same desktop while I watch.

    docs / guides / multiplayer

  • x04

    Snapshots and undo

    Save snapshots of your computers' storage and restore them in one step.

    Linkhttps://api.hoody.com

    Say this to your AI
    Take a snapshot before you change anything.

    Good to knowA rollback point on the same server, not a backup: it is deleted with the computer. A restore replaces the current storage and drops later changes. Mounted storage and running processes are not saved.

    docs / concepts / snapshots

  • x05

    Private links

    Generated links are hard to guess, but an open link can leak and anyone who obtains it can use it. Short links can be guessed: lock any link for real access control.

    Say this to your AI
    Is this link private?

    docs / concepts / security

  • x06

    Lock any link

    Add a password, a login or an IP list to your computer's links, then pick which programs the group may open.

    Say this to your AI
    Put a password on my desktop link before I share it.

    docs / foundation / proxy / permissions

  • x07

    See what happened

    Review sign-ins, your authenticated API calls with the token used, and the traffic each computer served.

    Say this to your AI
    Show me which API calls my AI's token made this week.

    docs / concepts / auditing

  • x08

    Encrypted vault

    Keep passwords and keys in your vault, and turn on encryption for each entry.

    Say this to your AI
    Save my Stripe key in my vault.

    docs / kit / agent / reference

  • x23

    Encrypted disks

    Your computer's disk is encrypted at rest on every Hoody server.

    Say this to your AI
    Is my computer's disk encrypted?

    Good to knowDisk encryption does not protect data on a running server.

    docs / concepts / security

  • x24

    Pause URL access

    Cut off new requests to your computer's URLs while you investigate an incident.

    Linkhttps://api.hoody.com/api/v1/computers/{c}/proxy/permissions/state

    Say this to your AI
    Pause access to this computer's URLs.

    Good to knowIt can take several seconds or longer to apply. SSH and established WebSocket or CONNECT tunnels stay open.

    docs / concepts / security

  • x25

    Expiring snapshots

    Set your computer snapshot to expire after a chosen number of days.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/snapshots

    Say this to your AI
    Take a pre-deploy snapshot that expires in 30 days.

    Good to knowExpiry is a whole number of days from 1 to 3650. Check `expires_at` afterward; a successful create can leave it null.

    docs / foundation / computers / snapshots

  • x26

    Label a snapshot

    Change a snapshot's label to mark a known-good computer state.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/snapshots/{name}/alias

    Say this to your AI
    Label that snapshot as the tested release.

    Good to knowThe alias can be up to 100 characters. Changing it does not rename the snapshot.

    docs / foundation / computers / snapshots

Access rules for links 8

  • x27

    Hoody users only

    Let only signed-in Hoody users, or the user IDs you list, call your service.

    Say this to your AI
    Only let signed-in Hoody users call my API.

    Good to knowThe caller sends a signed Hoody identity claim in a header. An allowlist holds up to 256 user IDs.

    docs / api / proxy-permissions

  • x28

    Partner access tokens

    Give a partner access through a token in a header, cookie or query parameter.

    Say this to your AI
    Give my partner a token for the API.

    Good to knowA group must have program grants, and unmatched callers remain subject to the default policy.

    docs / foundation / proxy / permissions

  • x29

    JWT access for apps

    Let your application's users open selected services with tokens your app issues.

    Say this to your AI
    Require my app's JWT for its service.

    Good to knowA group must have program grants, and unmatched callers remain subject to the default policy.

    docs / foundation / proxy / permissions

  • x30

    Protect new services

    Set the default to deny so programs you add later stay closed until you grant them.

    Say this to your AI
    Keep new services closed until I grant access.

    Good to knowSet up your groups first. Under allow, a new program is open from the start.

    docs / foundation / proxy / permissions

  • x31

    Project-wide URL rules

    Apply URL access rules across your project and override them on individual computers.

    Say this to your AI
    Apply the team access policy to this project.

    Good to knowComputer values win where they overlap, while project groups the computer does not name stay in force.

    docs / foundation / proxy / permissions

  • x32

    Grant selected app ports

    Give an access group specific ports for your HTTP or HTTPS apps.

    Say this to your AI
    Allow the partner group to reach port 8080.

    Good to knowOne cell opens at most 16,384 ports. A grant opens whatever listens on those ports.

    docs / foundation / proxy / permissions

  • x33

    Choose terminal instances

    Grant a group access to specific terminal instances on your computer.

    Say this to your AI
    Let the team use terminals 1 and 2.

    Good to knowSet a default-deny policy to keep unmatched callers out.

    docs / foundation / proxy / permissions

  • x34

    Inspect service access

    See your service's group access, hooks and effective default together.

    Linkhttps://api.hoody.com/api/v1/computers/{id}/proxy/services/{service}

    Say this to your AI
    Show me the access rules for my terminal.

    docs / api / proxy-discovery

Ways in 7

  • x09

    Say @hoody.com

    Tell your AI "@https://hoody.com Connect to Hoody" to start.

    Type@https://hoody.com

    Say this to your AI
    @https://hoody.com Connect to Hoody

    Good to knowYour AI needs to run code with network access to sign you in.

    docs / getting-started / quickstart

  • x10

    ssh hoody.com

    Type `ssh hoody.com` in any terminal, or click it to open in your browser.

    Typessh hoody.com · `https://ssh.hoody.com`

    Say this to your AI
    How do I get in from my terminal?

    docs / foundation / cli

  • x11

    Open in any browser

    Sign in at hub.hoody.com from any device to open your Hub: your computers and your agent.

    Linkhttps://hub.hoody.com

    Say this to your AI
    Open my Hoody in the browser.

    docs / kit / agent

  • x12

    Phone first

    Use everything from your phone, and install what you build as an app.

    Say this to your AI
    Make this dashboard installable on my phone.

    docs / vision / embeddability

  • x13

    Build your own OS

    Build your own web desktop or full workflow in plain HTML.

    Say this to your AI
    Build me a home screen with my terminal, notes and site on it.
  • x35

    Hub in your terminal

    Open your account's Hub full screen in an interactive terminal.

    Say this to your AI
    Open my Hub in the terminal.

    Good to knowThe standalone terminal Hub is available for Linux x64 and arm64, inside computers, and through the hosted CLI. The npm version needs Node.js 26 or newer.

    docs / foundation / cli

  • x36

    Try a sample account

    Explore the terminal Hub with a sample account and no sign-in.

    Say this to your AI
    Open the Hub's sample account.

    Good to knowThe terminal Hub requires an interactive terminal.

    docs / foundation / cli

Your AI, your plan 6

  • x14

    Your ChatGPT or Claude plan

    Use your ChatGPT plan, or your Claude plan through Claude Code, or the free built-in AI.

    Say this to your AI
    Sign in with my ChatGPT plan.

    Good to knowA Claude plan works through Claude Code on the computer, signed in with its own login. It covers new Hub conversations, not Bots.

    docs / kit / agent

  • x15

    Hoody AI (free)

    A free built-in AI with no key or setup, from inside your computers.

    Say this to your AI
    Use the free model for now.

    Good to knowLimits are per server and shared by all its computers.

    docs / foundation / hoody-ai / models

  • x16

    Switch AIs, keep everything

    Change AI anytime; files, projects, memory and tasks stay.

    Say this to your AI
    Move my work over to my new AI.
  • x17

    Free to start

    Start free: one free server, up to 3 computers that keep running, no expiry.

    Say this to your AI
    Set me up on the free plan.

    Good to knowOne free server per eligible account, while free capacity lasts.

    docs / foundation / pricing

  • x18

    Grow when it pays off

    Add a Plus or Pro server, or rent a whole bare-metal machine, when you need more room.

    Say this to your AI
    Rent a bigger server for this project.

    Good to knowA free server cannot be upgraded in place. Paid servers start at $10 a month.

    docs / foundation / pricing

  • x19

    Pay your way

    Pay by card or crypto, and share servers with your team by role.

    Say this to your AI
    Top up my balance with crypto.

    docs / foundation / billing

Servers and plans 9

  • x37

    Find servers by region

    Filter available servers by location, specifications and price before renting.

    Say this to your AI
    Find a server near my European users.

    Good to knowRentals start at one day; prices vary by listing and rental period.

    docs / foundation / servers

  • x38

    See plans on sale

    List the paid server plans on sale, with their short link and Bot URL limits.

    Linkhttps://api.hoody.com/api/v1/subserver-plans

    Say this to your AI
    Show me the paid server plans on sale.

    Good to knowThe purchase quote says whether a plan can be bought at that moment.

    docs / foundation / pricing

  • x39

    Upgrade Plus to Pro

    Upgrade your Plus server to Pro while keeping its ID and data.

    Say this to your AI
    Upgrade my Plus server to Pro.

    Good to knowThe upgrade charges the price difference for the rest of the current period. Running computers restart; stopped computers stay stopped.

    docs / foundation / pricing

  • x40

    Quote a server plan

    Check a paid server plan's current price and available capacity before purchase.

    Linkhttps://api.hoody.com/api/v1/subserver-subscriptions/quote

    Say this to your AI
    Quote the current price for the Plus server plan.

    docs / api / servers

  • x41

    Check free server eligibility

    Check whether your account can claim a free server and why it cannot.

    Linkhttps://api.hoody.com/api/v1/users/me/free-tier-status

    Say this to your AI
    Can my account claim a free server?

    Good to knowThe endpoint reports status and does not claim a server. Auth tokens need resources.read_account permission.

    docs / api / users

  • x42

    Server renewal setting

    Turn automatic renewal on or off for your paid server.

    Linkhttps://api.hoody.com/api/v1/subserver-subscriptions/{id}/auto-renew

    Say this to your AI
    Turn off automatic renewal for this server.

    Good to knowOnly the account owner or an authentication token can turn it on. Turning it off lets the server stop at the end of its paid period.

    docs / api / servers

  • x43

    Extend a server rental

    Add days to your existing server rental through the API.

    Linkhttps://api.hoody.com/api/v1/rentals/{id}/extend

    Say this to your AI
    Extend my server rental by 30 days.

    Good to knowAdditional days range from 1 through 3650 and must match server pricing.

    docs / api / servers

  • x44

    Reserve an offered server

    Reserve an out-of-stock machine for delivery with a spending ceiling.

    Linkhttps://api.hoody.com/api/v1/offers/{id}/reserve

    Say this to your AI
    Reserve this server offer for 30 days.

    Good to knowThe reservation charges immediately. Paid reservations require a maximum charge and an idempotency key.

    docs / api / servers

  • x45

    Bare metal server commands

    Check uptime or memory, or reboot your rented Bare metal server by API.

    Linkhttps://api.hoody.com/api/v1/servers/{serverId}/execute-command

    Say this to your AI
    Check the uptime of my Bare metal server.

    Good to knowOnly the built-in commands, on a dedicated Bare metal server with a current, active rental.

    docs / api / server-management

Your account 12

  • x20

    Two-factor sign-in

    Protect your account with an authenticator app and backup codes.

    Say this to your AI
    Turn on two-factor sign-in for my account.

    docs / api / authentication

  • x21

    Earn referral credit

    Share your referral link and earn credit for servers when people you invite pay.

    Say this to your AI
    Give me my Hoody referral link.

    Good to knowOpens once you have paid for a server by card or crypto. Credit arrives after a 60-day hold, for 12 months per customer, and pays for servers only.

    docs / foundation / wallet / referral-program

  • x22

    Support tickets

    Open a support ticket and follow the replies from the CLI or the API.

    Linkhttps://api.hoody.com/api/v1/support/tickets

    Say this to your AI
    Open a support ticket about my computer not starting.

    docs / foundation / support

  • x46

    End one sign-in

    Sign out one forgotten device while keeping your other sessions open.

    Linkhttps://api.hoody.com/api/v1/users/auth/sessions/{id}

    Say this to your AI
    Sign out the session on my old laptop.

    Good to knowOnly your own signed-in session can call this. Ending a session does not delete tokens created during it.

    docs / api / authentication

  • x47

    Sign out other devices

    End every other account session while keeping your current sign-in.

    Linkhttps://api.hoody.com/api/v1/users/auth/sessions/revoke-others

    Say this to your AI
    Sign out all my other devices.

    Good to knowOnly your own signed-in session can call this. Ending sessions does not delete tokens created during them.

    docs / api / authentication

  • x48

    Replace backup codes

    Generate new two-factor backup codes if your old ones are compromised.

    Linkhttps://api.hoody.com/api/v1/users/auth/2fa/backup-codes/regenerate

    Say this to your AI
    Generate new two-factor backup codes for my account.

    Good to knowRequires your password and current OTP code. Existing backup codes become invalid.

    docs / api / authentication

  • x49

    Review rejected sign-ins

    Include failed sign-in attempts when you review your account security history.

    Linkhttps://api.hoody.com/api/v1/users/me/security-history?include_failed=true

    Say this to your AI
    Show me rejected sign-in attempts on my account.

    Good to knowAn API token needs resources.read_account. The account audit trail is kept for 180 days.

    docs / concepts / auditing

  • x50

    Change account email

    Request a new account email and confirm it through your new address.

    Linkhttps://api.hoody.com/api/v1/users/me/email-change

    Say this to your AI
    Change the email address on my account.

    Good to knowRequires your own signed-in session and current password, plus a two-factor code when enabled. The confirmation link lasts 24 hours.

    docs / api / users

  • x51

    Support reply alerts

    Get an in-app notification when support replies to your ticket.

    Say this to your AI
    Tell me when support replies.

    Good to knowSeveral replies on one ticket can share a notification, with at most one per ticket every 10 minutes. The notification does not identify the ticket.

    docs / foundation / support

  • x52

    Custom referral codes

    Create a memorable referral code for people you invite to Hoody.

    Linkhttps://api.hoody.com/api/v1/referrals/me/codes

    Say this to your AI
    Create a referral code called alex-builds.

    Good to knowYou can have up to 3 active vanity codes at a time and 10 in your account's life. Creating one needs a signed-in session and referral program membership.

    docs / foundation / wallet / referral-program

  • x53

    Track referral earnings

    See your referral codes, level, counts and credit totals.

    Linkhttps://api.hoody.com/api/v1/referrals/me

    Say this to your AI
    Show me my referral level and credit totals.

    Good to knowReferred people's names and account details are not shown. An auth token needs financial.wallet.read and must not be limited to realms.

    docs / foundation / wallet / referral-program

  • x54

    Withdraw referral credit

    At the Creator level, take your available Referral credit out as money through support.

    Say this to your AI
    Ask support about withdrawing my referral credit.

    Good to knowOff by default, and support validates each request. Bank transfer or crypto in some cases; credit on hold cannot be withdrawn.

    docs / foundation / wallet / referral-program

Balances and invoices 4

  • x55

    Check all balances

    See your General Balance, Referral credit and AI Balance in one call.

    Linkhttps://api.hoody.com/api/v1/wallet/balances

    Say this to your AI
    Show me all my Hoody balances.

    Good to knowUse a signed-in session or an account-wide auth token with the matching permission. Realm-limited tokens cannot read balances.

    docs / foundation / billing

  • x56

    Review wallet transactions

    Review your payments, charges, transfers and refunds in one transaction history.

    Linkhttps://api.hoody.com/api/v1/wallet/transactions

    Say this to your AI
    Show me my recent Hoody charges and refunds.

    Good to knowUse a signed-in session or an account-wide auth token with the matching permission. Realm-limited tokens cannot read transactions.

    docs / foundation / billing

  • x57

    Download invoice PDFs

    Download your invoices as PDFs for accounting, taxes or client billing.

    Linkhttps://api.hoody.com/api/v1/wallet/invoices/{id}/pdf

    Say this to your AI
    Download the PDF for my latest invoice.

    Good to knowUse a signed-in session or an account-wide auth token with the matching permission. Realm-limited tokens cannot read invoices.

    docs / foundation / billing

  • x58

    Check a payment

    Look up your card or crypto payment by its intent ID.

    Say this to your AI
    Check whether my crypto top-up has been credited.

    Good to knowPayment lookups need a signed-in session. An auth token is refused.

    docs / foundation / billing

Since 2021

From privacy to agentic infrastructure

hoody / kit

What your computers come with

Every service has its own link. Open it, share it, or hand it to your AI. Anyone with the link can open it until you lock it. Kit links have the shape https://{p}-{c}-<kit>-1.{node}.computers.hoody.com: {p} is your project, {c} one of your computers, {node} its server.

Computers

Bots

API