Commands

Text

dothotel <command> [arguments] [options]

Command	Aliases	What it does
`add`	`install`, `i`	Install rooms as skills or plugins
`search`	`find`	Find rooms in the directory
`info`		Show a room's door and full instructions
`paste`		Print a room's paste-in text
`list`	`ls`	Show rooms you've installed
`update`		Install newer versions of your rooms
`remove`	`rm`, `uninstall`	Delete installed rooms

Naming a room

Anywhere a command takes a <room>, you can use any of these:

Form	Example
Name (slug)	`sunday-digest`
Room number	`102` or `#102`
Room link	`https://dothotel.app/rooms/sunday-digest`

add

Installs one or more rooms. For each room it shows the door, asks for confirmation, then writes the files.

Text

dothotel add <room...> [-g] [--plugin] [--dir <path>] [-f] [-y]

Option	Description
`-g`, `--global`	Install the skill in `~/.agents/skills` instead of `./.agents/skills`
`--plugin`	Install the full plugin bundle in `~/.codex/plugins`
`-d`, `--dir <path>`	Install into this folder instead
`-f`, `--force`	Replace a room that's already installed
`-y`, `--yes`	Don't ask for confirmation

Shell

dothotel add sunday-digest                  # skill, this project
dothotel add 101 102 -g                     # two rooms, everywhere
dothotel add sunday-digest --plugin         # plugin bundle
dothotel add sunday-digest --dir ./my-skills

Text

Room 102 · Sunday Inbox Digest v1 ✓ reviewed by the front desk
Once a week, it turns your inbox into one short digest: what needs a reply, …

Key card: Lobby pass
Apps: Gmail
Allow:
  - Read email from the past 7 days
  - Send one weekly digest email to me only
Block:
  - Archive, label, move, or delete any email
  - Email anyone other than me
Never:
  - Read-only on your inbox: no archiving, labeling, or deleting
  - Never emails anyone but you

Check in to room 102 as a skill? (Y/n) y
✓ Checked in to Sunday Inbox Digest → ./.agents/skills/dot-hotel-sunday-digest

If a room is already installed, add stops and suggests --force or update.

search

Searches room titles and summaries. With no query, it lists the most popular rooms.

Text

dothotel search [query] [--tag <tag>] [--app <app>] [--keycard <card>] [--sort popular|new] [--limit <n>] [--json]

Option	Description
`--tag <tag>`	`Work`, `Life` or `Dev`
`--app <app>`	Rooms that use an app, e.g. `gmail`. See Supported apps for every name
`--keycard <card>`	`lobby`, `floor` or `master`
`--sort <order>`	`popular` (default) or `new`
`--limit <n>`	How many results, 1–60 (default 20)
`--json`	Print the results as JSON

Shell

dothotel search inbox
dothotel search --app github --keycard floor
dothotel search --sort new --limit 5

Text

#102 Sunday Inbox Digest (sunday-digest) ✓ reviewed
     Once a week, it turns your inbox into one short digest: …
     Lobby pass · 312 check-ins · by @front-desk · Gmail

info

Shows a room's door, then its full instructions. Doesn't install anything or count as a check-in.

Text

dothotel info <room> [--json]

Shell

dothotel info 102
dothotel info sunday-digest --json

paste

Prints the paste-in text for a Dot: instructions, Custom Rules and guardrails in one block. Counts as a check-in.

Text

dothotel paste <room>

Shell

dothotel paste 102 | pbcopy      # macOS: copy to the clipboard
dothotel paste 102 | clip        # Windows
dothotel paste 102 > room.txt

list

Shows the rooms installed in a location, with their version.

Text

dothotel list [-g] [--plugin] [--dir <path>] [--json]

It looks in the same place add would install to, so use the same options: dothotel list -g for global skills, dothotel list --plugin for plugins.

Text

/my-project/.agents/skills
#101 Feedback Triage Desk feedback-triage · v1 · https://dothotel.app
#102 Sunday Inbox Digest sunday-digest · v2 · https://dothotel.app

update

Checks your installed rooms for newer versions and installs them. With no arguments, it checks every room in the location.

Text

dothotel update [room...] [-g] [--plugin] [--dir <path>] [-f]

Text

· Feedback Triage Desk v1 is current
✓ Sunday Inbox Digest v1 → v2 (new version not reviewed yet)

Rooms that are already current are skipped. -f reinstalls them anyway.
If a room has been closed or taken down, update says so and suggests removing it.

remove

Deletes installed rooms. Only folders the CLI installed can be removed.

Text

dothotel remove <room...> [-g] [--plugin] [--dir <path>]

Shell

dothotel remove sunday-digest
dothotel rm 101 102 -g

Global options

Option	Description
`-h`, `--help`	Show help
`-v`, `--version`	Show the CLI version

Colors are turned off when the output isn't a terminal, or when the NO_COLOR environment variable is set.

Exit codes

Code	Meaning
`0`	Everything succeeded
`1`	At least one room or command failed. The error is printed on stderr