okfshare CLI и MCP-сервер

Клиентская часть okfshare с открытым исходным кодом: общие версионируемые знания для ИИ-агентов, которые пишут код.

Опубликуйте валидированный пакет Markdown один раз. Каждый авторизованный агент работает с одной и той же неизменяемой ревизией и цитатами на уровни строк, которые можно проверить. Размещённый сервис хранит ревизии, цитаты и аутентификацию рабочих пространств; в этом репозитории находятся инструменты, которые агенты реально запускают.

Пакеты

Related MCP server: 50 First Tapes MCP Server

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

# 1. One-time onboarding (device pairing in your browser)
npx okfshare@latest setup

# 2. Validate and publish a folder of Markdown
npx okfshare@latest validate ./knowledge
npx okfshare@latest publish ./knowledge --visibility public --yes

# 3. Any teammate's agent retrieves cited context
npx okfshare@latest context SHARE_ID "how do we handle db migrations"

Для headless/CI-окружений укажите заранее подготовленные учётные данные через переменную окружения OKFSHARE_TOKEN (только проверяйте, что переменная существует, никогда не логируйте её), затем выполните проверку с помощью whoami и doctor.

Настройка MCP

claude mcp add okfshare -- npx @okfshare/mcp@latest

Или для любого MCP-клиента:

{
  "mcpServers": {
    "okfshare": {
      "command": "npx",
      "args": ["@okfshare/mcp@latest"]
    }
  }
}

Инструменты: whoami, doctor, list_shares, search_share, search_workspace, get_context, pull_bundle, publish_bundle. Манифест реестра: server.json.

Почему цитаты важны

Поиск возвращает файл, точные строки и неизменяемую ревизию, из которой они взяты. Когда агент утверждает: «наша договорённость говорит X», вы можете проверить это за секунды — и цитата будет означать то же самое и завтра, потому что содержимое ревизии никогда не изменяется на месте.

Формат Open Knowledge

Пакеты — это Markdown со структурированным frontmatter: type, title, description, tags, sources и события верификации. Формат намеренно небольшой и остаётся читаемым в любом редакторе. В худшем случае у вас останутся просто файлы — без привязки.

• Спецификация: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

• Практическое руководство (опубликовано вместе с самим okfshare): https://okfshare.app/s/ecf08367a22273482c0887ca8700ee8e

• Стартовый набор соглашений для форка: https://okfshare.app/s/e8ddeda5aab619495c970f031dce7058

Разработка

pnpm install
pnpm check   # typecheck + test + build across all packages

• Node 20+ и pnpm 10.

• Пакеты обращаются к API на размещённой стороне сервиса https://okfshare.app; для разработки локальный сервер не требуется.

• Инструкцию по приёмке изменений см. в CONTRIBUTING.md, информацию о сообщении об уязвимостях — в SECURITY.md.

Ссылки

• Сайт и документация: https://okfshare.app

• Документация для агентов: https://okfshare.app/llms.txt и https://okfshare.app/llms-full.txt

Лицензия

Apache-2.0. См. NOTICE — лицензия на код не даёт прав на имя okfshare или его бренд.