Repolode
Enviar
huiliyi37

huiliyi37/Tianshu-harness

Un runtime de agentes de programación para terminal y escritorio que mantiene los objetivos, las pruebas y la verificación fuera del historial del chat, basado en una capa de ejecución cognitiva llamada CVM.

Alternativa open source a:Claude Code

Ver en GitHubSitio web
Estrellas
1,145
Forks
86
Issues abiertos
19
Último commit
hace 12 horas

¿Qué es?

Tianshu Harness es un runtime de agentes de programación en TypeScript con una TUI para terminal, una aplicación de escritorio y una extensión de VS Code que comparten un mismo núcleo. Incorpora una capa llamada CVM (Cognitive Virtual Machine) entre el modelo y el proyecto, para que el runtime, y no solo el historial de la conversación, registre los objetivos de las tareas, el estado, las pruebas, los permisos y las condiciones para detenerse.

El flujo de trabajo principal gira en torno a un contrato por tarea y a una etapa de entrega llamada deliver_task. Una tarea solo se marca como completada cuando los resultados de las pruebas, las diferencias o los comandos de verificación sirven como evidencia; de lo contrario, se bloquea la entrega. Los hooks del runtime se ejecutan en cinco etapas de cada turno para detectar bucles, llamadas a herramientas inactivas y errores de edición. Además, un panel de estado (/cockpit) muestra métricas de verificación, costos y caché.

El proyecto admite 25 configuraciones predefinidas de proveedores de modelos, además de cualquier endpoint compatible con OpenAI. También incluye comandos para subagentes, un motor de caché de prefijos, modo de planificación, compatibilidad con MCP y skills, y un sistema de permisos con escritura en sandbox y protección contra el recorrido de rutas.

Funciones clave

  • 01Los contratos por tarea registran los objetivos, el alcance y los criterios de éxito fuera del historial del chat.
  • 02Una etapa de entrega clasifica el trabajo como GREEN, YELLOW o RED según las pruebas, las diferencias y las evidencias de verificación.
  • 03Los hooks del runtime detectan problemas de convergencia, bucles de inactividad y errores de edición en cada turno.
  • 04Compatibilidad integrada con 25 configuraciones predefinidas de proveedores de modelos y endpoints compatibles con OpenAI.
  • 05La TUI para terminal, la aplicación de escritorio y la extensión de VS Code comparten un mismo núcleo de agente.
  • 06Modos de permisos, escritura en sandbox y protección para archivos sensibles y comandos destructivos.

Casos de uso

  • Ejecutar una tarea de programación con varios pasos en un repositorio y exigir pruebas como evidencia antes de aceptar el resultado.
  • Usar DeepSeek u otros modelos compatibles con OpenAI en un flujo de trabajo de programación desde la terminal.
  • Ejecutar el agente sin interfaz desde scripts o CI y obtener eventos en formato NDJSON.
  • Seguir el costo en tokens y la tasa de aciertos de la caché de prefijos en sesiones largas de programación.

Inicio rápido

  1. 1

    Instala globalmente la CLI de terminal con npm (Node.js 24 o posterior).

    npm install -g tianshu-harness
  2. 2

    Inicia la CLI de tianshu y espera a que aparezca el prompt; la primera vez se abrirá el asistente de configuración /connect.

    tianshu

Antes de usarlo

  • La aplicación de escritorio no está notarizada en macOS, por lo que quizá necesites recurrir a xattr la primera vez que la abras.
  • Las versiones de escritorio para Linux requieren glibc 2.35 o posterior y WebKit2GTK; la compatibilidad con Wayland no está verificada.
  • Las cifras de ahorro de caché se basan únicamente en sesiones de DeepSeek de una prueba piloto pequeña con 5 tareas.

En colecciones

Frameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAHerramientas de CLI y terminalAplicaciones GUI de escritorio y frameworks

Temas

#coding-agent#agent-harness#ai-agent#cli#typescript#context-management#deepseek#gui#harness#harness-engineering

Preguntas frecuentes

¿Qué es Tianshu-harness?
Un runtime de agentes de programación para terminal y escritorio que mantiene los objetivos, las pruebas y la verificación fuera del historial del chat, basado en una capa de ejecución cognitiva llamada CVM. Tianshu Harness es un runtime de agentes de programación en TypeScript con una TUI para terminal, una aplicación de escritorio y una extensión de VS Code que comparten un mismo núcleo. Incorpora una capa llamada CVM (Cognitive Virtual Machine) entre el modelo y el proyecto, para que el runtime, y no solo el historial de la conversación, registre los objetivos de las tareas, el estado, las pruebas, los permisos y las condiciones para detenerse.
¿Tianshu-harness es gratuito? ¿Qué licencia tiene?
Tianshu-harness es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Tianshu-harness sigue mantenido?
Mantenimiento activo. El último commit de Tianshu-harness fue el 22 oct 2026.
¿Para qué puedo usar Tianshu-harness?
Ejecutar una tarea de programación con varios pasos en un repositorio y exigir pruebas como evidencia antes de aceptar el resultado. Usar DeepSeek u otros modelos compatibles con OpenAI en un flujo de trabajo de programación desde la terminal. Ejecutar el agente sin interfaz desde scripts o CI y obtener eventos en formato NDJSON. Seguir el costo en tokens y la tasa de aciertos de la caché de prefijos en sesiones largas de programación.
¿Cómo se instala Tianshu-harness?
Instala globalmente la CLI de terminal con npm (Node.js 24 o posterior).: npm install -g tianshu-harness Inicia la CLI de tianshu y espera a que aparezca el prompt; la primera vez se abrirá el asistente de configuración /connect.: tianshu
¿Dónde consigo Tianshu-harness?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/huiliyi37/Tianshu-harness

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados