docs/console-navigation.md
Caisey Console Navigation
The Caisey console is organized around the troubleshooting job: find the right device, start or resume a session, approve actions, then review or share the result.
Main areas
- Machines: device inventory, client grouping, install state, and setup commands.
- Chat: active and historical troubleshooting conversations.
- Shared links: public transcript snapshots you can copy, refresh, revoke, and label as passcode-protected or legacy unprotected.
- Permissions: default rules and machine-specific approvals.
- Audit log: workspace activity for review and support follow-up.
Where to find things
Machine list
On desktop, open Machines from the top navigation. On a phone, use Chat / Machines / More; open sessions and Plan from the chat header.
- Use search to filter by machine name or client name.
- Use client groups to narrow an MSP customer environment.
- Check status before opening a chat.
- Use Add machine when the endpoint is not enrolled yet.
Chat header
The chat header shows the active session title when you are in a chat. On a phone it is the thin bar above the transcript: sessions, title, machine (opens Machines), and Plan when a checklist exists. It may also include:
- connection status,
- fast mode controls,
- token allowance usage,
- share controls,
- feedback,
- and account controls.
Operational pages
On a phone, More holds Install, Links, Permissions, Audit log, Settings, Docs, Feedback, and account controls. On desktop, use the top navigation. Use these pages when you are not focused on one prompt:
- Audit log shows what happened across the workspace.
- Shared links shows what is currently public.
- Permissions controls what Caisey can do automatically.
Status meanings
- Pending: setup or verification is not complete. Chat is disabled.
- Ready: the endpoint can be selected for troubleshooting.
- Offline: Caisey knows the device, but it is not currently reachable.
- Removing: endpoint cleanup or control-plane deletion is in progress.
When in doubt, confirm the client group, machine name, and platform before starting work.