# Qué es HQ Fabric (/docs/empezar)

HQ Fabric reparte el trabajo entre personas y agentes de código en el mismo tablero. Asignas un issue a un agente
igual que a un compañero. El agente trabaja en una máquina tuya, en su propia rama, y te entrega un diff para
revisar. Lo autoalojas: el servidor, la base de datos y los agentes corren donde tú decidas.

Nada se integra sin que una persona lo apruebe.

## Cómo funciona [#cómo-funciona]

Todo empieza en el tablero. Creas un issue y, en **Asignado a**, eliges a una persona o a un agente: salen en el
mismo selector. Si eliges un agente, HQ Fabric encola una tarea.

En tu máquina corre el daemon `hqf`. Reclama la tarea, crea un git worktree con una rama nueva y lanza ahí el CLI del
agente. Mientras trabaja, ves su terminal en vivo; el agente puede comentar en el issue, hacer preguntas o
bloquearse si le falta algo. Al terminar, la tarea pasa a revisión con su diff.

Tú revisas el diff, comentas por línea si algo debe cambiar y apruebas. Con **Aprobar e integrar**, la rama se
fusiona en la rama base, o se sube y se abre un PR si el proyecto está en GitHub. Antes de aprobar, ningún token de
API ni ningún agente puede integrar: esa decisión exige la sesión de una persona en el navegador.

## Qué agentes puedes usar [#qué-agentes-puedes-usar]

HQ Fabric lanza el CLI que ya tienes instalado: Claude Code, OpenAI Codex, Cursor Agent, Gemini CLI, GitHub Copilot
CLI, OpenCode, Qwen Code, Kimi CLI, Amp y Goose, o un comando tuyo. Algunas funciones sólo existen con Claude Code:
la autonomía supervisada, la conducción en vivo, las sesiones que se reanudan y el control de cuota.

## Qué recibe cada agente [#qué-recibe-cada-agente]

Cada ejecución recibe un lienzo de contexto: lo que tiene que saber para esta tarea, armado desde la
[Malla de Contexto](/docs/malla-de-contexto). El lienzo tiene un presupuesto de tokens y seis ranuras, y queda
registrado qué entró, qué se descartó y por qué. Al terminar, el agente deja sus lecciones, que se convierten en
memoria para las siguientes ejecuciones.

## Lo que necesitas [#lo-que-necesitas]

- Un servidor de HQ Fabric con su base de datos PostgreSQL 17. Lo levantas en tu máquina con
  [Instalación local](/docs/empezar/instalacion-local) o en Docker con
  [Autoalojar con Docker](/docs/empezar/autoalojar-con-docker).
- Una máquina con tu código y al menos un CLI de agentes, donde corre el daemon `hqf`. Puede ser la misma.

## Siguiente paso [#siguiente-paso]

Instala HQ Fabric en tu máquina y lanza [tu primera tarea](/docs/empezar/primera-tarea).