Ravensight

Desktop pets with their own studio chat

Huginn and Muninn stay quietly on your desktop. Click a raven to open Raven’s chat and ask the same Huginn analyst you use in the dashboard, drawing on your studio’s data and memory. Questions use your studio’s shared AI allowance and prepaid balance. Get the installers from the Raven download page.

Raven and Skill Activity are separate apps with independent settings, credentials and lifecycles. Raven keeps its pets and chat; Skill Activity follows local agent work. Install either or both.

Install the beta

  1. Download the installer for your platform.
  2. On Apple Silicon macOS, open the ZIP and drag Ravensight to Applications, then open the app.
  3. On Windows 10 or 11, 64-bit x64, run the setup EXE.
  4. Check the file against the published SHA-256 checksums before you open it.

Windows 0.2.3 is not publisher signed, so operating-system or organization policy may block it. Keep your security protections enabled. Broader machine compatibility checks remain in progress for the Mac release candidate.

Connect

The desktop app offers three ways to reach your studio. It keeps whichever credential you use in your operating system's credential store.

MethodCredentialWho answersWhat it uses
Sign inDevice approval in the dashboardThe hosted analystYour studio's AI allowance, then prepaid balance
Analyst API keygt_raven_...The hosted analystYour studio's AI allowance, then prepaid balance
Your own model keyProvider API key and gt_mcp_...A model you call from your own machineYour provider's charges, plus metered MCP reads
  1. Sign in: choose Connect Ravensight. Your browser opens a device approval page. Sign in, check that the code matches the one the app shows, choose which games the desktop app may ask about, and approve. An unapproved code expires after ten minutes.
  2. Analyst API key: create a key under Settings > Desktop and paste the gt_raven_ key into the app. The dashboard shows the key once. It uses the same hosted analyst and billing as signing in.
  3. Your own model key: enter an Anthropic API key, a model ID your key can use, and a Ravensight MCP key from Settings > MCP access (see Analytics MCP). Both keys stay on your device. Your question, and the studio data the desktop app reads to answer it, go from your machine to Anthropic under your own account. The read-only loop is bounded to six model calls and twelve MCP calls per question.

The own-key option is the one place Ravensight works with a key you hold, and it exists only in this desktop client. Ravensight never receives or stores your provider key; the hosted analyst and every other feature run on Ravensight's own platform key, as described in Usage, billing and limits.

Usage and access

  • Downloading the client is free and does not include free or unmetered AI.
  • A hosted question, by sign-in or analyst API key, is billed like a dashboard question: one shared AI unit, drawn from the studio's included monthly allowance first and then its prepaid balance, on the studio owner's account.
  • With your own model key, your provider bills you for the model calls, and each Ravensight MCP read is weighted as 100,000 events on the studio's shared event meter. MCP needs an account that has funded a prepaid balance at least once, and your MCP token's own budget still applies.
  • Asking needs a role that can ask the analyst, member or above. Desktop app credentials can ask questions and read your own conversation history; they cannot edit studio memory or delete conversations.
  • Desktop app tokens and keys can be revoked and expire after 90 days. Every call rechecks your membership and role, so a removed member or revoked credential stops working at once.
  • A game allowlist restricts which games the desktop app can ask about. Shared studio memory may still inform an answer, so the allowlist is not a data boundary inside one studio.

Controls and activity

The ravens rest, blink independently and occasionally glance around. Click either bird, or Expand, to open or close chat; the birds work from the keyboard too. Drag either bird to reposition the widget. The toolbar opens chat, activity and settings. Activity shows the real progress of a request, its answer and any error. Settings shows one or both ravens, pauses animation and checks for updates by hand. The desktop app respects your system's reduced motion setting. Voice and autonomous desktop control are not included.

Recover an interrupted question

The desktop app saves a hosted question's request ID before sending it. If the app closes mid-answer, use Recover same request after a restart. Recovery replays the answer the server already produced and cannot start another paid operation; a request the server has not finished is refused rather than run twice. Saved answers expire after seven days and are removed when their conversation or game is deleted. Once one is gone, recovery is unavailable and does not charge you again.

Dismiss recovery only when you choose to move on: a new question is a separate billed operation. Questions asked with your own model key are never retried automatically.

Updates and revocation

Settings, Check for updates reads the official release manifest. Install updates from the download page; this beta never installs updates silently. Disconnect removes the local connection. Revoke a lost or unused device or key on the Desktop tab in Settings, and never share your API keys.

Troubleshooting

A 401 usually means you need to reconnect or create a new key. Permission or balance errors mean checking your studio role and your usage settings. Keep the API and dashboard addresses at their defaults unless you are deliberately connecting to your own development environment.