okfshare CLI y servidor MCP

La mitad de código abierto y del lado del cliente de okfshare: conocimiento compartido y versionado para agentes de programación con IA.

Publica un paquete validado de Markdown una sola vez. Cada agente autorizado trabaja con la misma revisión inmutable, con citas a nivel de línea que puedes auditar. El servicio alojado conserva las revisiones, las citas y la autenticación del espacio de trabajo; este repositorio contiene las herramientas que tus agentes ejecutan realmente.

Paquetes

Related MCP server: 50 First Tapes MCP Server

Inicio rápido

# 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"

Entornos headless/CI: proporciona una credencial preaprovisionada mediante la variable de entorno OKFSHARE_TOKEN (comprueba solo su existencia; nunca la registres) y luego verifica con whoami y doctor.

Configuración de MCP

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

O con cualquier otro cliente MCP:

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

Herramientas: whoami, doctor, list_shares, search_share, search_workspace, get_context, pull_bundle, publish_bundle. Manifiesto del registro: server.json.

Por qué las citas importan

La recuperación devuelve el archivo, las líneas exactas y la revisión inmutable de la que proceden. Cuando un agente afirma "nuestra convención dice X", puedes auditar la afirmación en cuestión de segundos, y una cita significa lo mismo mañana porque el contenido de una revisión nunca se cambia.

/a el lugar. El contenido de la revisión nunca se modifica en su lugar.

El Open Knowledge Format

Los paquetes son Markdown con frontmatter estructurado: un type, título, descripción, etiquetas, visión, fuentes y eventos de verificación. El formato es deliberadamente pequeño y sigue siendo legible en cualquier editor. En el peor caso, te quedas con archivos simples, sin dependencia de proveedor.

• Especificación: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

• Guía de campo (publicada con el propio okfshare): https://okfshare.app/s/ecf08367a22273482c0887ca8700ee8e

• Plantilla inicial de convenciones bifurcable: https://okfshare.app/s/e8ddeda5aab619495c970f031dce7058

Desarrollo

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

• Node 20+ y pnpm 10.

• Los paquetes se comunican con la API alojada en https://okfshare.app; para desarrollarlos no se requiere un servidor local.

• Consulta CONTRIBUTING.md para conocer el flujo de aceptación y SECURITY.md para informar vulnerabilidades.

Enlaces

• Sitio y documentación: https://okfshare.app

• Documentación legible por agentes: https://okfshare.app/llms.txt y https://okfshare.app/llms-full.txt

Licencia

Apache-2.0. Consulta NOTICE: la licencia de código no otorga derechos sobre el nombre de okfshare ni su marca.