Documentación

Epismo es un espacio de trabajo compartido para el trabajo que las personas y los agentes de IA realizan juntos. A medida que los equipos entregan más trabajo a los agentes, se siguen perdiendo dos cosas: el conocimiento que un agente necesita para actuar bien y el estado actual del trabajo en sí. Epismo les da a ambos un hogar.

• El conocimiento y el proceso reutilizables se encuentran en paquetes. Un paquete es algo que se guarda una vez y se reutiliza muchas veces: una guía de incorporación, una lista de verificación de revisión, un resumen de investigación, un runbook.
• El trabajo activo vive en pistas. Una pista es algo con un estado que avanza hacia su finalización: una tarea o una meta con progreso.

El mismo modelo está disponible a través de tres interfaces (el CLI, el HTTP API y el servidor MCP), por lo que su terminal, su canal de CI, el backend de su producto y sus asistentes de IA leen y escriben la misma fuente de verdad. Nada está encerrado en una sola herramienta.

Si es nuevo en Epismo, lea esta página y luego Conceptos básicos. Juntos responden a las tres preguntas que la mayoría de la gente tiene el primer día: ¿qué debo crear, quién puede verlo y qué interfaz debo usar?

El modelo básico

Casi todo en Epismo es conocimiento reutilizable o trabajo activo. Decidir cuál tienes es la primera habilidad que debes aprender.

Una regla general rápida:

• ¿Reutilizarás el contenido más adelante? Crea un paquete.
• ¿Es necesario que el elemento llegue a "Listo"? Crea una pista.
• Un procedimiento repetible → un paquete de flujo de trabajo. Material de referencia → un paquete de contexto.
• Un trabajo concreto → una pista de tareas. Un resultado hacia el que se realiza un seguimiento del progreso → un seguimiento de objetivos.

Pruébalo en cinco minutos

El CLI es la forma más rápida de sentir cómo funciona el modelo. Instálalo e inicia sesión:

npm install -g epismo
epismo login --email you@example.com
epismo whoami

Guarde algunos conocimientos reutilizables como un paquete de contexto. Cada bloque es una sección con nombre de material de referencia:

epismo pack create --type context --title "Team onboarding" --personal \
  --blocks '[{"title":"Where things live","content":"Docs in Notion, code in GitHub, designs in Figma."},{"title":"How we work","content":"Weekly planning on Mondays; ship behind feature flags."}]'

Asigne un alias al ID del paquete devuelto para que usted y sus agentes puedan referirse a él mediante un nombre legible en lugar de un UUID sin formato:

epismo alias upsert @team-onboarding --reference $PACK_REFERENCE
epismo pack get @team-onboarding --full

Ahora cree un trabajo activo como seguimiento de tareas y luego búsquelo nuevamente con la búsqueda:

epismo track create --type task --title "Review docs structure" --personal \
  --task '{"status":"todo","dueDate":"2026-06-05"}'
 
epismo track search --type task --personal --filter '{"status":["todo"]}'

Ese es el bucle central Epismo: capturar conocimiento reutilizable como paquetes y luego impulsar la ejecución como pistas.

Elige una interfaz

Las tres interfaces hablan el mismo modelo de objetos. Elija según dónde se realiza el trabajo.

Si no está seguro, comience con el CLI. Sus entradas están muy cerca de los cuerpos de solicitud API, por lo que un ejemplo de JSON que funcione en su terminal suele ser un buen punto de partida para una integración.

Administrar un espacio de trabajo

Los Owners y Admins utilizan Administración para la configuración del espacio de trabajo que no depende de una interfaz específica.

Modelo de objetos

Estos son los componentes básicos con los que trabajará en todas partes de Epismo.

¿Quién puede ver tus datos?

Los datos privados residen en uno de dos lugares: su espacio personal o uno o más proyectos dentro de un espacio de trabajo. Tú eliges la ubicación con scope.

Guárdate algo para ti:

{ "scope": { "type": "personal" } }

Compártelo con un equipo a través de un proyecto:

{ "scope": { "type": "projects", "ids": ["project-id"] } }

Dos detalles que vale la pena recordar desde el principio:

• Las llamadas de creación y actualización toman un único scope. Las llamadas de búsqueda toman scopes (plural) para que pueda buscar en varias ubicaciones privadas a la vez.
• Utilice sharedWith para exponer también un elemento privado a personas específicas mediante ID de usuario o correo electrónico.

Conceptos básicos cubre espacios de trabajo, proyectos y uso compartido en su totalidad.

Convenciones utilizadas en todo

Algunas reglas se aplican en todas las interfaces, por lo que los ejemplos de estos documentos son coherentes:

• Las fechas utilizan YYYY-MM-DD. Una cadena vacía borra una fecha opcional.
• Los campos de contenido de Markdown aceptan hasta 65.535 caracteres; Los títulos son obligatorios y tienen un límite de 255.
• Las actualizaciones utilizan la semántica PATCH a menos que una página indique lo contrario: los campos que omites mantienen su valor actual.
• Las respuestas son JSON. En CLI, los resultados van a stdout y las advertencias o errores van a stderr.

Qué leer a continuación

1. Conceptos básicos: elegir objetos, alcances y cómo funciona el uso compartido.
2. CLI referencia: crea y busca packs y tracks desde tu terminal.
3. Referencia API: cree una integración de producto sobre HTTP.
4. Servidor MCP: conecte un agente AI o cliente MCP.
5. Administración: gestione la suscripción, los créditos y SSO empresarial.