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.
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
-
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}/computersWhat it means for youYour 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
-
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.comWhat it means for youNothing 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
-
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-sdkWhat it means for youThe 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
-
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.botWhat it means for youSay 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
-
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 youYou 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
Then the list 500 rows
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 AIKeep this running on my Hoody computers. - c02
Desktop in a tab
Open a full desktop in your browser.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com Say this to your AIOpen a desktop on my computers.Good to knowAnyone with the link can use the desktop until you set proxy permissions.
- c03
Any Linux app
Run any Linux app and use it from any browser, phone included.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com Say this to your AIRun LibreOffice and send me the link. - c04
Your AI uses the screen
Let your AI click, type, read windows and take screenshots on a desktop.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ screenshot Say this to your AITake a screenshot of my desktop and click Save. - c05
Copy and paste across
Copy and paste between your device and the desktop.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com Say this to your AIPaste this text into the desktop app.Good to knowYour browser may ask for clipboard permission before pasting works.
- c55
Pause a computer
Pause your computer and resume it in seconds with sessions and memory intact.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ pause Say this to your AIPause 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.
- c56
Several separate displays
Run separate desktops with their own resolutions, windows, and applications.
Say this to your AIGive my browser and editor separate displays.Good to knowA session must set up each display number before it can start.
- c57
Choose a desktop environment
Start your display with an Xfce or MATE desktop environment.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create Say this to your AIStart a display with the MATE desktop.Good to knowAn existing terminal session keeps its settings.
- c58
Plain computer setup
Create a computer without Kit services and run your own HTTP servers.
Link
https:// api. hoody. com/ api/ v1/ projects/ {p}/ computers Say this to your AICreate 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.
- c59
Stop a display
Stop a display and end the programs running on it.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ displays/ {displayId}/ stop Say this to your AIStop display 1 and its programs.Good to knowStopping the display ends every program on it, including unsaved work.
Desktop viewer options 9
- c60
Transfer desktop files
Transfer files between your browser and your display.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ Say this to your AITransfer this file to my display. - c61
Hear desktop audio
Play your display's audio through the browser viewing it.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?sound=true Say this to your AIPlay my desktop audio in this browser. - c62
Watch a presentation
Open a shared desktop as a viewer who cannot click or type.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?sharing=true&steal=false&readonly=true Say this to your AIGive 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.
- c63
Print from your desktop
Forward print jobs from your display to your browser.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ Say this to your AIPrint this document from my desktop. - c64
Choose keyboard layout
Choose a keyboard layout for your desktop viewer.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?keyboard_layout=gb Say this to your AIUse the British keyboard layout on my desktop. - c65
Touchscreen keyboard
Show a virtual keyboard when you use your desktop on a touchscreen.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?keyboard=true Say this to your AIShow the virtual keyboard on my touchscreen laptop. - c66
Cap display bandwidth
Set a bandwidth cap for your desktop viewer on a slow connection.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?quality_mode=reduced&bandwidth_limit=500000 Say this to your AILimit my desktop viewer to 500 Kbps. - c67
Focus an app on opening
Open your viewer with a named window maximized and focused.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?app=Firefox Say this to your AIOpen my desktop with Firefox in front.Good to knowThis minimizes the other windows for every viewer of the display.
- c68
Customize the viewer
Use a dark desktop viewer with a floating menu.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?dark_mode=true&floating_menu=true Say this to your AIOpen my desktop with a dark viewer and floating menu.
Desktop automation 7
- c69
Move and resize windows
Move, resize, minimize, restore or close your desktop windows through the API.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ window/ resize Say this to your AIResize my browser window to fill the desktop.Good to knowSome window actions need a desktop with a window manager.
- c70
Wait for a window
Wait for your application window to appear before continuing an automation.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ wait- until Say this to your AIWait for Firefox to open before continuing.Good to knowThe wait lasts up to 25 seconds. Expiry returns HTTP 200 with timedOut set to true.
- c71
Batch desktop actions
Run a sequence of desktop actions in one API call.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ batch Say this to your AIOpen 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.
- c72
Act and capture
Run a desktop action and capture its result in one call.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ act Say this to your AIClick the button and capture the resulting screen.Good to knowIf the screenshot fails after the action, the action has already completed.
- c73
Desktop clipboard by API
Read or set the text on your desktop clipboard with one API call.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ clipboard Say this to your AIPut this address on my desktop clipboard. - c74
Stored desktop screenshots
List the screenshots stored for your desktop and fetch any one by time or file name.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ screenshots Say this to your AIShow me the desktop screenshot from 10 minutes ago.Good to knowLookups search the newest 500 stored captures.
- c75
Desktop thumbnails
Capture a small image of your desktop for a gallery.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ thumbnail Say this to your AIMake a thumbnail of my desktop.Good to knowThe thumbnail is scaled to 20% of the screen dimensions.
Terminals and browsers 12
- c06
Terminal at a link
Use a full terminal in any browser, with no SSH keys to set up.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com Say this to your AIOpen a terminal on my computers.Good to knowAnyone with the link can use the terminal until you set proxy permissions.
- c07
Commands by link
Your AI runs commands and gets the output and errors back.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute Say this to your AIRun the tests and tell me what failed. - c08
Full-screen terminal apps
Your AI can operate full-screen terminal programs, key by key.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com Say this to your AIOpen htop and tell me what uses the most memory. - c09
Reach your other servers
SSH into your other servers from the web terminal, no client needed.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com Say this to your AIConnect to my old server and check its disk space. - c10
Browsers your AI drives
Run Chromium or Firefox that your AI can browse, read and click.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com Say this to your AIOpen 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.
- c11
Screenshots and PDFs of pages
Screenshot any web page, or save it as a PDF from a background browser.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ pdf Say this to your AISave that article as a PDF.Good to knowPDFs need a background Chromium; the default browser is the visible one.
- c76
Separate terminal sessions
Open separate shell sessions that share your computer's files and processes.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ Say this to your AIOpen 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.
- c77
Keep shell state
Run related commands in one session and keep your working directory and variables.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute Say this to your AIChange 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.
- c78
Check long commands
Start a long command and check its output and status while it runs.
Say this to your AIStart the build and check its progress.Good to knowA persistent session timeout is a reporting deadline and does not stop a running command.
- c79
Stop a command
Interrupt a running terminal command or cancel it while it waits.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute/ {command_id}/ abort Say this to your AIStop 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.
- c80
Watch without typing
Open a terminal in read-only mode to watch its session without sending input.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?readonly=true Say this to your AIGive 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.
- c81
Exact command output
Run a command and get its exact output bytes, with stdout and stderr kept apart.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute Say this to your AIRun 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.
Terminal options 10
- c82
Choose your shell
Start your browser terminal with bash, zsh, fish, sh or tmux.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?shell={shell} Say this to your AIOpen my terminal with zsh.Good to knowShell settings apply when a session starts. Add reset=true to change the shell of a running session.
- c83
Start graphical apps
Pair your terminal with a display and open programs on that display.
Say this to your AIStart Firefox from terminal 2 on display 2.Good to knowAn API-created session reads its display setting from the create request body.
- c84
Join tmux over SSH
Join your browser's tmux session over SSH using its terminal number.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?shell=tmux Say this to your AIShow me how to join terminal 3 over SSH. - c85
Terminal side panel
Show your Hoody Agent, a runbook or a dashboard beside your terminal on one page.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?panel={url} Say this to your AIOpen my agent beside terminal 1.Good to knowSharing the URL shares the terminal and its panel.
- c86
Temporary shell sessions
Create a temporary terminal with an assigned ID that cleans itself up.
Say this to your AIRun 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.
- c87
Run on terminal startup
Run your startup script before a local terminal's shell prompt appears.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create Say this to your AIRun 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 `..`.
- c88
SSH through a proxy
Route your terminal's SSH connection through a SOCKS5 proxy to reach a host.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create Say this to your AIConnect 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.
- c89
Command environment
Supply environment variables for one command in your local terminal session.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute Say this to your AIRun the tests with DEBUG set to 1.Good to knowOn an SSH session, supplied variables are exported in the remote shell and persist.
- c90
Customize terminal view
Set your terminal tab title, font size and background color through its link.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ Say this to your AIMake 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.
- c91
Screen reader mode
Turn on screen reader support for your browser terminal through its link.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?screenReaderMode=true Say this to your AIOpen the terminal with screen reader support.
Terminal automation 6
- c92
Wait for terminal output
Wait for a matching prompt or a stable screen before your next step.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ wait Say this to your AIWait until the Python prompt appears.Good to knowThe wait timeout defaults to 5000 ms and accepts 10 to 300000 ms.
- c93
Search terminal screen
Search your terminal screen or scrollback for a pattern and get match positions.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ find Say this to your AIFind 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.
- c94
Terminal command history
Retrieve a session's retained command records with their statuses and exit codes.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ history/ {terminal_id} Say this to your AIShow 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.
- c95
Export terminal output
Download retained terminal output or retrieve its last lines as text or HTML.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ raw Say this to your AIDownload the latest output from terminal 1.Good to knowOutput retains up to 8 MB by default, dropping the oldest.
- c96
Terminal screenshots
Turn your terminal's output into an image for a tutorial or dashboard.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ screenshot Say this to your AISave a PNG screenshot of my terminal.Good to knowChoose PNG, JPEG or GIF. The image is also saved by default.
- c97
Terminal mouse input
Click or scroll in a terminal program that supports mouse reporting.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ mouse Say this to your AIClick 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.
Read web pages 8
- c98
Page as Markdown
Turn a web page into Markdown with its title and metadata.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown Say this to your AIRead this article as Markdown.Good to knowOnly the main frame is converted, so iframe content and shadow DOM are excluded.
- c99
Extract article content
Get a page's main content without its navigation, sidebars and comments.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown Say this to your AIExtract the main article from this page.Good to knowOnly the main frame is converted, so iframe content and shadow DOM are excluded.
- c100
Page HTML or text
Get your browser tab's full HTML or just its visible text.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ html Say this to your AIShow me the HTML of this tab. - c101
Collect page links
Get a sorted, deduplicated list of links from your page.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown Say this to your AIList the links on this article.Good to knowThe links array contains at most 10000 entries. Only the main frame is converted.
- c102
Run page JavaScript
Run JavaScript in your browser tab and get the result back.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ eval Say this to your AIRun 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.
- c103
Screenshot one element
Capture one visible page element at its own size.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ screenshot Say this to your AICapture just the chart on this page.Good to knowThe selector captures the first matching element and cannot be combined with clip or fullPage=true.
- c104
Mask screenshot details
Cover selected page elements with opaque boxes in your screenshot.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ screenshot Say this to your AICover 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.
- c105
Page accessibility snapshot
Get a structured snapshot of your page with element references.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ snapshot Say this to your AIShow 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.
Browser control 15
- c106
Connect browser automation
Connect your Playwright or Puppeteer client to a Hoody Chromium instance.
Link
https:// {p}- {c}- cdp- 1. {node}. computers. hoody. com/ Say this to your AIConnect my Playwright script to the Hoody browser.Good to knowRequires Chromium with remote debugging enabled; Firefox returns 501.
- c107
Separate browser sessions
Run separate browser instances with their own tabs and cookies.
Say this to your AIOpen 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.
- c108
Wait for page changes
Wait for your page to show text, reach a URL or load.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ wait Say this to your AIWait 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.
- c109
Handle page dialogs
Accept or dismiss a page dialog raised by your browser action.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ action Say this to your AIClick 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.
- c110
Manage browser tabs
List your open browser tabs, popups included, and close the ones you no longer need.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ tabs Say this to your AIClose the old shopping tab in my browser.Good to knowThe last open tab cannot be closed.
- c111
Browser cookies
Read, add or clear the cookies in your browser instance.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ cookies Say this to your AIShow me the cookies for this site.Good to knowIf one added cookie is invalid, none are set. Stopping the instance discards its cookies.
- c112
Set browser location
Set your browser's locale, time zone and geolocation when it starts.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start Say this to your AIStart a browser with a London time zone.Good to knowThese options apply only when the instance is created.
- c113
Browser through a proxy
Route your browser traffic through an HTTP or SOCKS proxy.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start Say this to your AIStart my browser through my proxy.Good to knowThe proxy option applies only when the instance is created.
- c114
Chromium extensions
Load Chromium extensions such as an ad blocker in your browser.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start Say this to your AIStart Chromium with my ad blocker.Good to knowExtensions require a visible Chromium instance and must be set when the instance is created.
- c115
Pin a Chrome version
Choose a Chrome version or channel for your browser instance.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start Say this to your AIStart 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.
- c116
Browser history
Browse your browser's history by date or domain, or delete it.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ history Say this to your AIDelete my browser history before October.Good to knowHistory is kept 30 days by default and survives restarts. Deletion is permanent.
- c117
Browser console logs
Inspect your browser's recent console messages and page errors.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ console Say this to your AIShow 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.
- c118
Browser network log
Inspect recent network requests and responses across your browser tabs.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ network Say this to your AIShow me the network requests from my test page.Good to knowKeeps the last 500 entries.
- c119
Open browser DevTools
Get a link to inspect your Chromium instance in DevTools.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ devtools- url Say this to your AIOpen DevTools for my browser.Good to knowDevTools Protocol is unavailable on Firefox or when Chromium remote debugging is disabled.
- c120
Resize browser tabs
Set a fixed viewport size across your running browser's tabs.
Link
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ viewport Say this to your AIResize my browser tabs to 1280 by 800.Good to knowWidth and height are integers from 1 to 8192. Crashed tabs are skipped.
Files and data 8
- c12
Files at a link
Browse, edit and download your files in a web file manager.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com Say this to your AIShow me the files in my project folder.Good to knowAnyone with the link can see and change your files until you set proxy permissions.
- c13
Cloud drives in one place
Plug in Google Drive, Dropbox, S3 and more: 49 kinds of remote storage.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com Say this to your AICopy my Dropbox invoices into my project. - c14
File history
Bring back earlier versions of small text files you changed by link.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com Say this to your AIShow 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.
- c15
Files on your laptop
Open your computers' files in Finder or Explorer.
Say this to your AIMount my Hoody files on my Mac.Good to knowAnyone with the WebDAV link can mount your files until you set proxy permissions.
- c16
Laptop folder inside
Make a folder on your laptop show up inside your computers.
Say this to your AIShare 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.
- c17
Folders shared across
Share a folder between your computers on the same server, read-only or read-write.
Say this to your AIShare 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.
- c18
Databases with no server
Keep SQL databases and key-value data, reachable by link.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com Say this to your AIMake a database for my reading list.Good to knowAnyone with the link can reach the database until you set proxy permissions.
- c19
Data undo
See and undo past changes to your saved key-value data.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com Say this to your AIUndo 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.
File tools by link 17
- c121
Download from a URL
Fetch a remote file straight into your computer without using your device.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {folder}?download={url} Say this to your AIDownload this dataset directly to my computer.Good to knowA download stops at 100 GiB or 12 hours.
- c122
Copy and move files
Copy or move your files and folders through the Files API.
Say this to your AICopy my report into the archive folder.Good to knowA move never replaces an existing destination. A copy replaces it only with `?overwrite=true`.
- c123
Look inside an archive
List your archive's contents or read one file without extracting it.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {archive}?preview Say this to your AIList 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.
- c124
Resize and convert images
Resize, convert, blur or gray out an image by link.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {image}?thumbnail&size={size}&format={format} Say this to your AIMake 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.
- c125
Read selected lines
Read a range or the last lines of your file by link.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?lines={range} Say this to your AIShow me the last 20 lines of this log.Good to knowMax 100,000 lines or 64 MB per request.
- c126
Read-only file page
Open your text file on a page without editing controls.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {path}?view Say this to your AIOpen this note in a read-only view.Good to knowThe view does not prevent writes through other requests. Set proxy permissions to control access.
- c127
Compare file revisions
See a diff between two recorded versions of your file.
Link
https:// {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 AIShow 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.
- c128
Append to a file
Add data to the end of your file by link, creating it if missing.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ append/ {path} Say this to your AIAppend this entry to my log file. - c129
Extract one archive member
Extract one file or folder while leaving the rest of your archive untouched.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {archive}?extract_file&extract={member} Say this to your AIExtract only the images folder from this archive.Good to knowSupports ZIP, TAR and compressed TAR archives.
- c130
Download file ranges
Request selected bytes of your file instead of downloading it all.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path} Say this to your AIFetch the first megabyte of this file.Good to knowSeveral ranges on a remote file named with `backend` return the whole file.
- c131
File details by link
Check your file's size, owner and permissions without downloading its contents.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ stat/ {path} Say this to your AICheck the size and owner of this file. - c132
Check file integrity
Compare your file's SHA-256 hash with your copy to check a download.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?hash Say this to your AICheck whether my downloaded backup matches the original. - c133
Manage URL downloads
Check progress, review history or cancel your computer's URL downloads.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ downloads Say this to your AIShow 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.
- c134
Track archive extraction
Check progress or cancel your running archive extractions.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ extractions Say this to your AICheck whether my archive is still extracting.Good to knowCanceling an extraction needs write permission on the root folder.
- c135
File change audit
Find recorded file changes across your computer by path, operation and time.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ journal Say this to your AIShow 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.
- c136
Conditional file writes
Write your file only when its version matches your expected version.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path} Say this to your AISave this only if nobody changed it since I read it.Good to knowWorks on files on the computer, not on connected cloud storage.
- c137
Set upload permissions
Set your new file's permission bits as you upload it.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?chmod={mode} Say this to your AIUpload this key with owner-only permissions.Good to knowCheck that `GET /api/v1/version` lists `put_chmod` in `features`; older services ignore `?chmod`.
Cloud and shared storage 11
- c138
Remote storage as folders
Mount a connected storage account so programs can use it as a folder.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ mounts Say this to your AIMount 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.
- c139
Several cloud accounts
Connect your personal and work accounts from the same storage provider.
Say this to your AIConnect both my personal and work Google Drives.Good to knowConnections are capped at 100 in total and 10 per remote host by default.
- c140
Copy between cloud providers
Copy a file between your connected providers using your computer's bandwidth.
Say this to your AICopy this Drive backup to my S3 bucket.Good to knowThe file passes through a temporary copy on the computer.
- c141
Connect file servers
Connect your SFTP, SMB, WebDAV, FTP, HDFS or HTTP server to your computer.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ backends/ {protocol} Say this to your AIConnect my team's SMB file server.Good to knowConnecting checks your login; mount it as a folder afterwards.
- c142
Mount on a phone
Open your computer's files from a WebDAV app on your phone.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ Say this to your AIOpen 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.
- c143
One-off remote files
Read or upload remote files without saving a storage connection.
Say this to your AIRead this file from my SFTP server once.Good to knowAvailable for SFTP, WebDAV, FTP and S3.
- c144
Read-only laptop folder
Let your computer read a laptop folder while protecting it from writes.
Say this to your AIShare 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.
- c145
Expiring folder shares
Set an expiry time for a folder shared with another computer.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ storage/ shares Say this to your AIShare this folder with the other computer until Friday.Good to knowWhen it expires, the share is deleted and unmounted from every target.
- c146
Accept incoming shares
Accept or turn off a folder share another computer sends to yours.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ storage/ incoming/ {shareId}/ mount Say this to your AIStop 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.
- c147
Read-only cloud mount
Make your mounted remote folder refuse writes through its mount path.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ mounts/ {id} Say this to your AIMake this mounted cloud folder read-only.Good to knowThe `?backend=` route can still write. Custom settings are unsupported for `box`, `onedrive` and `protondrive`.
- c148
Files that failed to upload
Find files your cloud mount could not upload and download the held copies.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ pending- uploads Say this to your AIShow 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.
Databases and key-value 13
- c149
SQL transactions
Run several SQL statements together and roll them back if one fails.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ db Say this to your AIUpdate the order and its inventory in one transaction.Good to knowA result set stops at 10,000 rows with truncated: true; page with LIMIT.
- c150
Share a live query
Share a link that runs your read-only SQL query against live data.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ query Say this to your AIMake a link that shows the current order count.Good to knowThe URL carries one read-only SELECT encoded in Base64URL.
- c151
Native and HTTP SQLite
Use your SQLite database from local code and over HTTP at once.
Say this to your AILet 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.
- c152
Database backup copy
Make a consistent copy of your SQLite database while it is in use.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ maintenance Say this to your AIMake a consistent backup of my database.Good to knowThe copy is written to a new path.
- c153
Follow database changes
Stream changes to your key-value table as they happen, including SQL writes.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ changes/ stream Say this to your AITell me whenever a key in my app database changes.Good to knowThe log keeps 24 hours and at most 1,000,000 changes.
- c154
Expire temporary keys
Give your saved keys an expiry, or change it later.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key}/ expire Say this to your AIExpire this session key in an hour. - c155
Race-safe counters
Count up a shared counter from many clients without losing an update.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key}/ incr Say this to your AICount each visit to my homepage. - c156
Update JSON fields
Read, write or increment one part of your saved JSON value.
Say this to your AIChange the theme field without replacing the other settings.Good to knowThe stored value needs a JSON content type for a path set.
- c157
Prevent conflicting writes
Update a shared key only if its version has not changed.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key} Say this to your AIUpdate the settings only if nobody changed them first.Good to knowA 412 means another client wrote first: read again and redo the change.
- c158
Keys as files
Store your keys in a directory where other tools can edit them as files.
Say this to your AIStore these settings as files in a directory. - c159
Batch SQL values
Run one SQL statement against multiple sets of your values.
Link
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ db Say this to your AIInsert these rows with one SQL statement. - c160
Batch key operations
Read, write or delete up to 100 keys in one request.
Say this to your AISave these settings together in one batch.Good to knowA batch write applies every key or none.
- c161
Race-safe lists
Push, pop or remove items in a saved list without races between clients.
Say this to your AIAdd this item to the shared shopping cart.
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.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> Say this to your AIWrite an endpoint that turns a CSV into JSON. - c21
AI inside scripts
Your scripts can call AI models with no key to set up.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> Say this to your AIMake an endpoint that summarizes any web page.Good to knowThe default model is free, within server limits. Paid models are billed per use.
- c22
Private endpoints
Protect any script endpoint with its own secret token.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> Say this to your AILock that endpoint so only my app can call it. - c23
Live script events
Stream live events from a running script to any page.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> Say this to your AIPush 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.
- c24
Sites and apps live
HTTP apps you run are live at their own HTTPS link, no deploy step.
Link
https:// {p}- {c}- http- 8080. {node}. computers. hoody. com Say this to your AIBuild me a landing page and send me the link.Good to knowOpen to anyone with the link until you set proxy permissions on it.
- c25
Your own domain
Put any site or tool on a domain you own, HTTPS included.
Link
https:// www. yourdomain. com Say this to your AIPut 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.
- c26
Short links
Give any site or tool a short, memorable link.
Link
https:// {alias}. {node}. computers. hoody. com Say this to your AIGive 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.
- c162
Expiring demo links
Set an expiration time for your demo or event link.
Link
https:// api. hoody. com/ api/ v1/ proxy/ aliases Say this to your AIMake 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.
- c163
Pin a link to one page
Make your alias open one fixed page or API endpoint.
Link
https:// api. hoody. com/ api/ v1/ proxy/ aliases Say this to your AIMake 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.
- c164
Pause a short link
Disable your alias and restore it later without losing its configuration.
Link
https:// api. hoody. com/ api/ v1/ proxy/ aliases/ {id}/ state Say this to your AIPause the demo link until tomorrow.Good to knowThe URL answers 404 while disabled. Changes reach the alias URL in about 30 seconds, sometimes longer.
Writing scripts 12
- c165
Packages in scripts
Import an npm package and have it installed before your script runs.
Say this to your AIUse 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.
- c166
Dynamic script routes
Capture values from a URL path for your script to use.
Say this to your AIMake a user endpoint that reads the ID from its URL. - c167
Structured AI responses
Have your script request AI output in a defined JSON shape.
Say this to your AIExtract 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.
- c168
Stream AI responses
Stream generated text from your script as the response is produced.
Say this to your AIStream the answer from my AI endpoint as it writes. - c169
Script WebSocket servers
Accept WebSocket connections in your own worker script.
Say this to your AIMake a WebSocket endpoint for my chat app.Good to knowWebSocket needs both `// @mode worker` and `// @websocket`.
- c170
Script request middleware
Run your own code before and after requests to scripts in a folder.
Say this to your AIAdd request logging around the scripts in my API folder. - c171
Script environment keys
Set environment values for a script, a folder, or your scripts root.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ env/ update Say this to your AISet the API key for my invoice script.Good to knowThe request requires the current file revision to prevent conflicting changes.
- c172
Shared script cache
Keep temporary values available across requests to your scripts.
Say this to your AICache the latest exchange rates between requests.Good to knowA restart loses it completely, and clearing or idle eviction empties it.
- c173
Fresh context per request
Run each request in a fresh JavaScript context for independent tasks.
Say this to your AIMake 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.
- c174
Generate from templates
Generate your script from a built-in or custom template.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ templates/ generate Say this to your AIGenerate my new script from a template. - c175
Check scripts before running
Check your script's syntax, dependencies, directives, and optional types in one call.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ validate/ script Say this to your AICheck this script for errors before saving it. - c176
Pin script dependencies
Pin versions of your script dependencies in the package manifest.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ package/ pin Say this to your AIPin the dependency versions used by my scripts.
Running scripts 8
- c177
Script version history
Bring back an earlier version of your script, or a deleted one you kept a copy of.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ scripts/ restore Say this to your AIRestore the previous version of my webhook script.Good to knowA deleted script can be restored only if it was deleted with `keepCopy=true`.
- c178
Search script logs
Search your script logs for text or a regular expression.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ logs/ search Say this to your AIFind timeout errors in my script logs. - c179
Script performance history
See hourly call counts, failures, and latency for your script.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ monitor/ script- usage Say this to your AIShow me when my webhook was slow today.Good to knowThe history covers the last 24 hours.
- c180
Message running scripts
Send a message to your running script and receive its handler's reply.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ {path} Say this to your AISend 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.
- c181
Call exposed functions
Call a function your running script exposes and get its response.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ {path} Say this to your AICall 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.
- c182
Inspect a live script
Evaluate an expression against your script's latest run while debugging.
Say this to your AIInspect the counter in my running worker.Good to knowIt needs `@remote-eval` and a `@remote-token` with the `eval` scope; `@token` never unlocks it.
- c183
Script schedule history
Review past scheduled script runs and filter them by script or time.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ schedules/ history Say this to your AIShow me when my scheduled report script ran. - c184
Test script routes
Check several URL paths against your script routing rules at once.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ route/ test Say this to your AICheck which scripts handle these URL paths.
Running on its own 17
- c27
Programs that stay up
Run servers and workers that restart on their own if they crash.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com Say this to your AIKeep my scraper running all the time.Good to knowA program that keeps failing right at startup is marked fatal and stops being retried.
- c28
Fence in a program
Limit what one program can write, reach and use.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com Say this to your AIRun 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.
- 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 AIRun the test suite in a Docker container. - c30
Scheduled jobs
Run anything on a schedule, and set jobs to remove themselves at a set time.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com Say this to your AIBack up my database every night at 3. - c31
Web requests as links
Turn any API call into a link you can click, share or schedule.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com Say this to your AIMake a link that posts to my webhook.Good to knowAnyone with the link can read every header and value in it, credentials included.
- c32
Repeat calls, keep answers
Call an API on a schedule and save each response as a file.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com Say this to your AICheck this API every hour and keep the results. - c185
Start programs at boot
Start your program automatically whenever the computer boots.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ boot Say this to your AIStart my API server whenever the computer boots.Good to knowAn enabled boot program can start as soon as you create, enable or edit it.
- c186
Start on first request
Start your service when someone first requests its port.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add Say this to your AIStart my app only when someone opens it.Good to knowRequires lazy_load and a port_range. lazy_load is refused alongside boot: true.
- c187
Read program logs
Read the last lines of your program's output or error log, or follow it live.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ logs Say this to your AIShow 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.
- c188
Run a temporary command
Launch a one-off program and collect its exit result.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ quick- start Say this to your AIRun 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.
- c189
Wait for server readiness
Start your server and get an answer only once its port accepts connections.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ start Say this to your AIWait until my API port is ready before continuing.Good to knowSet ready_port on the program and use a waiting start.
- c190
One program per port
Run separate instances of your program across a range of ports.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add Say this to your AIRun 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.
- c191
Interactive daemon program
Watch and type into your supervised program through a terminal.
Say this to your AIRun my worker in a terminal so I can interact with it.Good to knowA sandboxed program cannot have a terminal_id.
- c192
Program status overview
Show your programs' states without exposing commands or environment variables.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ overview Say this to your AIShow a safe status overview of my programs. - c193
Offline sandbox worker
Run a worker with IP networking switched off, so it cannot reach the internet.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add Say this to your AIRun 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.
- c194
Sandbox connection rate
Set a per-source connection rate for your sandboxed service.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ edit/ {id} Say this to your AILimit 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.
- c195
Private temporary space
Give your sandboxed program its own empty temporary directories.
Link
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add Say this to your AIGive 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.
Scheduled job tools 7
- c196
Run scheduled jobs now
Run your existing scheduled job immediately and receive a receipt.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ entries/ {id}/ run Say this to your AIRun 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.
- c197
Check a cron schedule
Check a cron schedule, read it in plain words and see up to its next three runs.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ schedule/ describe Say this to your AICheck this cron expression and show its next runs.Good to knowNext run times are null for a reboot-only or never-firing schedule.
- c198
Pause a scheduled job
Pause your scheduled job and resume it when needed.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ entries/ {id} Say this to your AIPause the nightly backup job for now.Good to knowA paused job remains in the crontab as a commented-out line.
- c199
Scheduled job history
Inspect your managed job's status, exit code and run duration.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ runs Say this to your AIDid 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.
- c200
Live scheduled job events
Follow your job starts, finishes and crontab changes as they happen.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ events/ sse Say this to your AIWatch 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.
- c201
Audit jobs across users
List managed jobs and parsed handwritten jobs across your computer's users.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ entries Say this to your AIList the scheduled jobs across all users.Good to knowRetrieve every page and check unreadable_users and job_lines before treating the audit as complete.
- c202
Edit a raw crontab
Read and replace the complete crontab for your chosen user.
Link
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ crontab Say this to your AIShow 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.
Background web requests 5
- c203
Background web requests
Run your slow web request in the background and collect its result later.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request Say this to your AIStart this slow API request and give me the result later.Good to knowFinished job records are deleted after 7 days by default.
- c204
Retry failed requests
Retry your failed web transfers with a delay between attempts.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request Say this to your AIRetry this download if the transfer fails.Good to knowAt most 5 retries. A retry resends a POST body.
- c205
Cookie sessions
Keep cookies between your requests to a site using a named session.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request Say this to your AILog 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.
- c206
Stream API events
Get an API's live event stream, such as an AI chat stream, as it arrives.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request Say this to your AIStream 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.
- c207
Request job events
Follow events when your background requests start, progress and finish.
Link
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ sse Say this to your AITell me when my background download finishes.
Between devices and networks 11
- c33
Send anything live
Stream a file, screen, camera or data from one device to another.
Link
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ <name> Say this to your AISend 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.
- c34
Desktop notifications
Pop a notification on your computers' desktop from any script, and get it as an alert on your phone.
Link
https:// {p}- {c}- n- 1. {node}. computers. hoody. com Say this to your AINotify 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.
- c35
Put your laptop online
Publish a server on your laptop at your computers' link for that port.
Link
https:// {p}- {c}- http- 3000. {node}. computers. hoody. com Say this to your AIPut 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.
- c36
Reach your laptop
Let a computer reach a database or service on your laptop, while your laptop stays connected.
Link
https:// {p}- {c}- tunnel- 1. {node}. computers. hoody. com Say this to your AILet my Hoody app use the database on my laptop. - 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.
Link
https:// {p}- {c}- egress. {node}. computers. hoody. com Say this to your AIRoute my scraper through my own proxy.Good to knowOpen to anyone with the link until you set proxy permissions on it.
- c208
Route computer traffic
Route your computer's outbound TCP through a SOCKS5, HTTP or HTTPS proxy.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ network Say this to your AIRoute 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.
- c209
Reconnect a dropped tunnel
Resume your tunnel after a connection drop and keep its ports.
Say this to your AIKeep 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.
- c210
Serve a local handler
Expose your laptop's request handler without starting a separate server.
Say this to your AIExpose this local request handler through my computer.Good to knowThe serve helper requires Bun. On Node, use expose with your own HTTP server.
- c211
Inspect tunnel bindings
See your active tunnel sessions and the ports they bind.
Link
https:// {p}- {c}- tunnel- 1. {node}. computers. hoody. com/ api/ v1/ tunnel/ tunnels Say this to your AIShow me my tunnel sessions and their bindings. - c212
Temporary proxy exit
Set an upstream proxy that switches off unless your client renews it.
Link
https:// {p}- {c}- egress- 1. {node}. computers. hoody. com/ api/ v1/ egress/ upstream?lease={seconds} Say this to your AIUse 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.
- c213
Separate proxy credentials
Give different clients their own credentials for your outbound proxy.
Link
https:// {p}- {c}- egress- 1. {node}. computers. hoody. com Say this to your AIGive each client its own proxy credential.Good to knowEgress indexes share one upstream. Proxy permissions must be configured per index.
Live transfers 6
- c214
Browser transfer pages
Send typed text, a file or a pasted image from your browser.
Link
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ Say this to your AIOpen a browser page where I can send a pasted image.Good to knowThe browser must itself be allowed by the computer's access rule.
- c215
Live broadcast viewers
Broadcast your live stream while viewers join and leave as they like.
Say this to your AIBroadcast 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.
- c216
Forward a TCP port
Carry a TCP connection between two machines through your pipes.
Say this to your AIReach my database from the other machine through a pipe. - c217
Two-way pipe
Connect two WebSocket peers to exchange text and binary messages.
Say this to your AIConnect these two programs for a two-way conversation.Good to knowA third peer gets 409.
- c218
Transfer progress
Watch your transfer's progress without taking a receiver slot.
Link
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ {name}?progress Say this to your AIShow me the progress of this transfer. - c219
Transfer checksums
Check your transferred bytes against a server-calculated SHA-256 digest.
Say this to your AISend this disk image and verify its checksum.Good to knowA hashed or self-named transfer keeps its receipt for up to 10 minutes.
Alerts and notifications 4
- c220
Live notification feed
Stream notifications from your selected displays into a dashboard.
Link
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ stream Say this to your AIStream 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.
- c221
Notification history
Read recent notifications from one or more of your displays.
Link
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ {display} Say this to your AIShow me the recent notifications on display 1.Good to knowHistory excludes dismissed and expired notifications and keeps the newest 1,000 per history file.
- c222
Choose notification urgency
Set your notification's urgency and how long it stays visible.
Link
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ notify Say this to your AIShow a critical alert when the backup fails.Good to knowExpiry can be 0 to 300000 milliseconds. Each caller can send 10 notifications a minute.
- c223
Manage alert devices
List subscribed browsers and remove a device from your alerts.
Say this to your AIRemove my old browser from notification alerts.Good to knowThe default limit is 50 push subscriptions per kit.
Tools and full machines 16
- c38
VS Code in the browser
Use full VS Code from any browser, phone included.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com Say this to your AIOpen my project in VS Code.Good to knowExtensions come from Open VSX; others can be added as a .vsix file.
- c39
Watch for file changes
Get a live feed whenever files change.
Link
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com Say this to your AITell me whenever a new upload lands.Good to knowA watcher is lost when the watch service restarts, so create it again afterward.
- c40
Find any app
Find an app by name across many catalogs and get the command to run it.
Link
https:// {p}- {c}- run- 1. {node}. computers. hoody. com Say this to your AIFind me a way to run Blender. - c41
Traffic log
See every request that reached your computers, live or after the fact.
Link
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com Say this to your AIWho opened my site today?Good to knowKeeps the last 7 days, up to 50,000 entries or 100 MB, per computer by default.
- c42
Firewall
Decide what can reach your computers and where they can connect.
Say this to your AIClose 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.
- 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 AIInstall Postgres and set up a database for my app. - c44
Full virtual machines
Run Windows or another Linux as a full virtual machine inside your computer.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com Say this to your AIStart a Windows 11 VM on my computer.Good to knowRented or dedicated servers only, with KVM turned on while the computer is stopped.
- c224
Find failed requests
Filter your traffic log by service, path, HTTP status or request ID.
Link
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs Say this to your AIFind failed requests to my app today.Good to knowLog access follows the computer's proxy permissions and configured retention.
- c225
Read logged bodies
Request stored request or response bodies when examining your computer's traffic.
Link
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs Say this to your AIShow 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.
- c226
Count traffic over time
Count your matching proxy log entries in time buckets.
Link
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs/ stats Say this to your AICount my app's errors per hour today.Good to knowEach bucket is at least 60000 ms, with at most 240 buckets per window.
- c227
Filter watched files
Watch your selected paths and filter events by filename pattern or change type.
Link
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com/ api/ v1/ watch/ watchers Say this to your AIWatch for new CSV files in my uploads folder.Good to knowWatchers do not survive a service restart. Exclude patterns take precedence over include patterns.
- c228
Replay file changes
Retrieve your watcher's retained file events after an event ID or timestamp.
Link
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com/ api/ v1/ watch/ watchers/ {id}/ events Say this to your AIShow 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.
- c229
Find listening ports
List listening ports and see which programs and users own them.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ ports Say this to your AIFind the program listening on port 3000. - c230
Pause and resume work
Pause a process or process tree and resume it with its memory state intact.
Say this to your AIPause my build and resume it later.Good to knowSome system and service PIDs are guarded and cannot be frozen or resumed through these endpoints.
- c231
Server resource usage
Inspect your server's CPU, memory and storage usage.
Link
https:// api. hoody. com/ api/ v1/ rentals/ {id}/ runtime Say this to your AIShow 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.
- c232
Pause firewall rules
Disable an individual firewall rule and re-enable it when you need it.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ firewall/ ingress Say this to your AITemporarily disable this inbound firewall rule.Good to knowSSH through Hoody's SSH gateway is not affected by these rules.
Code editor options 6
- c233
Open a folder by link
Open any folder in your editor by link, without restarting it.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder} Say this to your AIOpen my project folder in the editor.Good to knowSend an absolute, already normalized path.
- c234
Separate team editors
Give teammates separate editor instances that use the same computer's files.
Say this to your AIGive us separate editors on the same project files.Good to knowThe editors have separate settings and extensions; shared cursors are not available.
- c235
Separate editor instances
Open separate editor instances with their own settings and extensions.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ Say this to your AIOpen 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.
- c236
Extensions for every editor
Add a VS Code extension file from a URL to every editor on your computer.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code/ extensions/ install Say this to your AIStage this VSIX extension for my editor.Good to knowAn editor installs it only when it starts, so restart a running one with `restart=true`.
- c237
Extension-only editor view
Open an editor link focused on one extension's sidebar view.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder}&extension={extension} Say this to your AIOpen the Python extension view on its own.Good to knowIf Code finds no matching sidebar view, it shows Explorer instead.
- c238
Editor language choice
Choose the display language for your editor when the instance starts.
Link
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder}&locale={locale} Say this to your AIOpen my editor in Japanese.Good to knowStartup options take effect when the instance starts; a running instance needs `restart=true`.
Finding and running apps 4
- c239
Browse starter apps
Browse tested starter apps and see where each opens.
Link
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ catalog Say this to your AIShow me the starter apps on my computer. - c240
Preflight app launches
Check an app's execution plan and missing requirements before running it.
Link
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ preflight Say this to your AICheck what is needed to run this app. - c241
Save app recipes
Save how you pick and run an app as a named recipe, then reuse it by name.
Link
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ recipes Say this to your AISave my preferred Firefox selection as a recipe. - c242
Batch app lookups
Search for multiple apps or resolve their commands in one request.
Link
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ batch Say this to your AIFind 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`.
Virtual machines 14
- c243
VM screen in browser
Open your virtual machine's screen and send it keys and clicks.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ display Say this to your AIOpen 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.
- c244
VM snapshots
Snapshot your stopped VM before a risky change and restore it after.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ snapshots Say this to your AISnapshot 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.
- c245
VM installer downloads
Download an installer image by URL for your virtual machine.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ isos/ downloads Say this to your AIDownload 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.
- c246
Pause a virtual machine
Freeze your VM's CPUs and resume it with its memory intact.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ pause Say this to your AIPause my test VM until I need it again.Good to knowA paused VM keeps its memory; stop it to release the memory.
- c247
VM port forwarding
Forward a computer port to a service inside your virtual machine.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms Say this to your AIForward 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.
- c248
VM shared folder
Share a folder between your computer and its virtual machine.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms Say this to your AIGive my VM a shared folder for project files.Good to knowVM snapshot exports do not include the shared folder's files.
- c249
Clone a VM disk
Create a virtual machine from a copy of another VM's disk.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms Say this to your AIClone 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.
- c250
Move a virtual machine
Export a VM snapshot and create a VM on another computer.
Say this to your AIMove 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.
- c251
Resize a VM
Change your stopped VM's memory, CPUs and disk size for its next start.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name} Say this to your AIGive my stopped VM more memory and CPUs.Good to knowThe VM must be stopped. Disk size only grows and must be sent alone.
- c252
VM autostart
Start your VM automatically when its computer comes back after a restart.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name} Say this to your AIStart my VM automatically after the computer restarts.Good to knowAutostart is off by default. Updating it requires the VM to be stopped.
- c253
VM serial console
Read your VM's serial console and send it commands by link.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ console Say this to your AIRead the console output from my VM's failed boot.Good to knowMany guest consoles are root shells, so treat write access like shell access.
- c254
Nested virtual machines
Run hardware-accelerated virtual machines inside your VM for testing or CI.
Say this to your AISet up VM-based CI inside my guest.Good to knowRequires a dedicated server with nested virtualization enabled on request through Hoody support.
- c255
VM guest inventory
Read your VM guest's operating system, network addresses and logged-in users.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ agent/ inventory Say this to your AIShow me the IP addresses inside my VM.Good to knowThe guest agent must report the information. Unsupported or unavailable sections can be absent.
- c256
Live VM events
Stream your VM's state and snapshot events as they happen.
Link
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ events Say this to your AIWatch my VM for state and snapshot changes.Good to knowEvents are not replayed after a disconnect; reconnect and read the current state.
Also built in 10
- c45
Shared notes
Write notes with tables, files and comments, and edit them together live.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com Say this to your AIWrite up today's plan as a shared note. - c46
Your usual SSH
Connect with your own SSH, SFTP or VS Code Remote.
Type
ssh root@{p}-{c}- ssh. {node}. computers. hoody. com Say this to your AIGive me the SSH command for my computers.Good to knowPublic key only, one key per computer.
- c47
Upload, search, zip
Upload and search files, unpack archives and download folders as ZIP.
Link
https:// {p}- {c}- files- 1. {node}. computers. hoody. com Say this to your AIZip 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.
- c48
See what's running
Check CPU, memory and disk activity at a glance, and list the programs running.
Link
https:/Programs: use /api/v1/system/processes./ {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ resources Say this to your AIWhy are my computers slow right now? - c49
Settings that stay
Keep settings and keys as environment variables that survive restarts.
Link
https:// api. hoody. com/ api/ v1/ computers/ {c}/ env Say this to your AISet 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.
- c50
Memory-fast storage
Use fast memory-backed storage for caches and temporary work.
Say this to your AIPut 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.
- c52
VPN inside
Run your VPN provider's WireGuard file inside a computer and keep its links working.
Say this to your AIConnect 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.
- c53
Record the desktop
Record what happens on a desktop as a video file, right from the viewer.
Link
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?record=true Say this to your AIRecord 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.
- c54
Drop files into terminals
Hand files to a program in a terminal as if you dragged them in.
Link
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ drop Say this to your AIDrop this screenshot into my Claude Code terminal. - c257
Secrets off disk
Keep decrypted keys in memory so they never land on a disk, snapshot or backup.
Say this to your AIKeep this decrypted credential in memory for the job.Good to knowFree server and paid subservers only. Lost when the host server reboots.
Working with notes 8
- c258
Read a note as Markdown
Get one note page as Markdown or HTML, whole or by line range.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ document Say this to your AIRead my meeting notes page as Markdown.Good to knowReturns one page. For a page with its sub-pages, use the notebook export.
- c259
Find recent notes
See the notebook pages whose title or text changed most recently, newest first.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ recent Say this to your AIShow me the pages changed most recently. - c260
Append note blocks
Add text or structured blocks to the end of your note.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ document/ append Say this to your AIAppend today's meeting notes to that page.Good to knowUp to 100 blocks per request.
- c261
Save note versions
Capture your note as a version and restore it later.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ versions Say this to your AISave a version of this note before editing it.Good to knowRestoring saves the content it replaces as a new version.
- c262
Export notes as a ZIP
Download your notebook, or one section, folder, page or database, as a Markdown or HTML ZIP.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ export Say this to your AIExport 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.
- c263
Note collaborator roles
Add a collaborator to your note and choose their role.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ collaborators Say this to your AIAdd Sam as a collaborator on this note.Good to knowRoles are admin, editor, collaborator or viewer. You need admin permission on the page.
- c264
Filter note records
Filter, sort or search by name the records in your notes database.
Link
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ databases/ {databaseId}/ records Say this to your AIShow my notes database records sorted by name.Good to knowThe list is paginated.
- c265
Resumable note uploads
Upload a file to your notebook in resumable chunks.
Say this to your AIUpload this large attachment to my notebook in chunks.Good to knowOnly the user who created the file node can upload to it.
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.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}?realm={realm} Say this to your AIAsk my Bot to set up a blog for me. - b02
Team of agents
Hand off any task and a team of agents does it, then reports back.
Say this to your AIHave a team of agents fix the failing tests and report back. - b03
Never re-explain
Your Bot keeps the conversation across messages; long ones may be summarised.
Say this to your AIPick up where we left off yesterday. - b04
Rules and scope
Choose which computers it may touch and the rules it must follow.
Say this to your AIOnly 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.
- 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.
Link
https:// <label>. hoody. bot Say this to your AIGive 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.
- b06
Your Bot in other AI apps
Connect other AI apps and agents with your Bot's .hoody.bot URL and a named key.
Link
https:// <label>. hoody. bot/ v1 Say this to your AIUse 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.
- b07
Talk to your Bot
Speak to your Bot live, or send it a voice recording.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}/ voice Say this to your AILet me talk to my Bot while I drive.Good to knowOne voice connection per Bot at a time, and speech has daily limits.
- b08
Your Bot in voice apps
Voice apps built on OpenAI Realtime, like LiveKit or Pipecat, can talk to your Bot.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}/ realtime Say this to your AIConnect my voice assistant to my Bot.Good to knowOne voice connection per Bot at a time.
- b10
One Bot in every chat app
Telegram, Slack and Discord all reach the same Bot and the same conversation.
Say this to your AIConnect 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.
- b29
A model for each Bot
Choose a model for your Bot's own replies.
Say this to your AIGive 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.
- b30
Separate Bot default
Set a default model for Bots separately from your AI helper.
Say this to your AIUse a different default model for my Bots.Good to knowBots that follow the default switch to it when their conversation restarts.
- b31
Hands-free voice
Talk hands-free while your Bot detects when you start and stop speaking.
Say this to your AIStart a hands-free conversation with my Bot.Good to knowUse headphones. Full duplex lets you interrupt the reply by speaking.
- b32
Voice with text replies
Speak your question and read your Bot's answer without speech playback.
Say this to your AILet 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.
- b33
Choose worker agents
Choose which agents your Bot may use for the work it hands off.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {id} Say this to your AILet this Bot use only my reviewer agent.Good to knowAn empty list means any agent.
- b34
Check tasks against rules
Have your Bot check each new task against its guardrails before starting.
Say this to your AICheck new tasks against my Bot's guardrails.Good to knowA Bot in strict mode refuses every task while its checker cannot run.
- b35
Automatic worker approvals
Let your Bot's delegated agents receive tool approvals automatically.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {id} Say this to your AITurn on automatic tool approvals for this Bot's workers.Good to knowOff by default. Workers then act without asking you first.
- b36
Daily speech budgets
Set daily limits on how much your Bot speaks and transcribes.
Say this to your AISet a daily speech budget for my Bot.Good to knowDefaults are 200000 characters read aloud and 14400 seconds transcribed per UTC day.
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 AIMake 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.
- b38
Updates in a chat
Send your Bot's completed work, approval requests and errors to a home chat.
Say this to your AISend 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.
- b39
Stop from chat
Stop what your Bot is doing with a chat command.
Say this to your AIStop my Bot from Telegram.Good to knowThe sender needs the control right.
- b40
Choose chat rights
Choose whether paired people can chat, run commands or decide approvals.
Say this to your AILet Sam chat with my Bot but not decide approvals.Good to knowOpen guests can only chat.
- b41
Approve group chats
Approve a group before its members can talk to your Bot.
Say this to your AIApprove our project group to talk to my Bot.Good to knowEvery member of an approved group can read the Bot's answers.
- b42
Block chat users
Drop messages from selected users across your Bot's chats.
Say this to your AIBlock this user from messaging my Bot.Good to knowA chat app's blocked user list holds at most 200 platform user IDs.
- b43
Mirror replies to chat
Send replies from your Bot's other access points to its home chat.
Say this to your AIMirror my Bot's app replies to its home chat.Good to knowThis setting is off by default.
- b44
Pause all chat apps
Pause every chat app connected to your Bot at once.
Say this to your AIPause all chat apps for my Bot.Good to knowEach chat app keeps its own enabled value.
- b45
Choose reply format
Choose rich formatting or plain text for your Bot's chat replies.
Say this to your AISend my Bot's replies as plain text. - b46
Chat message limits
Set message rates for people and chats using your Bot.
Say this to your AILimit 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.
- b47
Chat notice language
Choose a language for your Bot's chat app notices.
Say this to your AIShow 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.
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 AICheck whether my Bot is working or waiting for approval.Good to knowA Bot URL key is required.
- b49
Follow Bot events
Follow your Bot's live events and resume from a saved cursor.
Say this to your AIFollow 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.
- b50
Expiring Bot keys
Give your Bot URL key an expiration time for temporary access.
Link
https:// api. hoody. com/ api/ v1/ bot- urls/ {id}/ keys/ {keyId} Say this to your AIMake Sam's Bot key expire at the end of December. - b51
Bot URL access log
Review which named keys called your Bot and from which addresses.
Say this to your AICheck 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.
- b52
Limit Bot URL traffic
Set request and concurrency limits for your Bot URL and its keys.
Say this to your AILower the per-key request limit on my Bot URL.Good to knowThe per-key setting applies to every key. Limits count requests, not money.
- b53
Revoke all Bot keys
Turn off your Bot URL and revoke all its keys at once.
Link
https:// api. hoody. com/ api/ v1/ bot- urls/ {id}/ panic Say this to your AITurn 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.
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.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com Say this to your AIOpen my Hoody agent. - b12
Sessions that keep going
Close the tab and your AI keeps working; pick it up on any device.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com Say this to your AIKeep working on this while I am away. - b13
Any model
Pick from 100+ AI providers or add your own model server.
Say this to your AISwitch this chat to a faster model.Good to knowYour own model server must speak the OpenAI or Anthropic API at a public HTTPS address.
- b14
Many models at once
Ask several models at once and get one combined answer.
Say this to your AIAsk three models and give me the best answer. - b15
GitHub built in
Clone, commit and open pull requests straight from your agent.
Say this to your AIOpen a pull request with this fix. - b16
Add tools to your AI
Connect MCP servers to give your agent new tools.
Say this to your AIAdd 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.
- b17
Memory any AI can use
Your agent saves and searches memory, not locked to one AI app.
Say this to your AIRemember that my site uses Postgres. - b18
Skills
Install skills that teach your agent new jobs.
Say this to your AIInstall a skill for writing release notes. - b19
AI on a schedule
Have your agent check in and act on a schedule.
Say this to your AIEvery 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.
- b20
Saved AI workflows
Save AI workflows and run them again whenever you want.
Say this to your AISave this as a workflow I can run again. - 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 AIWhat's on your to-do list for my project? - b22
Branch a chat
Fork a chat to try another approach and keep the first one.
Say this to your AIFork this chat and try it with a different design. - b23
See your AI usage
See how much AI each chat and each model used.
Say this to your AIHow much AI did I use this week? - b24
Jobs without a chat
Send your agent a job and collect the result later, no chat needed.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com Say this to your AIRun 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.
- 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 AIDon't let my agent finish until the tests pass.Good to knowEdited hooks wait for your OK before they run.
- b26
Your own agents
Make your own agents, each with its own model, tools and instructions.
Say this to your AIMake a read-only reviewer agent that uses a cheap model. - b27
Ask before acting
Make your agent ask you before every action that changes something.
Say this to your AIAsk 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.
- 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 AIAsk me in Telegram before you deploy anything.Good to knowOnly people you allow can press the buttons.
- b54
Plan before building
Switch your agent to plan mode to design work before implementing it.
Say this to your AIPlan the architecture before you build the app.Good to knowSwitch back to the general agent to build from the plan.
- b55
Live app preview
Watch your app preview update as your agent changes its files.
Say this to your AIStart 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.
- b56
Explore without edits
Use explore mode to investigate your code with read-only tools.
Say this to your AIExplore this codebase and explain how login works. - b57
Stream agent work
Watch your agent's tool calls, results and messages as a turn runs.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {session_id}/ prompt:stream Say this to your AIShow me the agent's tool calls as it works.Good to knowWith no proxy permissions configured, the computer's URL itself is the credential.
Agent sessions 14
- b58
Rename a chat
Give your agent session a title that makes it easier to find.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id} Say this to your AIRename this chat to Release planning.Good to knowTitles are capped at 120 characters.
- b59
Read a chat transcript
Retrieve your saved conversation, including tool calls and their results.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ transcript Say this to your AIShow me the transcript of my last session. - b60
Trim a conversation
Remove later turns from your session and continue from an earlier point.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ trim Say this to your AITrim this chat back to the turn before my last request.Good to knowWorks between turns only, not while a turn runs.
- b61
Watch several sessions
Follow events from up to 32 live sessions in one stream.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions:events Say this to your AIMonitor these agent sessions together.Good to knowOnly live sessions can be watched.
- b62
Adjust reasoning effort
Choose how much reasoning effort your session's model should use.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ effort Say this to your AISet this session's reasoning effort to high.Good to knowLevels are low, medium, high, xhigh and max.
- b63
Shorter agent replies
Set your session's response verbosity to match how much detail you want.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ verbosity Say this to your AIMake this session's replies concise. - b64
Pending agent questions
See the questions and confirmations waiting for you across your sessions.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ gates Say this to your AIShow me which agent sessions need my input.Good to knowOnly sessions this agent holds live are listed.
- b65
Allow or deny a tool
Set a session rule to allow or deny a particular agent tool.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ approval/ rules/ {tool} Say this to your AIDeny 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.
- b66
Suggested question answers
Get a helper model's proposed answers to your agent's parked question.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ answer:assist Say this to your AISuggest answers to the question my agent is waiting on.Good to knowThe suggestion does not answer the question; the real answer is sent separately.
- b67
Guide a running workflow
Send feedback to your workflow while it is running.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ workflow/ messages Say this to your AITell 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.
- b68
Check a turn's outcome
Look up your turn's state and outcome after a disconnect or restart.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ turns/ {turn_id} Say this to your AICheck whether my last agent turn finished.Good to knowWorks for live and dormant sessions.
- b69
Wait for another session
Have your session wait for a named outcome in another session's work.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ waiters Say this to your AIWait 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.
- b70
Instructions after summaries
Reintroduce your chosen instructions whenever the agent compacts a conversation.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ after- compaction Say this to your AIRemind the agent to run tests after every conversation summary.Good to knowAt most 16 KiB. Not available on Claude Code sessions.
- b71
Pause agent work
Pause your agent's sessions and resume them where they stopped.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ pause Say this to your AIPause 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.
Agent memory 4
- b72
Switch memory off
Turn your agent's memory privacy switch on or off.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ enabled Say this to your AITurn off memory for this realm. - b73
Edit a memory
Update a saved memory record while keeping fields you leave out.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ items/ {id} Say this to your AIUpdate my saved project preference to use TypeScript. - b74
Delete saved memories
Remove one or several specific records from your agent's memory.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ items Say this to your AIDelete these outdated memory records.Good to knowDeleting individual records does not erase project summaries, relation graphs, or consolidation residue.
- b75
View memory relationships
Explore the nodes and connections in your project's memory graph.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ graph Say this to your AIShow me the relationships in this project's memory.
Background work 9
- b76
Run a loop now
Trigger your scheduled agent loop immediately without waiting for its next interval.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops/ {loopId}/ run- now Say this to your AIRun my scheduled check now.Good to knowA paused loop fires once and remains paused. A loop paused by the circuit breaker resumes its schedule.
- b77
Set loop budgets
Set cost and time ceilings for your recurring agent loop.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops/ {loopId} Say this to your AISet a cost and time budget for this loop.Good to knowEach update changes one thing: pause state, expiry or budgets. 0 removes a ceiling.
- b78
Stop loops on conditions
Set your recurring agent loop to stop when a chosen condition is met.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops Say this to your AIRepeat 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.
- b79
Stream headless runs
Receive your headless agent run as a live stream of events.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ headless/ runs Say this to your AIRun 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.
- b80
Cancel an agent job
Stop a pending or running asynchronous agent job.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ jobs/ {id} Say this to your AICancel that agent job.Good to knowDeleting a finished job removes its historical record.
- b81
Read subagent transcripts
Inspect the transcript and summary of your background subagent's task.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ tasks/ {tid}/ transcript Say this to your AIShow me what the background reviewer did. - b82
Cancel a subagent task
Stop one background subagent task while your session is working.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ tasks/ {tid}/ cancel Say this to your AICancel the background research task.Good to knowThe session must be live.
- b83
See and stop background shells
List the background shells your agent session started, and stop one.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ bash- jobs Say this to your AIShow me the background shells this session started. - b84
Pause a hook
Disable or re-enable one of your agent's lifecycle hooks.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ hooks/ toggle Say this to your AITurn off my lint hook.Good to knowNeeds a live agent session.
Skills, workflows and tasks 10
- b85
Import existing skills
Bring selected Claude or Codex skills into your agent's local skill store.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ import/ apply Say this to your AIImport my existing Claude skills into my agent.Good to knowScan for skills first. Existing destinations are refused unless overwrite is requested.
- b86
Preview a skill
Preview a skill from the hub before installing it on your computer.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ hub/ preview Say this to your AIPreview the release notes skill before installing it.Good to knowThe preview requires the provider, source and skill ID from a search result.
- b87
Turn skills off
Disable a skill by name and enable it again when you need it.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ toggle Say this to your AIDisable my web search skill for now. - b88
Edit skill instructions
Read and replace a skill's source to change what your agent learns.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ source Say this to your AIUpdate my release notes skill with our new format. - b89
Resume a workflow
Continue a failed or canceled workflow from its first incomplete step.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ workflows/ runs/ {run_id}/ resume Say this to your AIResume 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.
- b90
Inspect workflow steps
See each workflow step's status, duration, token use and errors.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ workflows/ runs/ {run_id} Say this to your AIShow me which step failed in that workflow.Good to knowRuns are available only while retained.
- b91
Run a task
Start a background worker to work autonomously on your task.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ run Say this to your AIStart 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.
- b92
Filter your tasks
Find tasks by state, tag or search text in your agent's list.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos Say this to your AIShow me my open tasks tagged billing. - b93
Snooze a task
Snooze a task until a wake time or clear its existing snooze.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ snooze Say this to your AISnooze this task until tomorrow. - b94
Comment on a task
Add a comment to your task's timeline without starting another agent turn.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ messages Say this to your AIAdd this customer detail to the task.
GitHub from your agent 6
- b95
Review repository changes
Read your repository's staged or unstaged changes as a unified diff.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ diff Say this to your AIShow me the staged changes in my repository.Good to knowCaptured output is capped at 1 MiB.
- b96
Draft commit messages
Have a model draft a commit message from your pending repository changes.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ commit/ suggest- message Say this to your AISuggest 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.
- b97
GitHub issues
List repository issues or open a new issue from your agent.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ issues Say this to your AIOpen an issue for the broken login page.Good to knowIssue lists return at most 200 issues, sorted by most recently updated.
- b98
Linked worktrees
Create a linked worktree to work with another branch of your repository.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ worktrees Say this to your AICreate a worktree for my feature branch. - b99
GitHub account switching
Switch the linked GitHub account used for your agent's subsequent operations.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ auth/ active Say this to your AISwitch my agent to my work GitHub account.Good to knowThe account must already be linked.
- b100
Check remote branch
Check which commit a GitHub branch points to without changing your checkout.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ remote- branch Say this to your AICheck whether my last push reached the remote branch.Good to knowIt reads GitHub with your active account and changes nothing in your checkout.
Agent setup 15
- b101
Set AI spend caps
Set chat and turn spending caps that stop work or warn you.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ spend- caps Say this to your AISet 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.
- b102
Rotate provider accounts
Your agent switches to another signed-in account of a provider when one hits its limit.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ features Say this to your AITurn on account rotation for my agent. - b103
Import MCP settings
Bring MCP server definitions from Claude, Cursor or VS Code into your agent.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ import Say this to your AIImport my MCP server settings from Cursor.Good to knowImported servers start disabled. One invalid entry stops the whole import.
- b104
Test an MCP server
Test a server configuration and see its tools before saving it.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ probe Say this to your AITest this MCP server configuration before I save it.Good to knowProbing is human-only and can start a process or make an outbound request.
- b105
Disable an MCP server
Turn off one MCP server while keeping its saved settings and credentials.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ servers/ enable Say this to your AIDisable my issue tracker MCP server for now.Good to knowDisabling cuts the server off in every live session right away.
- b106
Realm-wide instructions
Set instructions shared by your realm's chats, helpers and workflow steps.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ agent- instructions Say this to your AITell every agent in this realm to use American English.Good to knowRunning chats get the change from their next turn.
- b107
Copy an agent
Copy an agent's definition under a new name to make your own variation.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ copy Say this to your AICopy my reviewer agent so I can customize it.Good to knowCopying onto the product-owned Bot agent's name is refused.
- b108
Set agent turn limits
Set the maximum number of turns one of your agents takes per run.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ turns Say this to your AISet a turn limit for my reviewer agent.Good to knowThe Bot agent cannot be changed this way.
- b109
Restore agent defaults
Restore a shipped agent's original definition after customizing it.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ reset- to- shipped Say this to your AIReset this agent to its shipped default.Good to knowResetting discards local customizations.
- b110
Copy Claude settings
Preview and copy Claude Code configuration between your computers.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ acp/ agents/ {agent}/ file- syncs Say this to your AICopy 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.
- b111
Test a provider key
Check whether your stored provider API key is valid without revealing it.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ providers/ {id}/ auth/ test Say this to your AITest my stored provider key.Good to knowThe verdict can be valid, invalid or inconclusive. The key must already be stored.
- b112
Usage by account
See your AI usage grouped by provider and account, all time or since a date.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ usage/ by- account Say this to your AIShow 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.
- b113
Choose agent realm
Select the realm your agent uses by default for new sessions.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ hoody/ realm Say this to your AIUse 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.
- b114
Search agent logs
Filter your agent logs by session, time, level, or text.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ logs Say this to your AIFind errors in this agent session from the last hour.Good to knowUp to 500 entries per page, 200 by default.
- b115
Export redacted logs
Download your filtered agent logs as redacted JSONL or text.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ logs/ export Say this to your AIExport 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.
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.
Link
https:// api. hoody. com Say this to your AIUse the Hoody API to set this up for me. - a02
Computers on demand
Your AI creates computers in your projects, then starts, stops or deletes them.
Type
POST https:// api. hoody. com/ api/ v1/ projects/ {p}/ computers Say this to your AIAdd computers for this client project. - a03
Copy a setup
Duplicate one of your computers into another project or server.
Link
https:// api. hoody. com Say this to your AIMake a copy of my staging setup.Good to knowThe copy gets no SSH key. Firewall rules, proxy aliases and snapshots stay with the source.
- a04
Debian 13, ready to go
Your computers start on Debian 13, with dev tools ready.
Link
https:// api. hoody. com Say this to your AISet up new computers for my side project. - a05
Projects and realms
Group computers into projects, and limit what each token can see and control with realms.
Link
https:// api. hoody. com Say this to your AIMake sure this client's token only sees their project. - a06
Tokens for automation
Give scripts and AIs their own tokens, limited to what they need.
Link
https:// api. hoody. com Say this to your AIMake a token for my deploy script that expires in 30 days and only works from my server's IP. - a07
Command line
Run most of Hoody from the `hoody` command on your laptop.
Type
curl -fsSL https:/ / install. hoody. com | sh Say this to your AIInstall 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.
- a08
Open source SDK
Build on Hoody from TypeScript with the open source SDK.
Type
npm install hoody-sdk Say this to your AIWrite a script with the Hoody SDK that lists my computers. - a09
A manual for any AI
Any AI can read one manual and learn to use Hoody.
Link
https:// hoody. com/ SKILLS/ Say this to your AIRead hoody.com/SKILLS and set me up.Good to knowYour AI needs to run code with network access to sign you in.
- a19
Copy from a snapshot
Create an independent computer from a chosen snapshot of your source.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ copy Say this to your AICreate 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.
- a20
Copy network rules
Carry your computer's firewall and network rules into a new copy.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ copy Say this to your AICopy 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.
- a21
Merge environment variables
Update several environment variables without removing your other settings.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ env Say this to your AISet 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.
- a22
Computer status history
Inspect your computer's state changes to investigate unexpected stops or slow starts.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ status- logs Say this to your AIShow me when my computer stopped and what triggered it.
Projects, tokens and sign-in 11
- a23
Project access levels
Grant another user read, edit or delete access to your project.
Link
https:// api. hoody. com/ api/ v1/ projects/ {id}/ permissions Say this to your AIGive Sam read access to my project.Good to knowYou must be the owner or have edit permission. Access applies immediately.
- a24
Project computer quotas
Set a computer limit for your project when you create or update it.
Link
https:// api. hoody. com/ api/ v1/ projects/ {id} Say this to your AILimit this project to five computers.Good to knowYou must be the owner or have edit permission. The minimum quota is 0.
- a25
Project resource statistics
Get resource statistics for each computer in your project in one response.
Link
https:// api. hoody. com/ api/ v1/ projects/ {id}/ stats Say this to your AIShow resource usage for the computers in my project.Good to knowA computer whose statistics could not be read can have a placeholder entry.
- a26
Monthly project traffic
Get monthly proxied request counts and response bytes across your project.
Link
https:// api. hoody. com/ api/ v1/ projects/ {id}/ proxy- usage Say this to your AIShow 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.
- a27
Inspect your current token
Check the permissions and realm restrictions of your current API token.
Link
https:// api. hoody. com/ api/ v1/ auth/ tokens/ me Say this to your AIShow me what my current token can access. - a28
Token permission templates
List permission templates and their resolved permissions before creating your token.
Link
https:// api. hoody. com/ api/ v1/ auth/ tokens/ templates Say this to your AIShow me the available token permission templates. - a29
Copy token permissions
Create a token with another token's permissions, realms and IP whitelist.
Link
https:// api. hoody. com/ api/ v1/ auth/ tokens/ {id}/ copy Say this to your AICopy this token's restrictions into a new token.Good to knowThe copy has a new secret value.
- a30
Adjust token realms
Add or remove a realm from an existing restricted token.
Say this to your AIAdd the staging realm to this token.Good to knowThe last realm of a realm-restricted token cannot be removed.
- a31
Count resources by realm
List your realms with counts of projects, computers, servers and tokens.
Link
https:// api. hoody. com/ api/ v1/ realms/ ?include_usage=true Say this to your AICount the resources in each of my realms.Good to knowThe request requires resources.realms permission.
- a32
Device code sign-in
Start a device sign-in with a short code your user can type.
Link
https:// api. hoody. com/ api/ v1/ auth/ device/ code Say this to your AIStart 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.
- a33
App identity claims
Prove to your app that Hoody signed in this user, checked offline with a public key.
Link
https:// api. hoody. com/ api/ v1/ users/ auth/ identity- claim Say this to your AIIssue 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.
Command line tools 5
- a34
CLI account profiles
Switch CLI settings and sign-ins between your accounts or environments.
Say this to your AISet up a separate CLI profile for staging. - a35
Preview CLI requests
See the HTTP request a CLI command would send, or get it as a curl line.
Say this to your AIShow 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.
- a36
Wait for CLI operations
Have your script wait for a long-running operation to finish.
Say this to your AICopy this computer and wait until the copy finishes.Good to knowThe default wait timeout is 10 minutes.
- a37
Watch CLI lists
Refresh a CLI list repeatedly as your resources change.
Say this to your AIWatch my computer list update every five seconds.Good to knowRequires an interactive terminal. The default interval is 2 seconds.
- a38
Lock local CLI credentials
Encrypt your saved CLI tokens and default IDs with a password.
Say this to your AIProtect my saved CLI credentials with a password.Good to knowTurning the lock on deletes any saved account password.
Agent building blocks 4
- a39
One-off model replies
Get one model reply for your app, as JSON or streamed, with no agent session.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ completions Say this to your AIGet a one-off model reply for this text.Good to knowNo session, transcript or tool use. Every call is billed.
- a40
Run a tool directly
Call an agent tool directly and receive its result in your application.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ tools/ {name}/ run Say this to your AICall 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.
- a41
Inspect agent tools
List your agent's built-in tools and inspect their input schemas.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ tools Say this to your AIShow me the inputs for the agent's built-in tools. - a42
Watch agent data changes
Stream change notifications so your app can refresh affected agent data.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ changes/ stream Say this to your AIUpdate my dashboard when agent data changes.Good to knowTokens only say which lists changed; your app re-reads those lists.
Your apps and AI models 14
- a10
Embed live tools
Put a live terminal, desktop, editor or database in your own page.
Link
https:/in an iframe/ {p}- {c}- terminal- 1. {node}. computers. hoody. com Say this to your AIShow my live terminal inside my dashboard page.Good to knowSet proxy permissions before you embed a link others can see.
- a11
Your Exec script on every request
Matching requests go to your Exec script first: check, change or answer them.
Say this to your AIAdd 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.
- a12
AI models by link
Call many AI models from your computers with no API key.
Say this to your AIUse 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.
- a13
Watch your AI calls
Route your AI calls through an Exec script to log, cache or change them.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 Say this to your AILog every AI call my app makes. - a14
Speech in and out
Turn text into speech and speech into text.
Link
https:/· `.../audio/transcriptions`/ ai. hoody. com/ api/ v1/ audio/ speech Say this to your AIRead this article out loud as an audio file.Good to knowFree within your server's voice limits, from inside your computers.
- a16
Free web search
Code in your computers can search the web with no API key, free within your server's limits.
Type
POST https:// ai. hoody. com/ api/ v1/ coding_plan/ search Say this to your AISearch the web for how others fixed this error.Good to knowFree within your server's limits, from inside your computers.
- a17
Yes/no answers from AI
Ask Hoody AI yes/no, pick-one or score questions and get back how likely each answer is.
Type
POST https:// ai. hoody. com/ api/ v1/ decisions Say this to your AIHave AI decide if each support ticket is urgent.Good to knowFree within your server's limits, from inside your computers.
- a18
AI switch per computer
Turn AI on or off for each computer, and see what each one used.
Say this to your AITurn off AI on my client's computer. - a43
Open a specific view
Build a link to your chosen file editor, terminal session or database table view.
Say this to your AIMake 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.
- a44
Import an API
Turn another API's OpenAPI document into script endpoints that forward calls.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ sdk/ import Say this to your AIImport this API specification as script endpoints. - a45
Document script APIs
Generate an OpenAPI specification for your scripts.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ user- openapi/ generate Say this to your AIGenerate an OpenAPI specification for my scripts. - a46
Rewrite service responses
Inspect and change your service's response before it reaches the caller.
Say this to your AIAdd 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.
- a47
Read visitor IPs
Read your visitors' real IP addresses in apps reached through your Hoody links.
Say this to your AIShow 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.
- a48
Look up visitor networks
Look up country and network information for your visitors' public IPv4 addresses.
Link
https:// api. hoody. com/ api/ v1/ ip/ lookup?ip={ips} Say this to your AIShow 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.
Hoody AI models 8
- a49
Browse the model catalog
List available models with their context lengths, modalities and current prices.
Link
https:// api. hoody. com/ api/ v1/ ai/ models Say this to your AIList the available AI models and their context lengths.Good to knowThe catalog is cached. OpenAI, Anthropic and Google models are excluded.
- a50
Stream model answers
Show your users text as the model generates its answer.
Say this to your AIStream the answer into my chat app.Good to knowCall from inside a computer with AI enabled.
- a51
Connect coding assistants
Point Cline, Cursor or Windsurf at Hoody AI from your computer.
Say this to your AIConnect 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.
- a52
Use model tool calls
Send tool definitions with your chat request for a supported model to use.
Say this to your AILet my model call the weather function.Good to knowWorks when the model answering supports tools. Call from inside a computer with AI enabled.
- a53
Decide from a screenshot
Ask Hoody AI yes/no questions about a screenshot, such as whether a page broke.
Say this to your AICheck 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.
- a54
Decisions with your own model
Ask yes/no, pick-one or score questions through your agent, answered by the model you choose.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ jev/ decide Say this to your AIAsk the agent to classify this ticket with my configured model.Good to knowAnother provider's model requires that provider's key.
- a55
Check free AI allowances
See roughly how much of each server's free AI allowance your account has used.
Link
https:// api. hoody. com/ api/ v1/ users/ me/ free- ai- usage Say this to your AIShow 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`.
- a56
Delete AI usage records
Delete your computer's AI usage records older than a chosen time.
Say this to your AIDelete 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.
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 AITranscribe 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.
- a58
Choose a speech voice
Choose one of four voices and get your text as PCM or MP3 audio.
Say this to your AIRead 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.
- a59
Stream speech audio
Stream generated speech to your app as it becomes available.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ audio/ speech/ stream Say this to your AIStream the spoken answer to my app.Good to knowOnly for models that stream speech.
- a60
Timestamp a transcript
Request a transcript with segments and timing when those details are available.
Say this to your AITranscribe 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.
- a61
Find speech models
List speech models and filter them by transcription or speech capability.
Link
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ audio/ models Say this to your AIList the speech-to-text models available to my agent.Good to knowA listed model can still be unavailable for a call.
AI request proxy 4
- a62
Review risky AI requests
Hold an AI request in your proxy until a person approves or rejects it.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 Say this to your AIHold 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.
- a63
Add knowledge to prompts
Use your proxy script to add knowledge base results to prompts.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 Say this to your AIAdd relevant company documentation to each AI prompt.Good to knowProtect the proxy with a script token and proxy permissions before sharing it.
- a64
Route to another provider
Use your proxy script to send AI requests to a provider you choose.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 Say this to your AIRoute this app's AI requests to my provider.Good to knowYou manage your own provider keys and proxy security.
- a65
Rewrite AI tool calls
Use your proxy to change a model's tool call before the client runs it.
Link
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 Say this to your AIRedirect AI file writes to my review folder.Good to knowRewriting is routing, not confinement. Enforce restrictions in the tool that executes the call.
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.
Link
https:// {p}- {c}- <kit>- 1. {node}. computers. hoody. com Say this to your AISend me the link to that. - x02
Work together live
Share a link and work in the same terminal, desktop or editor at once.
Say this to your AIShare 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.
- x03
People and AIs together
People and AIs work side by side in the same tools, any mix.
Say this to your AILet my AI work in the same desktop while I watch. - x04
Snapshots and undo
Save snapshots of your computers' storage and restore them in one step.
Link
https:// api. hoody. com Say this to your AITake 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.
- 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 AIIs this link private? - 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 AIPut a password on my desktop link before I share it. - 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 AIShow me which API calls my AI's token made this week. - x08
Encrypted vault
Keep passwords and keys in your vault, and turn on encryption for each entry.
Say this to your AISave my Stripe key in my vault. - x23
Encrypted disks
Your computer's disk is encrypted at rest on every Hoody server.
Say this to your AIIs my computer's disk encrypted?Good to knowDisk encryption does not protect data on a running server.
- x24
Pause URL access
Cut off new requests to your computer's URLs while you investigate an incident.
Link
https:// api. hoody. com/ api/ v1/ computers/ {c}/ proxy/ permissions/ state Say this to your AIPause 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.
- x25
Expiring snapshots
Set your computer snapshot to expire after a chosen number of days.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ snapshots Say this to your AITake 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.
- x26
Label a snapshot
Change a snapshot's label to mark a known-good computer state.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ snapshots/ {name}/ alias Say this to your AILabel that snapshot as the tested release.Good to knowThe alias can be up to 100 characters. Changing it does not rename the snapshot.
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 AIOnly 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.
- x28
Partner access tokens
Give a partner access through a token in a header, cookie or query parameter.
Say this to your AIGive my partner a token for the API.Good to knowA group must have program grants, and unmatched callers remain subject to the default policy.
- x29
JWT access for apps
Let your application's users open selected services with tokens your app issues.
Say this to your AIRequire my app's JWT for its service.Good to knowA group must have program grants, and unmatched callers remain subject to the default policy.
- x30
Protect new services
Set the default to deny so programs you add later stay closed until you grant them.
Say this to your AIKeep new services closed until I grant access.Good to knowSet up your groups first. Under allow, a new program is open from the start.
- x31
Project-wide URL rules
Apply URL access rules across your project and override them on individual computers.
Say this to your AIApply 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.
- x32
Grant selected app ports
Give an access group specific ports for your HTTP or HTTPS apps.
Say this to your AIAllow 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.
- x33
Choose terminal instances
Grant a group access to specific terminal instances on your computer.
Say this to your AILet the team use terminals 1 and 2.Good to knowSet a default-deny policy to keep unmatched callers out.
- x34
Inspect service access
See your service's group access, hooks and effective default together.
Link
https:// api. hoody. com/ api/ v1/ computers/ {id}/ proxy/ services/ {service} Say this to your AIShow me the access rules for my terminal.
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 HoodyGood to knowYour AI needs to run code with network access to sign you in.
- x10
ssh hoody.com
Type `ssh hoody.com` in any terminal, or click it to open in your browser.
Type
ssh hoody.· `https://ssh.hoody.com`com Say this to your AIHow do I get in from my terminal? - x11
Open in any browser
Sign in at hub.hoody.com from any device to open your Hub: your computers and your agent.
Link
https:// hub. hoody. com Say this to your AIOpen my Hoody in the browser. - x12
Phone first
Use everything from your phone, and install what you build as an app.
Say this to your AIMake this dashboard installable on my phone. - x13
Build your own OS
Build your own web desktop or full workflow in plain HTML.
Say this to your AIBuild 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 AIOpen 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.
- x36
Try a sample account
Explore the terminal Hub with a sample account and no sign-in.
Say this to your AIOpen the Hub's sample account.Good to knowThe terminal Hub requires an interactive terminal.
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 AISign 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.
- x15
Hoody AI (free)
A free built-in AI with no key or setup, from inside your computers.
Say this to your AIUse the free model for now.Good to knowLimits are per server and shared by all its computers.
- x16
Switch AIs, keep everything
Change AI anytime; files, projects, memory and tasks stay.
Say this to your AIMove 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 AISet me up on the free plan.Good to knowOne free server per eligible account, while free capacity lasts.
- 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 AIRent a bigger server for this project.Good to knowA free server cannot be upgraded in place. Paid servers start at $10 a month.
- x19
Pay your way
Pay by card or crypto, and share servers with your team by role.
Say this to your AITop up my balance with crypto.
Servers and plans 9
- x37
Find servers by region
Filter available servers by location, specifications and price before renting.
Say this to your AIFind a server near my European users.Good to knowRentals start at one day; prices vary by listing and rental period.
- x38
See plans on sale
List the paid server plans on sale, with their short link and Bot URL limits.
Link
https:// api. hoody. com/ api/ v1/ subserver- plans Say this to your AIShow me the paid server plans on sale.Good to knowThe purchase quote says whether a plan can be bought at that moment.
- x39
Upgrade Plus to Pro
Upgrade your Plus server to Pro while keeping its ID and data.
Say this to your AIUpgrade 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.
- x40
Quote a server plan
Check a paid server plan's current price and available capacity before purchase.
Link
https:// api. hoody. com/ api/ v1/ subserver- subscriptions/ quote Say this to your AIQuote the current price for the Plus server plan. - x41
Check free server eligibility
Check whether your account can claim a free server and why it cannot.
Link
https:// api. hoody. com/ api/ v1/ users/ me/ free- tier- status Say this to your AICan 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.
- x42
Server renewal setting
Turn automatic renewal on or off for your paid server.
Link
https:// api. hoody. com/ api/ v1/ subserver- subscriptions/ {id}/ auto- renew Say this to your AITurn 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.
- x43
Extend a server rental
Add days to your existing server rental through the API.
Link
https:// api. hoody. com/ api/ v1/ rentals/ {id}/ extend Say this to your AIExtend my server rental by 30 days.Good to knowAdditional days range from 1 through 3650 and must match server pricing.
- x44
Reserve an offered server
Reserve an out-of-stock machine for delivery with a spending ceiling.
Link
https:// api. hoody. com/ api/ v1/ offers/ {id}/ reserve Say this to your AIReserve this server offer for 30 days.Good to knowThe reservation charges immediately. Paid reservations require a maximum charge and an idempotency key.
- x45
Bare metal server commands
Check uptime or memory, or reboot your rented Bare metal server by API.
Link
https:// api. hoody. com/ api/ v1/ servers/ {serverId}/ execute- command Say this to your AICheck 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.
Your account 12
- x20
Two-factor sign-in
Protect your account with an authenticator app and backup codes.
Say this to your AITurn on two-factor sign-in for my account. - x21
Earn referral credit
Share your referral link and earn credit for servers when people you invite pay.
Say this to your AIGive 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.
- x22
Support tickets
Open a support ticket and follow the replies from the CLI or the API.
Link
https:// api. hoody. com/ api/ v1/ support/ tickets Say this to your AIOpen a support ticket about my computer not starting. - x46
End one sign-in
Sign out one forgotten device while keeping your other sessions open.
Link
https:// api. hoody. com/ api/ v1/ users/ auth/ sessions/ {id} Say this to your AISign 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.
- x47
Sign out other devices
End every other account session while keeping your current sign-in.
Link
https:// api. hoody. com/ api/ v1/ users/ auth/ sessions/ revoke- others Say this to your AISign 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.
- x48
Replace backup codes
Generate new two-factor backup codes if your old ones are compromised.
Link
https:// api. hoody. com/ api/ v1/ users/ auth/ 2fa/ backup- codes/ regenerate Say this to your AIGenerate new two-factor backup codes for my account.Good to knowRequires your password and current OTP code. Existing backup codes become invalid.
- x49
Review rejected sign-ins
Include failed sign-in attempts when you review your account security history.
Link
https:// api. hoody. com/ api/ v1/ users/ me/ security- history?include_failed=true Say this to your AIShow 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.
- x50
Change account email
Request a new account email and confirm it through your new address.
Link
https:// api. hoody. com/ api/ v1/ users/ me/ email- change Say this to your AIChange 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.
- x51
Support reply alerts
Get an in-app notification when support replies to your ticket.
Say this to your AITell 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.
- x52
Custom referral codes
Create a memorable referral code for people you invite to Hoody.
Link
https:// api. hoody. com/ api/ v1/ referrals/ me/ codes Say this to your AICreate 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.
- x53
Track referral earnings
See your referral codes, level, counts and credit totals.
Link
https:// api. hoody. com/ api/ v1/ referrals/ me Say this to your AIShow 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.
- x54
Withdraw referral credit
At the Creator level, take your available Referral credit out as money through support.
Say this to your AIAsk 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.
Balances and invoices 4
- x55
Check all balances
See your General Balance, Referral credit and AI Balance in one call.
Link
https:// api. hoody. com/ api/ v1/ wallet/ balances Say this to your AIShow 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.
- x56
Review wallet transactions
Review your payments, charges, transfers and refunds in one transaction history.
Link
https:// api. hoody. com/ api/ v1/ wallet/ transactions Say this to your AIShow 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.
- x57
Download invoice PDFs
Download your invoices as PDFs for accounting, taxes or client billing.
Link
https:// api. hoody. com/ api/ v1/ wallet/ invoices/ {id}/ pdf Say this to your AIDownload 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.
- x58
Check a payment
Look up your card or crypto payment by its intent ID.
Say this to your AICheck whether my crypto top-up has been credited.Good to knowPayment lookups need a signed-in session. An auth token is refused.