hostel
/hostel
The entry point for Hostel. Use it when the user mentions Hostel, machines, leases, or "a remote Mac/Windows/Linux machine for my agent", and you must find the skill for the task (install, set up a server, add a machine, add a tool, invite a coworker, use a machine, fix a problem).
- Author
- csansoon ↗
- Repository
- hostel ↗
- Licence
- MIT
- Last repository change
- 13.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
The entry point for Hostel. Use it when the user mentions Hostel, machines, leases, or "a remote Mac/Windows/Linux machine for my agent", and you must find the skill for the task (install, set up a server, add a machine, add a tool, invite a coworker, use a machine, fix a problem).
Triggers from the description
Original author description
The entry point for Hostel. Use it when the user mentions Hostel, machines, leases, or "a remote Mac/Windows/Linux machine for my agent", and you must find the skill for the task (install, set up a server, add a machine, add a tool, invite a coworker, use a machine, fix a problem).
How it works
- Vocabulary
- Which skill
- Fast facts
SKILL.md preview
--- name: hostel description: The entry point for Hostel. Use it when the user mentions Hostel, machines, leases, or "a remote Mac/Windows/Linux machine for my agent", and you must find the skill for the task (install, set up a server, add a machine, add a tool, invite a coworker, use a machine, fix a problem). --- # Hostel Hostel gives coding agents short, temporary, exclusive access to remote machines for builds, UI QA, and device tests. The agent keeps the code on its own computer. When it needs another machine (for Android, iOS, macOS, Windows, or Linux), it asks the Hostel server for a lease with the tools that it needs, works on a machine over SSH, and releases it. At the end of each lease, cleanup deletes its work directory, jobs, and screens; caches stay. One Go binary, `hostel`, has all three parts: the server, the guest (the CLI that agents and people use), and the helper on machines. ## Vocabulary Use these plain words. Only Hostel, Guest, and Room come from the hostel theme. | Word | Meaning | |---|---| | server | The central process (`hostel server run`). It keeps the waiting line, the users, the configuration, and the SSH gateway. | | guest | The `hostel` CLI on a person's computer. Agents on that computer use it too. | | machine | A real computer or VM: a static host, or a cloud machine that an on-demand provider created. | | template | What an on-demand provider creates machines from, in the configuration (up to `max_machines` machines at a time). | | provider | A source of machines: `static` (your own hosts), `namespace` (on-demand cloud), `external` (your own command). | | tool | What a machine gives to a lease, and what a guest asks for. Software (`android-sdk`, `xcode`, `jdk`, `node`) is usable in every lease on the machine. A screen tool (`android-emulator`, `ios-simulator`, `macos-desktop`, `windows-desktop`) starts only for a lease that asks for it. | | option | A version of a software tool (`node:22`) or a phone or tablet of a screen tool (`android-emulator:pixel-9`). | | room | A place for one lease on a machine. A machine has one room by default. | | lease | One guest's exclusive use of a room, for one task. It ends at release, or after 10 minutes without a `hostel` command or tunnel data. | | waiting line | The leases that wait for a room: one line for all tools, in three lanes (`high`, `normal`, `low`). | | user | A person on the server, with the role `admin` or `member`. | ## Which skill | The user wants to... | Skill | |---|---| | "install hostel", "update hostel", "connect this computer", "open the Hostel app" | `hostel-install` | | "set up a Hostel server", "run Hostel on a VPS", "on my home machine", "back up the server" | `hostel-server-setup` | | "add a Mac / Windows PC / Linux box", "add a machine behind NAT", "use Namespace", "remove or drain a machine" | `hostel-machines` | | "add iOS / Android to a machine", "what does the machine need", "make my own tool", "change a tool script" | `hostel-tools` | | "invite a coworker", "make someone admin", "connect my other laptop", "remove a user" | `hostel-users` | | "build the Android app", "run the tests on Windows", "take a screenshot", "tunnel my local API", "tell my agent to use Hostel" | `hostel-use` | | "the machine is broken", "offline", "acquire fails with 69/78", "TLS key changed", "where are the logs" | `hostel-troubleshoot` | ## Fast facts - `hostel` alone in a terminal opens the Hostel app (Front desk, Lobby, Rooms). Agents use `hostel <verb>` commands only. - `hostel agent-guide` prints the instructions for agents. It is the source of truth for lease commands. - `hostel help` lists all commands. `hostel --version` prints the version. - Server configuration lives in the server's database. Admins change it from their own computer with `hostel config ...`. Only a few local keys stay in `server.toml` on the server machine. - The design and all contracts are in `docs/design.md` of the repository.
Versions
The database has no other skills named hostel.
Database snapshot: 13.11.2026 · package version 5b89b8bfae50 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100hostel-server-setup
Set up, configure, back up, or update a Hostel server on a Linux VPS or a home machine. Use it when the user says "set up a Hostel server", "deploy hostel", "run hostel server", "put Hostel behind Caddy/a proxy", "change a server setting", "server.toml", "back up Hostel", or "update the server". - 100hostel-use
Use a Hostel machine from a repository - acquire a lease with the tools that you need, run builds and tests, sync files, take screenshots, open tunnels, and release. Use it when the user or agent says "build the Android/iOS app", "run the tests on Windows/Linux/macOS", "QA on… - 100crossagent
Split or run work across this machine and the user's other machines over ssh (the hosts in ~/.config/crossagent/hosts.json). Local work goes to native Claude Code subagents, work on another host to its <host>-worker subagent (a headless Claude Code there that the user can watch…