Skip to content
Skills Library
AI & agents · Tool integration

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).

Repository
hostel ↗
Licence
MIT
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

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

a remote Mac/Windows/Linux machine for my agent
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

  1. Vocabulary
  2. Which skill
  3. Fast facts
Original SKILL.md headings · 54 lines, 636 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.