PARALLAX ENGINE

The first AI coding assistant that shows its work.

Quick Install

npx parallax-opencode

After install, restart OpenCode and press Tab to cycle to the Parallax agent.

What Makes Parallax Different

Every AI coding tool gives you code. None of them show you how they got there.

Parallax captures the complete reasoning trace of every session -- the ambiguity assessment, the invariants analysis, every verification result, every decision -- and makes it visible, exportable, and replayable.

"Here is my complete reasoning trace. Review it. Score it. Compare it. See for yourself."

The 4 Invariants

Based on @acidgreenservers AGENTS.md

The Coherence Score

After every session, Parallax computes an evidence-based quality score (0-100):

• Protocol Coverage (30%) -- Were all 6 protocol phases completed?
• Verification Integrity (35%) -- Pass rate on first attempt?
• Edge Case Coverage (20%) -- How many edge categories were analyzed?
• Timing Discipline (15%) -- Were phases in correct order?

Track scores over time:

parallax trace trend
parallax trace report --week

Trace in Your PR

The AI calls parallax_trace_pr_comment at session end and outputs a formatted markdown block directly in the chat. Copy it into your PR. No terminal needed.

CI/CD Gate

- name: Parallax Gate
  run: parallax gate --min-score 70

Pre-commit hook:

echo 'parallax pre-commit' >> .git/hooks/pre-commit

Comparison

Architecture

Parallax Agent (system prompt)
  |
  +-- Plugin hooks (8)
  |     event                       --> session ID + agent switches
  |     tool.execute.before         --> protocol enforcement + friction + design doc gate
  |     tool.execute.after          --> auto-verify + trace recording + state persistence
  |     experimental.chat.system.transform --> protocol status + mode skill + agent context
  |     experimental.session.compacting     --> state preservation + trace export
  |     shell.env                   --> PARALLAX_MODE, PARALLAX_SESSION_ID in shell
  |
  +-- Custom tools (9)
  |     parallax_verify             auto-verify after writes
  |     parallax_analyze            multi-perspective analysis
  |     parallax_checkin            protocol step checkin (6 steps incl. design)
  |     parallax_plan / _build / _debug   mode switching
  |     parallax_trace_export       export session trace to JSON file
  |     parallax_trace_pr_comment   generate trace as PR-ready markdown
  |     parallax_trace_view         show full reasoning trace inline in chat
  |
  +-- State files (at ~/.parallax/ in user home)
  |     state.json                  written on every transition (immediate on checkins)
  |     traces/                     per-session JSON trace files
  |     scores.jsonl                append-only score history
  |     config.json                 per-project config (optional)
  |
  |   Note: Plugin process cwd is the user home directory (~), so all
  |   state persists at ~/.parallax/. The project .parallax/ dir is
  |   used by the CLI only.
  |
  +-- CLI (parallax) -- 11 commands
        init | trace list/show/score/export/trend/report/compare/compliance
        gate --min-score <n> | pre-commit

Three Modes

Six Protocol Steps

Project Config (.parallax/config.json)

{
  "strictness": "standard",
  "minScore": 70,
  "adaptiveProtocol": false,
  "designDocRequired": false,
  "trivialPatterns": ["*.md", "*.json"],
  "highRiskPatterns": ["**/auth/**", "**/*.env*"]
}

Manual Install

cp dist-standalone/parallax-engine.js ~/.config/opencode/plugins/
cp agents/parallax.md ~/.config/opencode/agents/
cp -r skills/parallax       ~/.config/opencode/skills/
cp -r skills/parallax-plan  ~/.config/opencode/skills/
cp -r skills/parallax-debug ~/.config/opencode/skills/
cd ~/.config/opencode && npm init -y && npm install @opencode-ai/plugin

Project Status

v0.3.9 -- Cross-context protocol enforcement + full plugin integration

See ROADMAP.md for the full strategic plan.

Commands

Plugin Tools (AI calls in OpenCode chat)

parallax_verify                 Run project verification
parallax_analyze {topic}        Multi-perspective analysis
parallax_checkin {step}         Protocol step (ambiguity/invariants/gate/design/commit/summary)
parallax_plan / _build / _debug Mode switching
parallax_trace_export           Export session trace to JSON
parallax_trace_pr_comment       Generate trace as PR-ready markdown
parallax_trace_view             Show reasoning trace inline in chat

CLI (for CI and analytics)

parallax init                    Create .parallax/ directory
parallax trace list              List all traces
parallax trace show <id>         Show trace details
parallax trace score <id>        Show coherence score breakdown
parallax trace export <id>       Export trace as pretty JSON
parallax trace trend             Show score trend over time
parallax trace report --week     Weekly analytics report
parallax trace compare <a> <b>   Side-by-side trace comparison
parallax trace compliance <id>   Protocol compliance report
parallax gate --min-score <n>    CI coherence gate
parallax pre-commit              Git pre-commit hook wrapper

Files

parallax_plugin/
  agents/parallax.md            # Primary agent definition
  src/plugin.ts                 # Canonical plugin (TypeScript, 1000+ lines)
  src/types.ts                  # Shared type definitions
  src/detect.ts                 # Project detection
  src/trace.ts                  # Trace recording and export
  src/score.ts                  # Coherence score + analytics
  src/cli.ts                    # CLI entry point (11 commands)
  src/tests/                    # 30 tests across 5 files
  dist/                         # Compiled output
  dist-standalone/              # Standalone bundled plugin (34KB)
  skills/                       # Protocol skills
  scripts/                      # Install and publish scripts
  .parallax/                    # Runtime state + traces + scores
  ROADMAP.md                    # Strategic roadmap
  CHANGELOG.md                  # Version history

License

MIT (c) @Master0fFate