# Oysterun Docs

Task-oriented English and Traditional Chinese documentation routes.

## Host and connection / Host 與連線

- [Sign in to an Oysterun Host and confirm the connection](https://oysterun.com/docs/host-authentication-and-connection/en/index.md): 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.
- [安全登入 Oysterun Host 並確認連線](https://oysterun.com/docs/host-authentication-and-connection/zh/index.md): 在私密瀏覽器 profile 開啟確切的目前 Host URL、使用只要求密碼的流程、安全處理錯誤，並確認 Sessions 已透過預期傳輸方式 Connected。
- [Set up and understand your Oysterun Host](https://oysterun.com/docs/set-up-and-understand-a-host/en/index.md): 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.
- [設定並理解你的 Oysterun Host](https://oysterun.com/docs/set-up-and-understand-a-host/zh/index.md): 完成目前支援的 Host 設定流程，再從畫面區分 Host、Session、AgentFolder、Agent ID 與 Website shared link。

## Sessions and providers / Session 與提供者

- [Choose a Session folder and control which settings are saved](https://oysterun.com/docs/configure-session-files-and-settings/en/index.md): 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.
- [選擇 Session 資料夾並控制設定是否儲存](https://oysterun.com/docs/configure-session-files-and-settings/zh/index.md): 選擇範圍明確的 Start Folder、在 Folder Picker 取消或確認時保留設定草稿，並判斷 Session 設定只套用一次或寫入專案設定。
- [Choose and recover an Oysterun provider](https://oysterun.com/docs/choose-and-recover-a-provider/en/index.md): 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.
- [選擇並恢復 Oysterun 提供者](https://oysterun.com/docs/choose-and-recover-a-provider/zh/index.md): 在 Session Setup 選擇 Claude 或 Codex、分清 dashboard 與提供者登入，並在命令或登入失效時走完一次有界復原。
- [How to tell whether an Oysterun agent is working or idle](https://oysterun.com/docs/understand-agent-activity/en/index.md): Send one safe message from the Sessions page and distinguish available, occupied, working, terminal, and unknown states without duplicate work.
- [如何判讀 Oysterun Agent 正在工作或已經閒置](https://oysterun.com/docs/understand-agent-activity/zh/index.md): 從 Sessions 頁面實際送出一則安全訊息，分辨可用、占用、工作、完成與未知狀態，避免重複派工。

## Chat, messages, and files / 對話、訊息與檔案

- [How to read large Oysterun Tool results](https://oysterun.com/docs/read-large-tool-results/en/index.md): Distinguish a long Tool run from one oversized result, then use View details, paging, and bounded content to read what is currently available.
- [如何閱讀 Oysterun 的大型 Tool 結果](https://oysterun.com/docs/read-large-tool-results/zh/index.md): 分辨長串 Tool 活動與單一超大結果，使用 View details、分頁和有界內容安全地閱讀目前可用資訊。
- [How to send images and media in Oysterun](https://oysterun.com/docs/send-images-and-media/en/index.md): 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.
- [如何在 Oysterun 傳送圖片與媒體](https://oysterun.com/docs/send-images-and-media/zh/index.md): 從 Session 聊天一次傳送單一或多個媒體項目，檢查順序、共用說明文字，以及原始檔與有界顯示版本的差異。

## Recovery and troubleshooting / 復原與疑難排解

- [Restore work safely after an Oysterun Host restart](https://oysterun.com/docs/restore-work-after-a-host-restart/en/index.md): 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.
- [Host 重新啟動後，安全確認工作是否恢復](https://oysterun.com/docs/restore-work-after-a-host-restart/zh/index.md): 只在取得針對確切 Host 與本次動作的許可後重新啟動，並逐一確認 Session、對話紀錄、進行中工作與 Loop 的實際恢復狀態。
- [Recover safely from an Oysterun Host runtime error](https://oysterun.com/docs/recover-from-a-host-runtime-error/en/index.md): 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.
- [安全處理 Oysterun Host runtime 錯誤](https://oysterun.com/docs/recover-from-a-host-runtime-error/zh/index.md): 先保留 Explorer 的唯讀 runtime 錯誤，只使用一次可見的 Back；相同 Session chat 保留預期 history 且 composer 可用時，即判定已恢復。

## CLI and Skills / CLI 與 Skill

- [How to use the Oysterun CLI safely](https://oysterun.com/docs/use-the-oysterun-cli-safely/en/index.md): Find supported operations from CLI help, distinguish reads from ordinary and protected mutations, and use dry-run and confirmation boundaries correctly.
- [如何安全使用 Oysterun CLI](https://oysterun.com/docs/use-the-oysterun-cli-safely/zh/index.md): 從 CLI 說明找到受支援的操作，分辨唯讀查詢、一般變更與受保護變更，並正確使用 dry-run 與確認界線。
- [How to install and use an Oysterun Skill](https://oysterun.com/docs/install-and-use-a-skill/en/index.md): Find, install or update, verify, and safely use an eligible Oysterun Skill in a Claude or Codex Session.
- [如何安裝並使用 Oysterun Skill](https://oysterun.com/docs/install-and-use-a-skill/zh/index.md): 在 Claude 或 Codex Session 中找出、安裝或更新、驗證並安全使用符合條件的 Oysterun Skill。