v0.63.0 CLI · SDK 17 Jul 2026

First early-access release

The first early-access release of the Helix CLI and SDK: scaffold a project, run it locally, deploy it with one command, and build with an AI assistant.

npm install @trayai/helix-cli@0.63.0 @trayai/helix-sdk@0.63.0

View as Markdown

What matters in this release

Added

Scaffold, run, and deploy a project from the CLI

helix init writes a complete project: helix.config.ts, functions/ with a sample route, package.json and tsconfig.json, and MCP registration for Claude Code and Cursor. helix dev runs it locally with file-system routing (functions/{path}.{method}.ts), hot reload, live config reload, and an optional same-port frontend. helix deploy uploads the source, provisions the project on first run, records the new projectId, and returns a deployment ID you can inspect with helix deployment get <id>.

Read the docs →

Added

An AI context layer in every scaffolded project

helix init writes CLAUDE.md, five domain skills covering auth, context, debug, frontend, and functions, and Claude Code session hooks, so an assistant generates correct Helix code without being taught the platform first. helix mcp runs an MCP server that lets an assistant inspect the project, create functions, discover and wire workspace authentications, edit config, test endpoints, and check deployment status.

Read the docs →

Added

Credentials by alias, never in your code

ctx.http.authed(alias) calls a third-party API by credential alias and the platform supplies the secret, so the same code runs locally and when deployed and no key is ever committed. Upstream non-2xx comes back as a value rather than a thrown error. Plain ctx.http handles unauthenticated calls.

Read the docs →

Everything else that changed

Added

defineFunction, the core handler primitiveMerges and validates input from query, body, and path params, validates output, and maps return values to HTTP responses: null or undefined to 204, a Response passes through, anything else is validated and sent as JSON. Thrown errors map to statuses. Docs →
getContext() reaches the active context without prop drilling Docs →
Key-value store: getItem, setItem, removeItem, hasItem Docs →
Structured logging with ctx.log.info, warn, error, and debughelix dev prints human-readable logs locally by default. Docs →
ctx.identity exposes the requesting user id where available Docs →
Login, logout, and helix whoamiSign in by reading your Chrome session or pasting a token. It is validated before it is saved and never printed. Docs →
Auth aliases: helix auth connect, auth add, and auth listhelix auth connect [service] discovers workspace authentications interactively. Docs →
Workspace and project config from the CLIhelix workspace set, helix workspace select, and helix project set write the values into helix.config.ts. Docs →
Typed config loading with defineConfig and loadConfig()loadConfig() returns a typed discriminated union covering the provisioned and unprovisioned cases, with requireWorkspaceId() and a coded WorkspaceIdRequiredError, plus createConfigService() with hot reload for long-lived processes. Docs →
A testing entry point at @trayai/helix-sdk/testingrunWithContext unit-tests handlers and shared helpers with a mock context that throws on unset fields. Docs →

Maintenance and internal changes (1)

Update notices when a newer CLI is published

All releases