helixor 0.3.0

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

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.

In trial mode, helixor index uploads a bounded source snapshot and the protected Helixor cloud builds and queries the index cache. The public wheel keeps only credentials, receipts, setup metadata, and diagnostics.

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. Enterprise local is the premium path for private-source teams that need the fastest loop: the licensed companion builds and queries local indexes while the cloud records license acceptance, companion registration, shared workspace state, token ledgers, and team coordination.

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.