Changelog

Read the changes for the package you are upgrading. Each package versions independently; Current versions lists the available packages.

CLI — @hlix/cli

1.3.1

• Include license notices for optional packages in npm installations.

1.3.0

• Import a local project and switch projects from the cloud terminal client.
• Keep follow-up chat messages queued while a project turn runs.
• Preserve enabled project MCP connections during import and keep hlix credentials out of imported configuration.

1.2.0–1.2.1

• Sign in through the browser with hlix login; commands that need authentication can start sign-in automatically.
• Record setup, verification, and development commands in hlix.yml during init and import.
• Detect linked Git worktrees and continue pushed work as cloud cycles.

1.1.0

• Store project configuration in hlix.yml and machine settings in ~/.hlix/hlix.yml.
• Keep machine-specific provider secrets in hlix.local.yml or the global file.

1.0.0–1.0.4

• Replace bundle-based import and revision sync with committed files in HLIX Repos. Review scripts that read the old revision/generation fields.
• Follow tasks through automated review retries with tasks watch; JSONL results carry state, task, and an optional reason.
• Import repository instruction files as source; credentials found in them remain protected.
• Track long-running commands and clean up owned processes on cancellation.

0.8.0

• hlix acp runs Hlix Code as an ACP agent over standard input and output, so tools that speak the Agent Client Protocol can drive it.

0.7.2

• The one-line installer installs the standalone CLI on macOS and Linux, including Linux ARM64, with checksum verification and in-place upgrades.
• npm installs a native executable on supported platforms and keeps the Node.js launcher as a fallback.
• The installer detects an existing Homebrew, npm or native installation before installing another copy. hlix uninstall removes a native installation.

0.7.1

• Homebrew installs Hlix as one self-contained executable.
• MCP servers connect in the background. A server that needs a sign-in or is offline is listed in /mcp, and /mcp retry tries again.
• A project’s own .env and bunfig.toml are never loaded by Hlix itself.

0.7.0

• Hlix Code delegates to other coding agents in plain words — “use Codex to fix this”, “split this across three agents” — running each helper in its own worktree and merging the results.
• A new terminal interface: one row per tool call, collapsed long output, live thinking, elapsed time and cost, and Ctrl+O for detail.
• ⇧Tab cycles the permission modes auto, ask, yolo and plan.
• .hlixignore keeps a managed block of the build output, caches and scratch folders your project generates.
• hlix projects delete <name|id>.

0.6.0

• hlix mirror keeps a bound folder live with its Cloud Machine: cloud changes come down, and local saves go up.
• hlix import connects a folder whose Git origin is a GitHub repository you can reach.

0.5.0 – 0.5.6

• Hlix Code became its own shell, with a live status line, per-call approvals, /model, /harness, /sandbox, /threads and /resume.
• Memory is kept per project.
• --sandbox cloud works inside the project’s repository, and cloud edits come back with hlix pull.
• hlix harness clear removes a coder preference.
• Faster status and pull on long histories, and fewer import blockers for placeholder values and example files.

0.4.0 – 0.4.5

• hlix secrets list, set, delete, import and export manage a project’s secrets from the terminal.
• Hlix Code reads the agent standards a project already has for other coding agents.
• hlix auth login lists your workspaces and asks which one to use.
• Cloud sessions use your Workspace’s models.

0.2.0

• Local-to-cloud import and revision sync, and the public SDK surface.

0.1.0

• Added interactive and environment-based authentication with explicit workspace selection.
• Added project discovery, dry-run trust review, encrypted protected-file transfer, complete Git-history import, and immutable cloud revisions.
• Added conflict-aware push, pull and sync, plus explicit skill, agent and MCP resource imports.
• Added stable JSON envelopes, documented exit codes, and packaged agent skill instructions.

TypeScript SDK — @hlix/sdk

2.2.0

• Add cloud project switching, queued chat delivery, provider account selection, and cycle attachments.

2.1.0–2.1.1

• Add requestDeviceCode and pollDeviceToken for browser-approved device sign-in.

2.0.0

• Add typed coder-account and funding endpoints.
• Allow HarnessPreference.harness to be null for inherited selection; update consumers to handle it.

1.0.0

• Remove the old imports and revisions methods. Use repos.access and repos.head for repository access; use the CLI for local file sync.
• Replace tasks.stream and cycles.stream with the live methods.
• Add project pause and resume. projects.stop returns status and interruptedCycles; projects.resume returns status, resumedCycles, and started.

0.3.0 — Project workflows

• projects.status reports where a project stands: its phase, task progress, what needs a person, the preview and delivery.
• projects.deliver opens, or finds, the project’s pull request into your default branch. It never merges.
• projects.stop and projects.preview.
• chat.send sends a message to a project and returns while its agent works; chat.turn reads the turn’s status and answer.
• pendingRequests.list and pendingRequests.resolve read and answer the questions a project is waiting on.
• cycles.propose also returns proposalId and the cycleId created from the proposal.

0.2.0

• Local-to-cloud import and revision sync, and the public SDK surface.

0.1.0

• Added workspace-scoped clients for projects, imports, revisions, tasks, cycles, reports, billing, agents and integrations.
• Added typed API errors, bounded retry for safe idempotent requests, and SSE task-status streaming.
• Added request and response types from the public API contract.

Python and Go SDKs

0.1.0

• Publish the async Python client as hlix-sdk on PyPI, imported as hlix.
• Publish the generated Go module as github.com/hlix-ai/hlix-go.

MCP server

0.4.0

• The MCP server is hosted at https://mcp.hlix.ai/mcp, and clients connect with that URL. A client entry that launches a local @hlix/mcp package no longer works; replace it with the URL.
• Scripts and CI connect with an API key: Authorization: Bearer <key> on the same URL.

0.2.0

• Workspace-bound MCP server with read-only tools by default and opt-in write tools.

0.1.0

• Project, task, cycle, comment and review tools, with structured errors.

Compatibility notes

These schemas define compatibility for integrations and CLI automation. They are versioned separately from packages.

• Import scan reports use manifest schema version 2.
• Project configuration and local synchronization state have their own schema versions.
• CLI JSON output uses envelope schema version 1.
• The public API contract is OpenAPI 3.1 with independent semantic versioning — see Versions & releases.

Before upgrading

1. Read the entries above for the package you are upgrading.
2. Run hlix --version and record the current version.
3. Commit or back up local project work.
4. Run hlix sync and resolve any divergence before replacing the binary.
5. After upgrading, verify hlix --help, hlix projects list, and one dry-run import.

If an upgrade goes wrong

• hlix --version still prints the old version — an older binary is earlier on PATH. Check which -a hlix.
• hlix sync reports a conflict after upgrading — resolve the divergence, not the version. Run hlix sync --dry-run for the file counts on each side.
• A --json consumer breaks — check schemaVersion first. The envelope version is the contract; human formatting is not, and may change between releases.
• A flag disappeared — compare the installed version’s --help output with the relevant release entry before changing your scripts.
• An MCP write tool is missing — check whether the connection was signed in read-only. See Connect your AI.

Next steps

Current versions

The version each hlix package installs today, and how to install it.

Versions & releases

How each surface is versioned, and what a version change means.

CLI reference

Command options, output formats and error codes.

Troubleshooting

Symptom-first recovery when a command behaves differently after an upgrade.