Skip to main content

Lightweight Helixor CLI for hub login, cloud-trial indexing, companion registration, and MCP endpoint configuration.

Project description

helixor

Durable code memory and verified understanding for AI coding agents.

pipx install helixor            # after PyPI publication
helixor up                      # starts companion-lite + tray
helixor index ~/code/my-repo
helixor mcp-config --transport http
helixor claude install          # opens the Claude Desktop extension installer

Claude Desktop users can install the richer one-click MCP Bundle directly from the CLI:

helixor claude install

For maintainers building the bundle from a checkout:

cd helixor-cli/claude-extension
node scripts/pack.mjs

For the current wheel-bundle release channel:

python3 -m pip install --find-links helixor-wheelhouse helixor

The public CLI is the cloud-trial runtime. It does not bundle private Helixor Code backend or helix-core packages. helixor up starts a lightweight local companion at http://127.0.0.1:18733 plus the tray app. The companion scans the local index store, reports token/value ledgers, exposes tray health, and delegates proprietary build/query execution to the configured Helixor cloud RPC API.

Enterprise local execution is a swap at the companion/provider boundary. The public CLI may start an installed enterprise companion with:

helixor up --companion-provider enterprise-local

but the enterprise package owns any local Jewel/Helix execution dependencies.

Build and verify the bundle from the monorepo:

PYTHON=python3.12 scripts/package-helixor.sh --smoke

Start with:

  • docs/quickstart-cursor.md for Cursor MCP setup.
  • docs/quickstart-collab.md for team hub or direct collaboration mode.

Project details


Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page