SuperPenguin Docs
Company Setup

Install SuperPenguin Desktop

Email the Mac app to engineers, sign in, and begin syncing AI coding activity.

SuperPenguin Desktop connects an engineer's local AI coding activity to SuperPenguin. It supports Cursor, Claude Code, and Codex activity on macOS.

Send the app to engineers

A workspace owner can email the app from the Onboard your team step on AI Coding or PR Costs:

  1. Review the Invited, Accepted, and App connected counts.
  2. Select Send app to email every accepted teammate who has not connected Desktop.

The complete roster and individual send actions remain available in Settings:

  1. Open Settings.
  2. Select AI Coding.
  3. Find Desktop reporting.
  4. Review the installed and not-installed members.
  5. Send to one engineer, or select Send to all not installed.

SuperPenguin skips members who already have an active Desktop installation. Sending the app is a separate action from inviting someone to the workspace, so the engineer should accept the workspace invitation first.

Install and sign in

Each engineer:

  1. Opens the installation email or the AI Coding setup page.
  2. Downloads the Apple Silicon or Intel DMG for their Mac.
  3. Opens the DMG and drags SuperPenguin Desktop to Applications.
  4. Opens SuperPenguin Desktop.
  5. Selects Sign in and completes approval in the browser.
  6. Chooses the correct company workspace if prompted.

SuperPenguin Desktop requires macOS 12 or later. After the first sign-in, supported AI coding activity uploads in the background. No skill file or manual collector command is required.

What engineers and owners see

  • An ordinary member sees their own AI Coding information.
  • A workspace owner sees organization-wide aggregate information.
  • A member with Viewer or Policy administrator access also sees organization-wide AI Coding information.

The team installation roster appears in Settings → AI Coding → Desktop reporting. Personal live agent spend is available across plans, while team dashboard seats and PR Cost Attribution depend on the workspace plan.

For the organization AI Coding onboarding flow, use Pro or an Enterprise workspace with the entitlement enabled. Cursor, Anthropic, and OpenAI billing connections are not required for Claude Code or Codex Desktop reporting.

See Set up AI Coding and PR Costs, Plans and entitlements, and Workspace roles and AI Coding visibility.

Next step

For repository and pull-request attribution, connect GitHub.