Stellaris Companion turns a changing Stellaris campaign into context that humans can inspect and AI agents can reason over. This manual explains the system from the first save import to advisor briefings, Chronicle stories, and local MCP connections.
Start in four steps
- Install Stellaris Companion: download the desktop app for macOS, Windows, or Linux.
- Choose an AI provider: use Gemini, a local model, OpenRouter, or a compatible endpoint.
- Connect your first save: let the Companion discover a campaign or import a
.savfile. - Ask your first question: use the Advisor or connect an AI app once your campaign is ready.
Completing those four steps is enough to get a campaign-grounded answer. Everything else in the manual is optional depth.
Other routes
- Connecting an AI app? See the AI app connection guide.
- Trying to understand the architecture? Read how Stellaris Companion works.
- Solving an in-game problem? Browse the strategy guides.
One platform, two reading modes
Every manual page has an HTML version for people and a clean Markdown twin for agents. Agents can discover the complete corpus through /llms.txt or fetch a single page through its Read as Markdown link.
What the Companion does
- Watches or imports local Stellaris saves.
- Parses campaign state into a local historical archive.
- Produces focused, perspective-aware briefings.
- Sends extracted context to the AI provider you choose for Advisor and Chronicle.
- Lets supported AI clients request briefings through a separate local MCP bridge.
- Helps you turn campaign events into a readable Chronicle.
Raw save files remain on your computer. See privacy and data flow for the exact boundary.