# hlix

> The AI OS for agencies — the control plane that orchestrates Claude Code, Codex, and Aider into one reviewed, parallel delivery pipeline. hlix doesn't replace your coding agents; it makes them work as a coordinated team.

## Docs

- [This path left the work tree](https://docs.hlix.ai/404.md): The requested hlix documentation page does not exist.
- [API & OpenAPI](https://docs.hlix.ai/api/openapi.md): Use hlix's OpenAPI 3.1 contract directly or generate a client with open-source tooling.
- [API reference](https://docs.hlix.ai/api/reference.md): Every operation in the published hlix API contract, grouped by resource and generated from the contract itself.
- [Client billing profile](https://docs.hlix.ai/api/reference/client-billing-profile.md): The client billing profile operations in the hlix API contract.
- [Client invoices](https://docs.hlix.ai/api/reference/client-invoices.md): The client invoices operations in the hlix API contract.
- [Cycles](https://docs.hlix.ai/api/reference/cycles.md): Multi-task units of work and their conversations.
- [Imports](https://docs.hlix.ai/api/reference/imports.md): Secure project snapshot upload, verification and finalization.
- [Projects](https://docs.hlix.ai/api/reference/projects.md): Projects, their repositories, roadmap, artifacts and Coding Workspace.
- [Reports](https://docs.hlix.ai/api/reference/reports.md): Agency portfolio health and client-safe reporting views.
- [Revisions](https://docs.hlix.ai/api/reference/revisions.md): The revisions operations in the hlix API contract.
- [Tasks](https://docs.hlix.ai/api/reference/tasks.md): Standalone tasks and their review evidence.
- [Environment discovery](https://docs.hlix.ai/cli/environment-discovery.md): How hlix reconstructs a local development environment, collects protected configuration, and produces a reviewable cloud setup plan.
- [Import a project](https://docs.hlix.ai/cli/import.md): Scan a local repository, protect its secrets and configuration, upload its history, and create a cloud project.
- [Initialize a project](https://docs.hlix.ai/cli/init.md): Bind a local folder to the authenticated hlix workspace and create safe, reviewable project configuration.
- [Import skills, agents & MCP servers](https://docs.hlix.ai/cli/resources.md): Explicitly activate project resources that the main import preserves but deliberately does not execute.
- [Push, pull & sync](https://docs.hlix.ai/cli/sync.md): Reconcile a local project with its immutable cloud revision head without silently guessing through conflicts.
- [Agents & orchestration](https://docs.hlix.ai/concepts/agents.md): One orchestrator and six worker roles per project — how hlix coordinates a team of AI agents to deliver work end to end.
- [The Coding Workspace](https://docs.hlix.ai/concepts/coding-workspace.md): One persistent sandbox per project, one git worktree per task — where agent-generated code actually runs, and how to open a shell in it.
- [Context, memory & DNA](https://docs.hlix.ai/concepts/context-memory.md): DNA is the identity every agent is composed from; memory is what the workspace has learned. Together they are why the tenth task is better than the first.
- [Glossary](https://docs.hlix.ai/concepts/glossary.md): Every hlix term in one place, each linked to the page that owns it, including the four pairs that are routinely confused.
- [Review & QA gates](https://docs.hlix.ai/concepts/review-gates.md): How hlix evaluates agent output, loops failed work back for another pass, and optionally pauses delivery for a human decision.
- [Triage](https://docs.hlix.ai/concepts/triage.md): Every cycle is judged before it is planned — how the Triage Agent decides forward or cancel, and how platform rules turn that judgement into a lane and a priority.
- [Work tree](https://docs.hlix.ai/concepts/work-tree.md): How hlix structures work — Workspace, Project, Cycle, Task — and which API object, CLI command, and permission belongs to each level.
- [Authenticate](https://docs.hlix.ai/getting-started/authentication.md): Verify an hlix API key, select a workspace, and keep credentials out of shell history.
- [How to use these docs](https://docs.hlix.ai/getting-started/how-to-use-these-docs.md): The five page types, the conventions every page follows, and the machine-readable formats built for LLMs and agents.
- [Install the CLI](https://docs.hlix.ai/getting-started/install.md): Install the hlix CLI, verify it, and know what to do when the install does not take.
- [Quickstart: ship your first task](https://docs.hlix.ai/getting-started/quickstart.md): Import a project, start a run, watch an agent build, and read the verified diff it produced.
- [Connect your agents](https://docs.hlix.ai/guides/connect-agents.md): The coding agents hlix can drive, how one is chosen for a task, and where your provider keys and model choices come from.
- [FAQ](https://docs.hlix.ai/guides/faq.md): Common questions about hlix — how it relates to coding agents, who owns your code, security, and pricing.
- [Move an existing project to hlix](https://docs.hlix.ai/guides/quickstart.md): Move a local project into hlix, verify it in the workspace, and keep both sides synchronized.
- [Recipe: onboard a client repository](https://docs.hlix.ai/guides/recipes/onboard-a-client-repo.md): Take a codebase you were handed, get it into a workspace safely, and ship the first reviewed change.
- [Recipe: parallel cycle delivery](https://docs.hlix.ai/guides/recipes/parallel-cycle-delivery.md): Run many tasks at once against one codebase without collisions, and know what to do when two of them touch the same file.
- [Introduction](https://docs.hlix.ai/index.md): hlix runs coding agents in the cloud — its own harness by default, or Claude Code, Codex & Cursor Agent — with automated QA, human approval, and durable project context.
- [Integrations](https://docs.hlix.ai/integrations.md): The systems hlix connects to — GitHub, Linear, Slack, and Telegram — what each one does, and what it does not.
- [GitHub](https://docs.hlix.ai/integrations/github.md): Install the hlix GitHub App, grant repositories, and get a branch, commits, and a pull request per task.
- [Linear](https://docs.hlix.ai/integrations/linear.md): Install the hlix agent in a Linear workspace, then assign or mention it on an issue and read its replies in the session thread.
- [Slack](https://docs.hlix.ai/integrations/slack.md): Install the hlix Slack app into your workspace and talk to the chat agent in a DM or by @mentioning it in a channel.
- [Telegram](https://docs.hlix.ai/integrations/telegram.md): Link a Telegram chat to your hlix workspace with a one-time code, then talk to the chat agent from your phone.
- [Official MCP server](https://docs.hlix.ai/mcp.md): Connect Cursor, Claude Code, Codex, or Windsurf to a bounded, workspace-scoped Hlix tool server.
- [CLI reference](https://docs.hlix.ai/reference/cli.md): Global options, target resolution, the JSON envelope, error codes, and exit codes shared by every hlix command.
- [hlix auth](https://docs.hlix.ai/reference/cli/auth.md): Reference for hlix auth login, auth status, and auth logout — credential storage, source reporting, and removal.
- [hlix import](https://docs.hlix.ai/reference/cli/import.md): Reference for hlix import — every flag, the trust gate, the dry-run report, and what --yes cannot bypass.
- [hlix init](https://docs.hlix.ai/reference/cli/init.md): Reference for hlix init — the files it writes, what it verifies first, and how it differs from import.
- [hlix projects](https://docs.hlix.ai/reference/cli/projects.md): Reference for hlix projects list and projects get — the default target, the human columns, and the unmodified JSON body.
- [hlix skill, agent & mcp import](https://docs.hlix.ai/reference/cli/resources.md): Reference for the three explicit resource-activation commands — flags, accepted values, and every validation that refuses an import.
- [hlix status](https://docs.hlix.ai/reference/cli/status.md): Reference for hlix status — the resolved workspace and API, the folder binding, and local-versus-cloud drift.
- [hlix push, pull & sync](https://docs.hlix.ai/reference/cli/sync.md): Reference for the three reconciliation commands — flags, the dry-run verdict table, and the forced-pull approval gate.
- [hlix tasks](https://docs.hlix.ai/reference/cli/tasks.md): Reference for hlix tasks list, get, review, and watch — the default project, the JSONL stream, and what this command group deliberately omits.
- [Troubleshooting](https://docs.hlix.ai/reference/troubleshooting.md): A symptom index into every failure section in these docs, plus the cross-cutting diagnostics that belong to no single command.
- [Current versions](https://docs.hlix.ai/releases/availability.md): The published version of every hlix package, and how to install each one.
- [Changelog](https://docs.hlix.ai/releases/changelog.md): Current release status and notable changes across hlix developer tooling.
- [Versions & releases](https://docs.hlix.ai/releases/versioning.md): Understand independent platform, API, CLI, SDK, MCP, npm, GitHub, Registry, and Homebrew release identities.
- [Approvals](https://docs.hlix.ai/running/approvals.md): Park a cycle on a human decision before agents start work, and resolve the pending requests that hold it.
- [Cycles](https://docs.hlix.ai/running/cycles.md): Propose a cycle, execute it, stream its timeline, and collect the artifacts it produced.
- [The dashboard](https://docs.hlix.ai/running/dashboard.md): A tour of the hlix web app — the portfolio overview, the Canvas, and the screens where review and approval happen.
- [Delivery metrics](https://docs.hlix.ai/running/metrics.md): Read a project's real flow — throughput, cycle time, time per stage, aging work, and how much of the automation held without rework.
- [Reviewing output](https://docs.hlix.ai/running/review.md): Read the verified evidence behind a task, comment on a line, and send the work back for a revision.
- [Tasks](https://docs.hlix.ai/running/tasks.md): Create a task, understand why execution comes from a cycle, and stream its status until it finishes.
- [Go SDK preview](https://docs.hlix.ai/sdk/go.md): What the published Go module will look like, and how to generate a client from the OpenAPI contract until it ships.
- [Python SDK preview](https://docs.hlix.ai/sdk/python.md): What the published Python client will look like, and how to generate one from the OpenAPI contract until it ships.
- [TypeScript SDK](https://docs.hlix.ai/sdk/typescript.md): Use the typed hlix client for workspace-scoped automation, imports, revisions, tasks, and streams.
- [Secrets & protected files](https://docs.hlix.ai/security/secrets.md): How hlix discovers, encrypts, restores, and keeps project-local credentials out of Git snapshots and logs.
- [Import trust model](https://docs.hlix.ai/security/trust-model.md): Understand what hlix scans, uploads, executes, quarantines, and refuses during local-to-cloud migration.

## Full text

- [llms-full.txt](https://docs.hlix.ai/llms-full.txt): every documentation page concatenated as plain markdown.