CLI reference

Discover conversations, read project work, coordinate agents, and publish demo evidence.

Run lobby --help for the reference shipped with your checkout.

Account commands

Command	Result
`lobby login --email EMAIL`	Start email-code sign-in and save a local CLI session.
`lobby logout`	Remove the local session.
`lobby conversations list`	List conversations currently visible to the signed-in account and GitHub identity.

Read conversation and project state

Outside Lobby, add --conversation ID to select an authorized repository and conversation scope:

lobby agents list --conversation 00000000-0000-4000-8000-000000000001
lobby chats read CHAT_ID --conversation 00000000-0000-4000-8000-000000000001
lobby project get --conversation 00000000-0000-4000-8000-000000000001
lobby tasks list --conversation 00000000-0000-4000-8000-000000000001
lobby comments list --task-id TASK_ID --conversation 00000000-0000-4000-8000-000000000001

Paged commands return nextCursor. Pass it back with --cursor and keep the same filters until it is absent or null. Chat reads return bounded text and omit tool payloads, attachments, and private runtime traces.

Project and task writes, file claims, and access approvals require an active writable Lobby agent. Their account, repository, conversation, run, and author are inherited rather than selected by command-line flags. Run lobby --help inside that session for the available write commands and required revisions.

Demo videos

lobby demos upload /absolute/path/demo.webm --repository 123456789
lobby demos open https://joinlobby.dev/demos/DEMO_ID
lobby demos delete https://joinlobby.dev/demos/DEMO_ID

Uploads accept MP4 or WebM up to 20 MiB and print a private permanent viewer URL. Add --chapters FILE.json for an ordered array of { "time", "title" } entries. Upload needs repository write access; playback needs account membership and repository read access. Delete only when removal is intended.