orbit

[!ВАЖНО] Orbit находится на ранней стадии разработки. В текущей версии нет собственной аутентификации, поэтому не публикуйте его в открытый интернет — используйте в локальной сети или за обратным прокси с аутентификацией, например Cloudflare Access.

Какую проблему решает Orbit

Многие инструменты для управления знаниями требуют сначала спроектировать папки, базы данных, свойства и правила автоматизации. Orbit работает наоборот.

1. Заметки, задачи, ссылки и события записываются в Inbox без формата.

2. Исходные данные остаются в читаемых человеком файлах Markdown + YAML.

3. На экране Today видны сегодняшние задачи и события вместе.

4. Внешние агенты получают доступ к тем же файлам через MCP.

5. Упорядочивание с помощью ИИ — опционально: любые изменения сначала предлагаются, и вы подтверждаете их перед применением.

Related MCP server: Knowledge Base MCP Server

Что уже работает

• Чтение хранилища Markdown/YAML

• Захват заметок, задач, ссылок и событий в файлы Inbox

• Расчёт сегодняшних задач и отметка выполненных

• Список, поиск, редактирование, предпросмотр GFM, теги, архивирование заметок Markdown

• Просмотр последних элементов Inbox и предстоящих событий

• Тёмная тема на основе Neutral с интерфейсом shadcn/ui

• MCP-сервер: orbit_capture, orbit_today, orbit_search

• Расположение данных задаётся через ORBIT_DATA_DIR

• Адаптивный экран Today для мобильных устройств

Чего ещё нет

Входа в систему, автоматической сортировки с помощью ИИ, экрана подтверждения изменений, полнотекстового поиска по всему хранилищу, синхронизации CalDAV, автоматического резервного копирования в Git, отслеживания изменений файлов через SSE. Объём и порядок работ зафиксированы в дорожной карте.

Быстрый старт

Требования: Node.js 22 или новее, pnpm 10 или новее

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

По умолчанию хранилище находится в ./data проекта. Чтобы отделить личные данные от кода приложения, укажите абсолютный путь в .env.

ORBIT_DATA_DIR=/data/orbit

Структура файлов

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

Задачи не заперты в отдельной базе данных или папке tasks/. Внутри заметок Markdown в Inbox, Project и Area задачи помечаются свойством type: task, и Orbit собирает их на экране 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와 기본 파일 계약을 검토한다.

Полное описание формата файлов — в документации по архитектуре.

Подключение MCP

MCP-сервер Orbit запускается через stdio.

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

Пример настройки клиента MCP:

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

Аналогично подключается в Hermes и других агентах, поддерживающих MCP-серверы через stdio. Точные ключи конфигурации смотрите в документации вашего клиента.

Docker / Dokploy

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

В Dokploy используйте Dockerfile из этого репозитория и подключите /data/orbit как постоянный том. Не открывайте доступ из интернета без настройки аутентификации на обратном прокси.

Разработка

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

Порядок действий описан в CONTRIBUTING.md.

Принципы

• Файлы — источник истины, а не экспортный формат.

• SQLite используется только для поискового индекса, состояния синхронизации и кэша — эти данные всегда можно пересоздать.

• ИИ работает по принципу BYOK (собственный ключ) и не обязателен: базовые функции записи и работы с данными работают и без него.

• Любые разрушающие изменения от агентов проходят через цикл «предложение → подтверждение → применение».

Лицензия

MIT