Solix FAQ
How Solix works with Claude Code, what happens across an agent's lifecycle from spawn to approval, and why Solix stays 100% local with zero telemetry.
Claude Code setup
How Solix finds your running Claude Code sessions and what you need to install first.
Do I need Claude Code to try Solix?
No.
solix demo seeds a fake galaxy with planets, comet streaks, and a pending permission so you can explore the UI without Claude Code installed. You only need Claude Code to watch your real agents.What versions of Claude Code does Solix support?
Solix works with any recent Claude Code release. It syncs through Claude Code's Agent View / background-session bridge, so there is no extra config — start a session and a planet appears.
How do I wire Claude Code hooks?
Run the one-time installer and it patches your Claude Code hooks for you:After that, start the dashboard and open a Claude Code session:
terminal
$
solix installterminal
$
solix startterminal
$
claudeWhy isn't my Claude Code session showing up as a planet?
Run
solix doctor — it checks that the hooks are wired, the port (127.0.0.1:4242) is free, and Node is ≥ 20. The most common fix is re-running solix install after a Claude Code update overwrote the hooks.Can I watch multiple Claude Code sessions at once?
Yes — that is the whole point. Each running session becomes its own planet orbiting the sun (you). Run three
claude sessions in different terminals and you will see three planets, each with its own model color and context size.The agent lifecycle
From the moment a session starts to the moment it asks for your yes/no — here is what each planet is doing.
What does a planet represent?
One running Claude Code session. Its color shows the model (opus purple, sonnet blue, haiku cyan) and its size reflects how much context it has consumed.
What is a moon?
A subagent spawned by Claude Code's Task tool. Moons orbit their parent planet, so you can see when a session has delegated work and how busy each subagent is.
Why does a planet turn red and pulse?
It is awaiting your permission for a sensitive action. A red flare means the agent has paused and needs a yes/no. Press Y or N right from the browser — no alt-tabbing back to the terminal.
What are the comet streaks?
Each comet is a tool call firing in real time — a read, a write, a search. Streaks let you feel the tempo of an agent without reading its log.
What is a budget ring?
Every planet wears a ring showing live USD spend estimated from token usage, shifting sky → amber → red as it approaches a per-task cap you set. Overspend triggers an alert so a runaway agent never silently burns budget.
What happens when a session ends?
The planet stops orbiting and fades, but it is not gone — the Timeline lets you scrub back through everything that agent did. You can replay tool calls, approvals, and cost over the session's whole life.
What are heartbeats?
Scheduled recurring tasks (every 30m / 2h / 1d). They appear as pulsing nodes so recurring work — like a nightly security scan from Sentinel — has its own visible rhythm in the galaxy.
The privacy promise
Solix runs entirely on your machine. Here is exactly what that means.
Does Solix send my code anywhere?
No. Solix runs entirely on
127.0.0.1. Your code, prompts, and file contents never leave your machine — the dashboard only reads local state from Claude Code's session files.Does Solix collect telemetry or analytics?
Zero. There is no phone-home, no usage tracking, no account, and no cloud sync. That is also why a “live agents online” counter would be impossible — Solix has no way to know what other machines are doing, and that is the point.
What about API keys and tokens?
Solix never touches your Anthropic API key. Authentication to the model happens inside Claude Code itself; Solix only observes the session state that Claude Code already writes locally.
Is the dashboard exposed to the network?
No. It binds to
127.0.0.1:4242 only — localhost, not 0.0.0.0. Nothing on your LAN or the internet can reach it unless you explicitly tunnel it yourself.Is it really open source?
Yes — MIT licensed, source on GitHub. You can audit every line before you run it, and the hooks that
solix install writes are plain text you can read and revert.Still have a question? Open an issue or start a discussion on GitHub.