helix-cli
Helix CLI 是 HelixDB v3 的命令行工具,用作运行时与控制平面客户端,用于驱动本地 Docker/Podman 实例,以及基于 WorkOS 会话认证的 Helix Cloud 发现与资源管理。它支持本地初始化、启动、查询、shell 和停止等工作流,也支持云端的登录、工作区/项目/数据库列表查看、项目链接与查询。需要注意的是,该 CLI 并不编译 .hx 文件、不部署查询包、不推送源码、也不同步网关元数据。本地使用 ghcr.io/helixdb/helixdb:v0.0.5 镜像,默认内存存储会在停止或重启后丢失数据,也可通过 --disk、--storage-uri 或 HELIX_DATA_DIR 配置持久化。云认证仅使用 helix auth login/status/logout,通过 WorkOS PKCE 流程,不使用 Cloud API key、旧版密钥或自定义授权头。数据查询读写需要独立的 database.query.read / database.query.write 权限,管理读写权限不等同于查询权限。密钥令牌仅在创建时打印一次,CLI 不存储也不使用。