graqle v0.53.1 — Codex MCP Installer

graqle v0.53.1 — Codex MCP Installer

One command installs GraQle into Codex. Plus a full Neo4j import pipeline and a fix for the invisible permission dialog stalling VS Code sessions.

Install / Upgrade

pip install "graqle==0.53.1"

---

New: Codex One-Command Setup

graq mcp install codex
graq mcp doctor codex

graq mcp install codex auto-detects Codex CLI, resolves absolute graqle.yaml path (relative paths silently fail in global MCP entries), and runs codex mcp add graqle -- graq mcp serve --config <abs_path>. Supports --mode read-only for safe parallel Claude + Codex sessions. Env vars preserved with JSON-safe serialization.

graq mcp doctor codex runs an 8-point health checklist: Codex on PATH → version → graqle listed → graq binary → yaml exists → env JSON valid → server importable → serve responds.

New: MCP Management Commands

Command	What it does
graq mcp tools [--json]	Lists all 80+ MCP tools; queries live server or falls back to static registry
graq mcp sessions	Running MCP server PIDs + versions
graq mcp locks	KG write locks currently held

New: Neo4j Full Import

graq neo4j-import               # full KG → Neo4j with embeddings
graq neo4j-import --dry-run     # preview without writing

Bulk-transfers the KG in configurable batches: nodes with 1024-dim embeddings, edges, uniqueness constraint, cosine vector index. Validates counts and runs a live vector search after import.

Required env vars: NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD, NEO4J_DATABASE.

Fixed: VS Code Permission Dialog

The governance gate template now ships with permissions.allow pre-populated for all graq_* / kogni_* MCP tools. Previously Claude Code would silently wait for a permission dialog that never rendered in the VS Code extension, causing sessions to appear stuck.

Existing gate installations: run graq gate-install --force once to apply.

---

Full changelog: https://github.com/quantamixsol/graqle/blob/master/CHANGELOG.md