Helixor Code Documentation
Welcome to the documentation suite for Helixor Code. This portal covers local runtime setup, the command-line interface, AST code indexing across 12 languages, the companion-served Local Desk, the menu-bar tray appliance, and AI coding agent integrations over MCP.
Product Model & Architecture
Helixor Code is designed around a single local companion HTTP process and several user-facing work surfaces:
- The CLI: Installs, repairs, configures, and reconciles the local runtime, indexes code, and diagnoses health.
- The Companion: Listens on
http://127.0.0.1:18733in production and exposes MCP JSON-RPC athttp://127.0.0.1:18733/mcp/. - The Code Index: Stores local structural code artifacts on disk, typically under
~/.helixor/code_index. - The Tray: A compact menu-bar appliance providing companion health and desktop shortcuts.
- The Local Desk: A full local web surface at
http://127.0.0.1:18733/deskfor TODO stacks, design records, index status, settings, and logs. - Agent Integrations: Connects AI coding agents (Claude Code, Codex, Cursor, Grok, Antigravity, Qwen) to the companion through MCP and installs managed operating guidance.
The supported agent endpoint is the local companion at http://127.0.0.1:18733/mcp/. Code and indexes remain strictly on the local machine; only shared engineering memory (TODO stacks and designs) is synchronized across team members.
Documentation Guides
Install with pipx, run helixor init, manage lifecycle with up / down, run diagnostics with doctor, and build indexes.
Repository and workspace indexing, lazy versus eager build strategies, commit-aware freshness, and MCP code intelligence tools.
Work Surface Local Desk (/desk)
The companion-served web desk at :18733/desk: TODO stacks, design documents, index inspector, settings, and feature-gated planes.
The macOS status appliance for companion health, idle/busy indicators, quick desk launching, and troubleshooting.
Integrations Agent Additions & MCPConfigure Claude Code, Codex, Cursor, Grok, Antigravity, and generic MCP clients to communicate with the local companion, plus managed guidance blocks.