orbit

[!IMPORTANT] Orbit aún está en fase de desarrollo inicial. La versión actual no tiene autenticación propia, así que no lo expongas directamente a Internet; úsalo en una red local o detrás de un proxy de autenticación como Cloudflare Access.

El problema que Orbit resuelve

Las herramientas de gestión de conocimiento existentes suelen exigir al usuario que diseñe primero carpetas, bases de datos, propiedades y reglas de automatización. Orbit funciona al revés.

1. Registra notas, enlaces, tareas y eventos sin formato en el Inbox.

2. El original permanece como archivos Markdown + YAML legibles por humanos.

3. En Today se ven juntos los elementos de ejecución y los eventos de hoy.

4. Los agentes externos acceden a los mismos archivos a través de MCP.

5. La organización con IA es una función opcional; las propuestas de cambio se aplican después de que el usuario las apruebe.

Related MCP server: Knowledge Base MCP Server

Lo que ya funciona

• Lectura de vault Markdown/YAML

• Captura de notas, tareas, eventos y enlaces como archivos de Inbox

• Cálculo de las tareas de hoy y marcado de completadas

• Listado, búsqueda, edición, vista previa GFM, etiquetas y archivado de notas Markdown

• Visualización del Inbox reciente y de los próximos eventos

• shadcn/ui basado en Neutral con modo oscuro gris oscuro

• MCP orbit_capture, orbit_today, orbit_search

• Separación de la ubicación de datos con ORBIT_DATA_DIR

• Pantalla Today adaptada a móvil

Lo que aún no existe: inicio de sesión, clasificación automática con IA, pantalla de aprobación de cambios, búsqueda completa del vault, sincronización CalDAV, copia de seguridad automática con Git, vigilancia de archivos SSE. El alcance y el orden están recogidos en la hoja de ruta.

Inicio rápido

Requisitos: Node.js 22 o superior, pnpm 10 o superior

git clone https://github.com/kmelon55/orbit.git
cd orbit
pnpm install
cp .env.example .env
pnpm dev

El vault por defecto es ./data del proyecto. Para separar los datos personales del código de la aplicación, especifica una ruta absoluta en .env.

ORBIT_DATA_DIR=/data/orbit

Estructura de archivos

/data/orbit/
├── inbox/
├── projects/
├── areas/
├── resources/
├── events/
└── archive/

Las tareas no quedan encerradas en una base de datos separada ni en una carpeta tasks/. Los archivos Markdown de Inbox, Project y Area tienen type: task, y Orbit los reúne en Today.

---
id: 6c654756-053f-459a-9d73-c8a7c1ff020d
title: 첫 공개 릴리스 준비
type: task
space: project
project: Orbit
status: open
tags:
  - launch
created: 2026-08-23T09:00:00+09:00
updated: 2026-08-23T09:00:00+09:00
---

README와 기본 파일 계약을 검토한다.

Consulta el documento de arquitectura para conocer el contrato completo de archivos.

Conexión MCP

El servidor MCP de Orbit se ejecuta con stdio.

ORBIT_DATA_DIR=/absolute/path/to/orbit-data pnpm mcp

Ejemplo de configuración de cliente MCP:

{
  "mcpServers": {
    "orbit": {
      "command": "pnpm",
      "args": ["--dir", "/absolute/path/to/orbit", "mcp"],
      "env": {
        "ORBIT_DATA_DIR": "/absolute/path/to/orbit-data"
      }
    }
  }
}

Puedes conectarte de la misma manera desde cualquier agente que admita servidores MCP stdio, incluido Hermes. Consulta la documentación de tu cliente para conocer las claves de configuración exactas.

Docker / Dokploy

docker build -t orbit .
docker run --rm -p 3000:3000 \
  -e ORBIT_DATA_DIR=/data/orbit \
  -v orbit-data:/data/orbit \
  orbit

En Dokploy, usa el Dockerfile de este repositorio y conecta /data/orbit como volumen persistente. Antes de exponerlo al exterior, asegúrate de configurar un proxy de autenticación.

Desarrollo

pnpm test       # Biome + TypeScript
pnpm build      # production build
pnpm mcp        # stdio MCP server

Consulta CONTRIBUTING.md para saber cómo contribuir.

Principios

• Los archivos son la fuente de verdad, no el formato de exportación del producto.

• SQLite solo se usa para datos regenerables como el índice de búsqueda, el estado de sincronización y la caché.

• El proveedor de IA es BYOK, y el flujo básico de registro y ejecución debe funcionar sin IA.

• Los cambios destructivos de los agentes pasan por defecto por las fases de propuesta → revisión → aplicación.

Licencia

MIT