Oysterun
Menu
Back to Docs

Docs

How to tell whether an Oysterun agent is working or idle

Send one safe message from the Sessions page and distinguish available, occupied, working, terminal, and unknown states without duplicate work.

On this page Article start

Use this Docs guide to distinguish five states in one Oysterun Session: available, occupied, showing visible progress, terminal, and unknown. You will open a real Session, send one safe message, and choose the next action without accidentally sending the same work twice.

Before you start

  • Your Oysterun Host is connected.
  • Codex or Claude Code is installed and signed in on that Host.
  • You have at least one Session that you can open. If the Sessions page is empty, choose New Session, select Codex or Claude and a Start Folder, then choose Start Session.

Starting screen: open Oysterun and choose Sessions in the main navigation.

1. Open the Session chat

The same Session header and complete composer are visible in the latest conversation view.
Visible checkpoint: the same Session header and complete composer are visible in the latest conversation view, confirming that the Session is available.
Inspect full-size screenshot
  1. On the Sessions page, choose the Session you want to check.
  2. Wait for its chat page to open.
  3. Confirm that the message composer is visible at the bottom of the page.

2. Send one safe test message

  1. In the composer, enter: Without using tools, reading files, or changing anything, write five short bullet points about the kinds of software-project questions you can answer.
  2. Send the message once.
  3. Keep the same chat open while Oysterun accepts the message.

3. Recognize an occupied turn

The same Session shows one safe test request and the current Codex responding indicator in a complete desktop frame.
Visible checkpoint: the safe test request appears exactly once while the current provider responding indicator is visible in the same Session.
Inspect full-size screenshot

After Oysterun accepts the message, the current provider may appear below the conversation as Codex is typing…, Claude is typing…, or another provider-specific responding indicator. Read this as Oysterun's current-provider state, not as a generic chat participant's typing notice.

  • Indicator visible: the turn is occupied. It may be accepted, queued, starting, running a tool, awaiting control, or suspected stalled; the indicator alone does not distinguish those conditions. Do not send the same request again.
  • New assistant text or a current Tool result for this request appears while the turn remains occupied: the turn has produced visible progress. Continue following the original request.
  • Stop response is available: Oysterun currently offers a way to request interruption. Whether interruption is still accepted is separate from whether the turn is occupied or showing progress.

4. Handle a suspicious repeated start

A reconnect can make the same turn appear to start again. A repeated responding indicator or a page reconnect is not a reason to send the message again.

  1. Confirm that your original message is still visible in the chat.
  2. Do not resend it and do not open a second Session for the same request.
  3. Wait for one complete answer, explicit error, or stopped result.
  4. If the same request appears to produce two answers, or the visible state keeps returning to responding without a final result, open the original message's menu and choose Copy Debug Info.
  5. Send that information privately to the person who manages this Host. Do not post it publicly.

5. Confirm that the turn finished

The same Session shows the single original request and a complete five-item answer with no responding indicator.
Visible checkpoint: the original request remains singular, a complete answer is visible, and the provider responding indicator has cleared.
Inspect full-size screenshot
  1. Wait for a complete assistant answer, an explicit error, or a visible stopped/canceled result.
  2. Confirm that the responding indicator is no longer visible.
  3. Read the final result before deciding what to send next.

6. Recover when the state is unclear

If there is no current-provider responding indicator and no clear final result, or if the visible signals conflict, do not guess that the Session is idle.

  1. Use your browser's Reload control once.
  2. Read the latest message again.
  3. If the page still looks incomplete, return to Sessions and reopen the same Session once.
  4. If a final result appears, follow it. If the state is still unclear, do not repeat the request. Open the latest committed message's menu, choose Copy Debug Info, and send that information privately to the person who manages this Host. If that command is unavailable, preserve what you can see and contact the Host manager without resending.

Status reference

What you seeWhat it provesWhat to do
The Session opens and its composer is visibleAvailable: the chat can be inspected or used; provider activity and idleness are not provedRead the latest result before sending
Oysterun's current-provider responding indicator is visibleOccupied: the current turn is not idle; continuous or useful progress is not provedDo not repeat the request; wait, or use Stop response only if you intend to interrupt
New assistant text or a current Tool result for the same request appears while the turn remains occupiedVisible progress: this turn has produced a new result since it startedContinue following the original request unless you intend to stop it
A complete answer, explicit error, or stopped/canceled result is visible and the provider indicator has clearedTerminal: the turn ended, normally or otherwiseReview the result; send the next instruction after a normal answer, or correct the stated cause before one appropriate retry
No provider indicator and no clear final result, or the visible signals conflictUnknown: neither idle nor active work is provedReload once, reopen once, then preserve debug info instead of resending