pm
Menú

Tu tracker es una carpeta en tu repositorio.

pm guarda tareas, decisiones y todo su historial como archivos simples en .agents/pm/. Tus agentes los leen en el formato compacto TOON, trabajan en ramas separadas y fusionan los cambios de los demás con los propios controladores de fusión de pm.

npm install -g @unbrained/pm-cli

Leer la guía rápida

pm-t05d8d · Issueclosed

Allow self-isolating linked package tests without inherited PM_PATH

priority: 1 · risk: –

test_runs: 1 (last: passed)

comments: 6

resolution: Added explicit pm_context_mode=none across parser, SDK types, CLI/MCP contracts, help, completion, execution preflight, and docs; non-PM commands run only in isolated or snapshot workspaces, with PM_GLOBAL_PATH still sandboxed.

.agents/pm/issues/pm-t05d8d.toon · 8,6 kB · 21 campos más en el archivo

25 entradas en .agents/pm/history/pm-t05d8d.jsonl

Esta es la tarjeta real de pm-t05d8d del propio tracker de pm, corregida en pm 2026.9.28. 8,6 kB en TOON, 9,4 kB en JSON: 2214 y 2290 tokens (o200k_base).

Muchos agentes, muchas ramas, un solo tracker

Cuando dos agentes cambian el tracker en ramas distintas, git entrega ambos lados a los controladores de fusión de pm, que los combinan campo por campo en lugar de línea por línea.

mainagent-a · feat/searchclaim pm-a1f3close pm-a1f3agent-b · fix/mergeclaim pm-b7k2close pm-b7k2agent-c · docs/sdkclaim pm-c9q4close pm-c9q4
Un archivo por elemento
Cada elemento es su propio archivo en .agents/pm/, así que una tarea creada en una rama nunca toca un archivo que otra rama haya cambiado.
Un historial que solo crece
Cada cambio se añade al historial del elemento con una cadena de hashes, así que las entradas de ambas ramas sobreviven a la fusión.
Controladores de fusión que entienden ambos
pm init registra los controladores al empezar. pm merge install los repara en un clon nuevo.

Lo primero que lee tu agente

pm context --limit 10 da a un agente el estado del proyecto en una sola llamada: qué está en curso, qué está bloqueado y qué toca después. Este es el propio tracker de pm.

$ pm context --limit 10
summary:
  returned_focus:
    active_items: 18
    in_progress: 0
    open: 18
    blocked: 10
  blocked_fallback_used: false
  high_level: 10
  low_level: 4
  agenda_events: 2
  scope: "matching_items"
  active_items: 221
  open: 221
  in_progress: 0
  blocked: 60
  total_items: 2826
  closed: 2532
  canceled: 14
high_level:
  - id: "pm-doxj"
    title: "pm-cli post-v0.1 roadmap & living backlog"
    type: "Milestone"
    status: "open"
    priority: 0
    tags:
      - "backlog"
      - "context-management"
      - "living-map"
      - "pm-cli"
      - "post-v0.1"
      - "roadmap"
    updated_at: "2026-09-12T20:05:01.648Z"
Generado 29 sept 2026, 13:20 UTC por pm 2026.9.28. 8,2 kB en TOON, 11,8 kB en JSON.

El ciclo que sigue cada agente

Cinco comandos, en este orden, para cada trabajo.

  1. Orientarse

    Ver qué está en curso, qué está bloqueado y qué viene después.

    pm context --limit 10

  2. Reclamar

    Tomar un elemento para que ningún otro agente empiece con él.

    pm claim <id>

  3. Vincular evidencias

    Adjuntar los archivos que cambias y el comando que los prueba.

    pm files <id> --add src/x.ts
pm test <id> --add command="npm test"

  4. Verificar

    Ejecutar las pruebas vinculadas. El resultado queda registrado en el elemento.

    pm test <id> --run

  5. Cerrar

    Cerrar el elemento con la evidencia y después liberar tu reclamación.

    pm close <id> "<evidence>"
pm release <id>

Paquetes

Añade integraciones y flujos de trabajo a un proyecto con pm install.

Ver los 34 paquetes

O úsalo alojado

El mismo tracker, compartido con tu equipo en tiempo real desde el navegador, ChatGPT o cualquier cliente MCP.