Skip to content
Beta

FAQ

Short answers to the questions we hear most. If yours isn't here, write to support@spandock.com.

Does SpanDock need Docker?

No. SpanDock is a single app with an embedded database. There is nothing else to install or run.

Which operating systems are supported?

macOS (Apple Silicon and Intel), Linux (x86-64 and ARM64) and Windows (x86-64). On macOS and Linux you can install with Homebrew. See Getting started.

Which AI tools work with it?

SpanDock configures Claude Code, Codex, Gemini CLI, Qwen Code, GitHub Copilot Chat (VS Code), Goose, Mistral Vibe and Cursor for you. For OpenCode, Kilo Code, GitHub Copilot CLI, Cline, Continue CLI and Factory Droid, it shows the exact lines to add. Any other tool that exports OTLP/HTTP can send to http://127.0.0.1:4318.

How does SpanDock see Cursor?

Cursor exports telemetry only from its own cloud, so SpanDock uses Cursor's agent hooks instead (coming in the next version). Configure on the Integrations page adds SpanDock's hook to ~/.cursor/hooks.json, keeping your own hooks. Turns, tool calls, shell commands, MCP calls, file edits and lines of code then show in Activity, and guardrails check prompts, commands and file reads before they run. Cursor's hooks carry no token counts or cost, so SpanDock shows them only when Cursor's transcript has them. Cursor's cloud agents run only a repository's own hooks, so they aren't covered.

Why can't Kiro send to SpanDock?

Kiro exports telemetry only from its own cloud, not from your machine, so there is nothing local for SpanDock to receive.

We use LiteLLM. Can we move?

Yes: see Move from LiteLLM. The importer turns LiteLLM's config.yaml, keys, teams and users into SpanDock settings, and shows every change before it applies anything. We can also do the migration with you.

Do my code or prompts leave my machine?

Not to us. Telemetry stays on your machines and goes only to the destinations you add. The tool profiles SpanDock sets up keep prompt and tool contents redacted. The SpanDock website receives only license checks, with counts and version details, never telemetry, prompts or code. See Privacy and security.

Do I need an account?

Every server signs in to https://spandock.com once to activate; signing up is free and creates a Personal license. A server's first activation starts a 30-day trial of the paid features, then it continues on its plan. Clients need no account. The tunnel between clients and servers needs no account and no open ports.

What counts as an active client?

A client that reported to your server that day. The Usage tier is billed on the day's highest count of active clients, and of servers plus satellites. See Licensing and activation.

What happens if my license lapses?

If the site can't be reached, SpanDock keeps working on the last license it received for a grace period, 14 days by default. If the license expires or is revoked, features are limited to the Personal tier until you renew it or paste a current key. Your data stays on your machines either way.

Can I use SpanDock offline?

Yes. Clients queue telemetry on disk while the server is unreachable and send it when the connection returns. The hub needs to reach https://spandock.com for its license check at least once within the grace period. Fully air-gapped installs can use an offline license, which is an Enterprise feature.

How do updates work?

SpanDock checks for a new release every 6 hours, or when you choose Settings → Check now. Install it from the banner or Settings → Updates, or turn on automatic updates. The download is verified against its SHA-256 before it is installed, and if the new version doesn't start, the previous one is restored. You can also pin a version. Clients reconnect to an updated server by themselves.

If you installed the command-line binary with Homebrew, update it with brew upgrade spandock instead; it never replaces itself.

How do I change a computer's mode?

Choose Settings → Mode → Change to …. This deletes that computer's setup for its current mode (data, settings, pairing and secrets), restarts SpanDock, and asks for the mode again. See Modes.

What happens if my server goes down?

Clients keep queueing telemetry on disk and send it when the server returns. With satellites, clients fail over to another server automatically. See Satellites and failover.

Can I control what AI tools may do with our systems?

Yes. On Premium and Enterprise, the MCP gateway gives every computer's AI tools your organisation's MCP connectors, read-only by default, with approval before destructive tools and permissions per person and group. On Enterprise, guardrails on computers block, warn or ask before secrets, personal data or your own patterns go into a prompt or tool call.

Can I share our own skills with the team?

Yes. The starter skills are in every plan. Publishing your own skills to every computer is on Premium and Enterprise, and is in beta. See Skills.

Can SpanDock tell me when something needs attention?

Yes, in every plan. Connect your server under Settings → Notifications, and its notifications (a computer waiting for approval, a satellite offline, a disk nearly full, an update) appear on your spandock.com dashboard. See Notifications.

Can I see which AI tools people run?

The AI tools that send telemetry show up on the dashboard on every plan. On Enterprise, process inventory also lists the AI tools running on each computer, including the ones that send nothing, without reading command lines or environment variables.

How do I contact support?

Email support@spandock.com. For pricing, Enterprise plans or offline licenses, write to sales@spandock.com.

Cookie categories

Details: Cookie Policy.