Agent-native · hecho para Claude Code

Planea.
Actúa.
Recuerda.

Tzolk'in orquesta el trabajo de tu agente — del plan a la acción, con memoria que persiste entre sesiones. Un tablero 2D, sin fricción.

Instálalo en tu terminal
$ npx tzolk

Node ≥ 20 · PostgreSQL (o Docker) · macOS / Linux

Guía de instalación →
o instala global
npm i -g tzolk
Tzolk'in / Tablero · tzolkin
Por hacer2
FeatureT-37
tzolk init: instalador en un comando
cliA
RediseñoT-41
Opción hosted
infraA
En progreso1
FeatureT-31
Transiciones smooth en la UI
frontC
En revisión1
CoreT-28
Login web + OAuth device flow
apiC
Completado2
FeatureT-39
Landing de Tzolk'in
landingA
FeatureT-36
Publicar la CLI en npm
infraC
El núcleo

No es otra base de datos.
Es memoria que actúa.

El estado nunca se corrompe porque solo cambia por comandos tipados. Tres reglas, un núcleo — y el mismo motor alimenta la CLI, el MCP y el dashboard.

Lee en Markdown

Salidas limpias y jerárquicas: board para el panorama, task T-N para el detalle. Divulgación progresiva — el agente pide solo el contexto necesario.

Actúa por acciones

Un comando = una acción. move, edit, subtask. Cada acción escribe un evento; nadie edita un blob a mano y nada se corrompe.

Persiste en SQL

PostgreSQL como fuente de verdad. Eventos + notas guardan el qué y el porqué, para retomar en frío entre sesiones.

tzolk task tzolkin T-36
eventos · qué pasó
movió T-36 → donehoy
creó T-39 Landinghoy
editó T-31 prioridadayer
nota: decisión de empaquetadoayer
postgres · fuente de verdad
tasksT-36 · done · feature
eventsmove · actor=Angel agent=claude
notesdecision · "Empaquetado npm"
subtasks3/3 ✓ auto-completa T-N
El modelo

Un tablero 2D: fase × estado

Cada fase del ciclo de vida es su propio kanban. Una tarea vive en una celda (fase, estado) — y done significa algo distinto en cada fase: implementado, probado, desplegado.

La superficie principal

Una CLI que el agente ya sabe usar

La CLI es ~10-35× más barata en tokens que un MCP, y los modelos conocen las CLIs de forma nativa. tzolk es la superficie de primera clase; el MCP es la alterna conversacional.

tzolk — board
# panorama del proyecto, listo para leer
$ tzolk board tzolkin

  Desarrollo  ·············································
    in_progress  T-31  Transiciones smooth en la UI  @claude
    review       T-28  Login web + OAuth             @claude
  Deploy      ·············································
    done         T-36  Publicar la CLI en npm        @claude

# una acción = un comando; escribe un evento
$ tzolk move tzolkin T-36 --status done
   T-36 → Desarrollo / done
Puesta en marcha

Conéctalo en dos pasos

Los datos viven en tu propio PostgreSQL — tus proyectos en tu máquina, no en un servidor ajeno. Ver la guía completa →

1 Levanta la base

Un Postgres local con Docker (o apunta DATABASE_URL a uno tuyo).

# Postgres en localhost:5432
docker run -d --name tzolk-db \
  -e POSTGRES_USER=agentpm \
  -e POSTGRES_PASSWORD=agentpm \
  -e POSTGRES_DB=agentpm \
  -p 5432:5432 postgres:16-alpine

2 Conecta el agente

Instala la CLI y vincula al agente por OAuth — sin pegar tokens a mano.

# instala globalmente (o usa npx)
npm i -g tzolk

# abre el navegador y autoriza
tzolk login

Dale a tu agente una memoria que dura.

Gratis y de código abierto. Instálalo en menos de un minuto.