# Find documentation by task.

Oysterun Docs

Start with Getting Started for your first journey; for a specific task, search the current guides or browse the task groups below.

## Host and connection

- [Sign in to an Oysterun Host and confirm the connection](/docs/host-authentication-and-connection/en/index.html): Open the exact current Host URL in a private browser profile, use its password-only flow, recover safely, and confirm Sessions is Connected through the expected transport. (how-to)
- [Set up and understand your Oysterun Host](/docs/set-up-and-understand-a-host/en/index.html): Complete the current supported Host setup, then use visible product state to distinguish the Host, a Session, its AgentFolder, its Agent ID, and a Website shared link. (tutorial)

## Sessions and providers

- [Choose a Session folder and control which settings are saved](/docs/configure-session-files-and-settings/en/index.html): Choose a focused Start Folder, preserve your setup draft when canceling or confirming the Folder Picker, and decide whether Session settings apply once or persist with the project. (how-to)
- [Choose and recover an Oysterun provider](/docs/choose-and-recover-a-provider/en/index.html): Choose Claude or Codex in Session Setup, separate dashboard access from provider login, and follow one bounded recovery path when its command or login is unavailable. (troubleshooting)
- [How to tell whether an Oysterun agent is working or idle](/docs/understand-agent-activity/en/index.html): Send one safe message from the Sessions page and distinguish available, occupied, working, terminal, and unknown states without duplicate work. (how-to)

## Chat, messages, and files

- [How to read large Oysterun Tool results](/docs/read-large-tool-results/en/index.html): Distinguish a long Tool run from one oversized result, then use View details, paging, and bounded content to read what is currently available. (how-to)
- [How to send images and media in Oysterun](/docs/send-images-and-media/en/index.html): Send one or several media items once from a Session chat, then check order, the shared caption, and the difference between original and bounded display bytes. (how-to)

## Recovery and troubleshooting

- [Restore work safely after an Oysterun Host restart](/docs/restore-work-after-a-host-restart/en/index.html): Restart only with current permission for the exact Host and action, then verify the actual returned state of Sessions, conversation history, interrupted work, and Loops. (troubleshooting)
- [Recover safely from an Oysterun Host runtime error](/docs/recover-from-a-host-runtime-error/en/index.html): Preserve a read-only Explorer runtime error, use visible Back once, and finish Recovered when the same Session chat returns with expected history and a usable composer. (troubleshooting)

## CLI and Skills

- [How to use the Oysterun CLI safely](/docs/use-the-oysterun-cli-safely/en/index.html): Find supported operations from CLI help, distinguish reads from ordinary and protected mutations, and use dry-run and confirmation boundaries correctly. (reference)
- [How to install and use an Oysterun Skill](/docs/install-and-use-a-skill/en/index.html): Find, install or update, verify, and safely use an eligible Oysterun Skill in a Claude or Codex Session. (how-to)