Una sala de control para los agentes que escriben tu código.
Corre el CLI de código que ya usas, cada tarea en su propio worktree, y deja escrito lo que hizo cada corrida.
curl -fsSL https://getorbit.sh/install | bash
macOS y Linux.
-
Orbit en tres minutos
2:59Lo que hace Orbit, de principio a fin: correr el trabajo, leer lo que hizo, supervisarlo y hacerlo tuyo.
Más en la documentación →
Empezar2 videos · 1:44
-
01
Orbit en un minuto
0:45Un minuto de las grabaciones de abajo, sin sonido.
Más en la documentación → -
02
Cómo empezar
0:59Instálalo, ábrelo donde están tus repositorios y escribe la primera tarea: corre y se detiene donde tú decides.
Más en la documentación →
Correr el trabajo8 videos · 5:43
-
03
Una corrida, de principio a fin
0:58Una tarea avanza por su flujo fase a fase, se detiene en el gate que pusiste y sigue cuando la dejas. Después, cada pestaña muestra lo que hizo.
Más en la documentación → -
04
Varias tareas a la vez
0:36Varias tareas corren a la vez, cada una en su propio worktree y su propia rama, en una sola ventana.
Más en la documentación → -
05
Un cambio, varios repos
0:43Una tarea puede abarcar tu backend y tu frontend: un diff por repositorio, todo en la misma tarea.
Más en la documentación → -
06
Diez agentes, cuatro por ciento
0:52Diez agentes corren a la vez y Orbit usa el 4% de un núcleo. Un IDE haciendo lo mismo usa cerca de la mitad de uno.
Más en la documentación → -
07
Lo que cada agente le cuesta a tu máquina
0:30Presiona
Más en la documentación →%para ver la memoria y la CPU de cada agente, y mata el que se cuelgue. -
08
Autopilot
0:26Una tecla y Orbit trabaja la cola solo. Una tarea que necesita a una persona se detiene y te espera.
Más en la documentación → -
09
La guardia
0:35Cuando un agente se repite, se cuelga o gasta de más, Orbit lo detiene y te devuelve la tarea.
Más en la documentación → -
10
El CLI, en los dos sentidos
1:04Presiona
Más en la documentación →cy tu propio CLI se abre en el worktree de la tarea, ya sabiendo cuál es: Claude Code, Codex, opencode, Cline o Antigravity. Al salir, la sesión queda en las notas de la tarea.
Entender qué hizo4 videos · 3:06
-
11
Leer lo que hizo
0:46Una tarea terminada: cómo el prompt se volvió el diff, lo que el agente dice que hizo y lo que no, el diff mismo, y por dónde del repositorio pasó.
Más en la documentación → -
12
Dentro de una tarea
0:56Las catorce pestañas de una tarea, una por una, cada una con para qué sirve.
Más en la documentación → -
13
Los archivos, como en un editor
0:37El checkout tal como lo dejó la tarea: elige líneas y cópialas, o abre el menú de un archivo para su parche, su ruta, tu editor o Finder.
Más en la documentación → -
14
El mapa de un cambio
0:47Cada ruta que toca un cambio, dibujada hasta la consulta que corre.
Más en la documentación →
Supervisar y aprender2 videos · 1:14
-
15
El supervisor
0:38Un segundo agente revisa cada corrida terminada contra lo que se pidió, y recibe indicaciones en un hilo donde tú escribes.
Más en la documentación → -
16
Lo que Orbit sabe
0:36Las reglas sobre tu código llegan a cada prompt. Cada una guarda su fuente, y puedes acotarla o pausarla.
Más en la documentación →
Hacerlo tuyo3 videos · 1:47
-
17
Flujos que escribes tú
0:31Un flujo es una lista de fases, cada una con su motor, su modelo y sus permisos. Cinco vienen incluidos, y el resto los escribes tú.
Más en la documentación → -
18
Describe un flujo en una frase
0:31Di qué debe hacer el flujo. Orbit escribe un borrador de sus fases y tú lo lees antes de guardarlo.
Más en la documentación →
Sesiones largas2 videos · 1:06
-
20
Compactar una sesión
0:38Cuando se llena el contexto de una sesión, la compactas y sigue.
Más en la documentación → -
21
¿Sin tokens? Cambia de proveedor
0:28Cuando un motor se queda sin tokens, autopilot pasa la tarea a otro, que sigue desde el paso donde se quedó.
Más en la documentación →
Menos tokens1 video · 0:36
-
22
El agente le pide el código a Orbit
0:36El agente le pide a Orbit el código que necesita, y lo entiende más rápido con menos tokens.
Más en la documentación →
Conéctalo3 videos · 1:14
-
23
Orbit por chat
0:24En Telegram: una tarea que se detiene te manda un mensaje, y respondes con los mismos comandos de la terminal.
Más en la documentación → -
24
Una tarea desde el enlace de un issue
0:23Pega el enlace de un issue de Linear, Jira, GitHub o GitLab y el formulario toma su id. Con la variable de ese tracker (LINEAR_API_KEY, JIRA_API_KEY, GITHUB_API_KEY o GITLAB_API_KEY), también lee el texto del issue.
Más en la documentación → -
25
jev juzga cada gate
0:28jev es el motor de decisión que juzga cada gate: en shadow escribe su veredicto y no actúa, y con el ajuste encendido actúa cuando está seguro.
Más en la documentación →
La web1 video · 0:44
-
26
Orbit en el navegador
0:44orbit web muestra el mismo tablero en un navegador: abre una tarea para leer su diff, su línea de tiempo, su reporte y por dónde pasó el cambio.
Más en la documentación →
Cómo usar Orbit
Desde instalarlo hasta correr tus primeras tareas.
01Instalar
Orbit corre tus agentes de código en muchas tareasUn trabajo: qué hacer, en qué repositorio y por qué flujo. a la vez y te muestra qué hizo cada uno. Instálalo y ábrelo sobre tus proyectos.
macOS o Linux, y una CLI de código: Claude Code, Codex, OpenCode, Antigravity o Cline.
-
Instálalo.
curl -fsSL https://getorbit.sh/install | bash -
Conecta tu CLI, para pedirle cosas a Orbit con tus palabras.
orbit mcp install -
Abre la ventana sobre tus repositorios.
orbit top ~/code -
Escribe tu primera tarea y córrela, como muestra Corre una tarea.
Lo que verásCada repositorio git bajo ~/code.
Actualiza con orbit upgrade.
02Conceptos
Siete palabras que usa el resto de esta documentación. Cada una va subrayada donde aparece por primera vez, con su significado al pasar el cursor.
- Tarea
- Un trabajo: qué hacer, en qué repositorio y por qué flujo.
- Flujo
- Las fases por las que pasa una tarea, en orden, del plan a tu revisión.
- Fase
- Un paso de un flujo, que hace un engine: planear, implementar, revisar.
- Gate
- Lo que una fase tiene que pasar para que el flujo siga: los tests, un lint, tu revisión.
- Worktree
- Un checkout aparte de tu repositorio para una tarea, en su propia rama. Tu checkout nunca se toca.
- Engine
- El agente de código que hace una fase: Claude Code, Codex, OpenCode, Antigravity o Cline.
- Supervisor
- Un segundo agente que lee cada corrida terminada contra lo que se pidió, y toma tus indicaciones.
03Corre una tarea
Una tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo. es un trabajo. Orbit la corre en su propio worktreeUn checkout aparte de tu repositorio para una tarea, en su propia rama. Tu checkout nunca se toca., un checkout aparte de tu repo, faseUn paso de un flujo, que hace un engine: planear, implementar, revisar. por fase.
-
Escribe la tarea: un título, qué hacer, el repositorio, el flujoLas fases por las que pasa una tarea, en orden, del plan a tu revisión..
Pídeselo a tu CLI
Escribe una tarea en payments: el total del carrito ignora los reembolsos.orbit_create_taskPresiona
N.orbit board new CHK-5 "fix the cart total"Escribir una tarea, en el tablero.
-
Arráncala. Orbit muestra el plan y luego la corre.
Pídeselo a tu CLI
Arranca CHK-5.orbit_retry_taskPresiona
n.orbit task start CHK-5Iniciar, en la cabecera de la tarea.
-
Se detiene donde el flujo diga, casi siempre en tu revisión. Déjala seguir.
Pídeselo a tu CLI
CHK-5 se ve bien, déjala seguir.orbit_task_continuePresiona
r.orbit task continue CHK-5Continuar, en la cabecera de la tarea.
-
Arranca las que quieras. Cada una corre en su propio worktree y su propia rama.
-
Saca el registro de cada corrida.
Pídeselo a tu CLI
Exporta el registro a ~/orbit-record.orbit_exportLa ventana todavía no lo hace.
orbit export ~/orbit-recordLa web todavía no lo hace.
Nada llega a tu rama hasta que tú lo digas.
Diez agentes a la vez le cuestan a Orbit cerca del 4% de un núcleo.
04Lee lo que hizo
Cada tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo. está en una de cuatro bandas: Por hacer, En curso, En revisión, Terminadas. Abre una para ver qué hizo.
-
Abre una tarea para ver qué hizo.
Pídeselo a tu CLI
¿Qué hizo CHK-4?orbit_inspect_taskPresiona
⏎sobre ella.orbit task show CHK-4Haz clic en ella en el tablero.
-
Lee sus pestañas: los cambios, la revisión, la línea de tiempo, el costo y más.
Pídeselo a tu CLI
Muéstrame qué cambió CHK-4.orbit_task_difftabrecorre sus catorce pestañas.orbit task diff CHK-4Las pestañas bajo la cabecera de la tarea.
-
Copia líneas del checkout que dejó la tarea, o el patch de un archivo.
El MCP todavía no lo hace.
En la pestaña de archivos, shift y las flechas eligen líneas y
ctrl+Ylas copia. El menú de cada archivo copia su patch.Todavía no hay un comando para esto.
La pestaña Archivos.
-
Abre la tarea en tu propia CLI, que ya conoce la tarea. Al salir, la sesión queda en las notas de la tarea.
El MCP todavía no lo hace.
Presiona
c.Todavía no hay un comando para esto.
La web todavía no lo hace.
-
Mira el tablero entero.
Pídeselo a tu CLI
¿Qué me necesita?orbit_get_board_summaryEs la primera pantalla de la ventana.
orbit board listEl tablero.
-
Trabaja también en otro repositorio: el id de la tarea y luego el nombre del repositorio.
Pídeselo a tu CLI
Que CHK-4 trabaje también en ledger.orbit_task_joinLa ventana todavía no lo hace.
orbit join CHK-4 ledgerSumar un repositorio, en el menú Acciones de la tarea.
En revisión: detenida por una revisión, un check que falló o una pausa.
m lista todo lo que puedes hacerle a la tarea bajo el cursor.
05Entrega el cambio
Una tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo. terminada se vuelve un pull request, y lo sigues desde el tablero.
La CLI de GitHub, gh, con sesión iniciada.
-
Sube la rama de la tarea y abre su pull request.
El MCP todavía no lo hace.
Presiona
P.orbit pr CHK-4Crear PR, en la cabecera de la tarea o en su menú Acciones.
-
Pon la rama al día con su base.
Pídeselo a tu CLI
Pon al día la rama de CHK-4.orbit_pr_updatePresiona
U.orbit pr update CHK-4Actualizar PR, en el menú Acciones de la tarea.
-
Manda un agente a arreglar los checks que fallan.
Pídeselo a tu CLI
Haz que pasen los checks de CHK-4.orbit_pr_checksPresiona
C.orbit pr checks CHK-4Arreglar checks, en el menú Acciones de la tarea.
-
Manda uno a responder los comentarios de la revisión.
Pídeselo a tu CLI
Responde los comentarios de la revisión de CHK-4.orbit_pr_resolvePresiona
O.orbit pr resolve CHK-4Resolver comentarios, en el menú Acciones de la tarea.
-
Haz el merge.
El MCP todavía no lo hace.
Presiona
J.orbit pr merge CHK-4Merge del PR, en el menú Acciones de la tarea.
En la ventana, cada tecla actúa sobre la tarea bajo el cursor, en el tablero o dentro de la tarea.
Un pull request, sus actualizaciones y su merge llegan a GitHub: otras personas los ven.
06Flujos
Un flujoLas fases por las que pasa una tarea, en orden, del plan a tu revisión. es la lista de fasesUn paso de un flujo, que hace un engine: planear, implementar, revisar. por la que pasa una tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo., cada una con su engineEl agente de código que hace una fase: Claude Code, Codex, OpenCode, Antigravity o Cline., su modelo y sus permisos.
-
Mira cada flujo, fase por fase.
Pídeselo a tu CLI
¿Qué flujos puedo usar?orbit_list_flowsPresiona
F.orbit flowsLa pantalla Flujos.
-
Escribe el tuyo, o descríbelo en una frase y Orbit redacta las fases.
Pídeselo a tu CLI
Haz un flujo como careful, con una revisión de seguridad antes del pull request.orbit_save_flowPresiona
Nen la pantalla de flujos. Su pestaña Descríbelo redacta uno a partir de una frase.Todavía no hay un comando para esto.
La web todavía no lo hace.
-
Elige el engine y el modelo de cada fase.
Pídeselo a tu CLI
En mi flujo, corre la revisión con codex.orbit_save_flowEl engine y el modelo de cada fase, en el formulario del flujo.
Todavía no hay un comando para esto.
La web todavía no lo hace.
Cinco flujos vienen incluidos.
07Motores
Elige el motor y el modelo de cada faseUn paso de un flujo, que hace un engine: planear, implementar, revisar..
-
Mira qué enginesEl agente de código que hace una fase: Claude Code, Codex, OpenCode, Antigravity o Cline. tienes.
Pídeselo a tu CLI
¿Qué engines puede correr Orbit aquí?orbit_enginesPresiona
E.orbit enginesLa pantalla Motores.
-
Elige el de por defecto.
Pídeselo a tu CLI
Pon codex como engine por defecto.orbit_settings_set:settings, y luego engine.orbit settings set engine codexLa pantalla Ajustes.
-
¿Sin tokens? Sigue con otro engine, desde el paso donde se detuvo.
El MCP todavía no lo hace.
Presiona
n. Ofrece los engines que tienen cuota.orbit task start CHK-4 -engine codexLa web todavía no lo hace.
-
¿Contexto lleno? Sigue en una sesión limpia.
Pídeselo a tu CLI
Compacta la sesión de CHK-4.orbit_compactPresiona
ctrl+K.orbit task compact CHK-4 "…"Compactar, en el menú Acciones de la tarea.
-
Mira lo que cada agente le cuesta a tu máquina, y mata el que se cuelga.
Pídeselo a tu CLI
¿Cuánto le cuesta cada agente a la máquina?orbit_board_meterPresiona
%, yctrl+Tsobre el que se cuelga.orbit board meterLa máquina, en el menú.
El coste por fase está en la pestaña de coste, y Q muestra lo que queda.
08Encuentra código
Orbit indexa el código de cada tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo.. El agente le pide lo que necesita en vez de abrir archivo tras archivo.
-
Pregunta lo que pregunta el agente: el código del que hablan esas palabras, cada función entera.
Pídeselo a tu CLI
Busca el código de reembolsos en CHK-4.orbit_task_findLa ventana todavía no lo hace.
orbit task find CHK-4 "refund"La web todavía no lo hace.
-
Pon el índice al día.
Pídeselo a tu CLI
Pon al día el índice de código de CHK-4.orbit_task_indexLa ventana todavía no lo hace.
orbit task index CHK-4La web todavía no lo hace.
No hay nada que configurar: a cada fase se le enseña a preguntar, con la herramienta orbit_task_find.
09Autopilot y el supervisor
Autopilot trabaja la cola, y el supervisorUn segundo agente que lee cada corrida terminada contra lo que se pidió, y toma tus indicaciones. revisa cada corrida terminada.
-
Enciende autopilot.
Pídeselo a tu CLI
Enciende autopilot.orbit_settings_setPresiona
A.orbit settings set autopilot onLa pantalla Ajustes.
-
Dile al supervisor qué vigilar.
Pídeselo a tu CLI
Dile al supervisor: nunca toques migrations/ sin preguntarme.orbit_supervisor_sayPresiona
S.orbit supervisor say "…"La pantalla Supervisor.
-
Pon un tope a lo que gasta una tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo.: la guardia la detiene en $3.
Pídeselo a tu CLI
Pon un tope de $3 a lo que gasta cada tarea.orbit_settings_set:settings, y luego el grupo Guardia.orbit settings set guard.task-spend 3La pantalla Ajustes, grupo Guardia.
Nunca pasa por encima de tu pausa ni de una tarea crítica.
La guardia detiene una llamada que se cuelga o se repite, y dice por qué.
10Reglas
Las reglas sobre tu código llegan al prompt de cada faseUn paso de un flujo, que hace un engine: planear, implementar, revisar.. Orbit las aprende de ti, de tus docs, de tu historial y de tus checks.
-
Mira cada regla, las pendientes primero.
Pídeselo a tu CLI
¿Qué sabe Orbit de payments?orbit_knowledgePresiona
K.orbit knowledgeLo que Orbit sabe, en el menú.
-
Guarda una frase como regla, y cada fase la recibe.
Pídeselo a tu CLI
Guarda la primera regla de la bandeja.orbit_rules_keepPresiona
Nen la pantalla de reglas.orbit rules keep 1Guardar, en la regla.
-
Limítala a un repositorio o a una carpeta.
Pídeselo a tu CLI
Guárdala solo para migrations/.orbit_rules_keepDónde aplica, en el formulario de la regla.
orbit rules keep 1 -in migrations/Dónde aplica, en el formulario de la regla.
-
Dale un check, y bloquea el trabajo que no lo pase.
Pídeselo a tu CLI
Haz que bloquee el trabajo que no pase make check.orbit_rules_keepEl check, en el formulario de la regla.
orbit rules keep 1 -check "make check"El check, en el formulario de la regla.
Cada regla guarda de dónde salió. Pausa la que te estorbe.
11Conéctalo
Telegram, tus trackers, jev y tu CLI de código.
-
Telegram: exporta el token de tu bot de @BotFather.
export ORBIT_TELEGRAM_TOKEN=… -
Arranca el chat. Te responde con tu chat id.
orbit chat -on telegram -
Guarda el id con el que te respondió, ese número en lugar de 7912204269. Solo esa cuenta puede dar órdenes.
orbit settings set chat-id 7912204269 -
Linear: pega la URL de un issue en el formulario de tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo. nueva (
N). La key trae su texto.export LINEAR_API_KEY=… -
Jira, GitHub, GitLab: igual, cada uno con su key. Jira además pide su host y, en atlassian.net, tu email. Pon los tuyos en lugar de los de ejemplo.
export GITHUB_API_KEY=… GITLAB_API_KEY=… JIRA_API_KEY=… JIRA_HOST=acme.atlassian.net JIRA_EMAIL=you@acme.com -
jev: anota sus veredictos y no actúa. Necesita
TYPESAFE_API_KEY.orbit settings set decisions shadow
En Telegram, lo que no se puede deshacer pide /yes.
Un enlace que no es de un issue se rechaza, con la forma que tiene el enlace de un issue.
Orbit lee los issues y nunca escribe en tu tracker.
12La web
El mismo tablero en tu navegador, solo en tu máquina.
-
Arráncala.
orbit web -
O presiona
osobre una tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo..
Lo que veráshttp://127.0.0.1:7777, con las mismas bandas, pestañas y teclas.
La pestaña de revisión dibuja el cambio hasta la consulta.
El navegador lee y abre tareas. Para entrar a una sesión, te da el comando para correr en una terminal.
13Teclas
Las minúsculas actúan sobre la tareaUn trabajo: qué hacer, en qué repositorio y por qué flujo.. Las mayúsculas abren una pantalla.
? lista todas las teclas, m lo que aplica aquí, : recibe un comando.
D y las teclas del pull request son mayúsculas que actúan sobre la tarea.
Moverse
- ↑
- Arriba
- ↓
- Abajo
- g
- Primera
- G
- Última
- PgUp
- Página arriba
- PgDn
- Página abajo
- ⏎
- Abrir
- esc
- Volver
- tab
- Pestaña siguiente
- ⇧tab
- Pestaña anterior
- ←→
- Desplazar en horizontal
- @
- Qué repositorio
Empezar trabajo
- n
- Poner en marcha
- N
- Escribir una tarea
- m
- Menú de la tarea
- M
- Menú del tablero
La tarea que tienes delante
- p
- Pausar
- r
- Reanudar
- s
- Saltar esta fase
- ctrl+K
- Compactar
- ctrl+R
- Volver a correr la fase que falló
- x
- Cancelar
- b
- Volver a por hacer
- t
- Tomar el teclado
- h
- Devolverlo
- ctrl+O
- Ver la fase
- a
- Preguntar
- d
- Marcar leída
- D
- Eliminar
- o
- Abrir en la web
Pantallas e interruptores
- /
- Filtrar
- :
- Comandos
- c
- CLI interactiva
- !
- Consola
- R
- Repositorios
- F
- Flujos
- K
- Lo que orbit sabe
- E
- Ajustes de modelo y motor
- Q
- Quota
- S
- Supervisor
- A
- Piloto automático
- %
- Memoria y CPU
- ctrl+T
- Matar un proceso huérfano
- L
- Idioma
- ?
- Ayuda
- q
- Salir
Sacar texto
- ctrl+S
- Seleccionar texto con el mouse
- ctrl+Y
- Copiar lo que está bajo el puntero
El pull request
- P
- Crear PR
- U
- Actualizar PR
- J
- Merge PR
- X
- Cerrar PR
- C
- Corregir checks
- T
- Más pruebas
- O
- Resolver comentarios
- V
- Revisión a fondo
14Qué cuenta Orbit
Cuántas máquinas usan Orbit y en qué versión. Nada sobre ti ni sobre tu código.
-
Apágalo.
DO_NOT_TRACK=1también sirve.export ORBIT_NO_TELEMETRY=1
Se envía una vez al instalar y luego como mucho una vez al día: un id aleatorio creado en tu máquina, la versión, el sistema y el procesador.
Ni nombre, ni email, ni repositorio, ruta, tarea o prompt. El servidor no guarda ninguna dirección.
El id está en ~/.orbit/telemetry-id. Bórralo para empezar de nuevo como otra máquina.
Qué hay de nuevo
Lo más reciente primero.