Skip to content
PawOS Docs

Companion

The real-time 3D character rendered on your desktop.

The companion is a live, real-time 3D character that reflects PawOS’s mood and speaks with lip-synced animation while it talks.

It is the authoritative interface — a legacy 2D companion stack exists in the codebase but is not the active one.

How it works

What you see

  • A desktop companion you talk to by voice or text, with optional spoken replies, personality and appearance settings, and live task progress.
  • You can customise personality, voice and appearance, including uploading your own compatible 3D model.

What PawOS does

  • Requests you make to the companion go through the same task and permission flow as typed ones.
  • Your speech is shown as text so you can review it before sending; spoken replies read summaries, not raw logs.

Permissions

  • The companion follows the same permissions as everything else — it cannot skip an approval.
  • Appearance and personality never change billing, connections, files, commands or security.

Records

  • Tasks started through the companion leave the same Work Records as typed tasks.

Good to know

  • Push-to-talk with review-before-send is the input model.