Configuration

Environment Variables

You don't need any environment variables to start using Parallax. Just sign into Gemini CLI and Parallax will automatically use your Google plan for inference (through @google/gemini-cli-core).

Contextual Config: PARALLAX.md

Parallax learns the rules of your repository by automatically reading PARALLAX.md from the root directory during boot. Instead of typing "always use strict TypeScript and avoid Tailwind" in your prompt every single session, you write it down once in PARALLAX.md.

You should document:

• Banned libraries or specific dependencies to favor
• Formatting lint rules
• High-level architectural flows (e.g. "We route standard React pages through /app but handle API calls in /server")

Don't want to type it from scratch? When inside a Parallax session, run /init. The agent runs a quick scan of the immediate workspace, builds a mental model of your tech stack, and writes a fully structured PARALLAX.md file designed specifically for other LLMs to read.

Local Storage

All data stays on your machine. Sessions write immediately to a central directory:

~/.parallax/
├── b89ef3c1.json
├── 1a9f39aa.json
└── ...

There are no databases. If you want to wipe your history, just rm -rf ~/.parallax. Each JSON payload includes the entire model context, timestamp references, the active model selected, and the auto-generated session title.