Open Knowledge Discovery

Spiega OpenKnowledge, la configurazione di ok init, la condivisione del repo e l'apertura di file markdown sciolti

di inkeep · inkeep/open-knowledge

Richiede configurazione ★ 7.6/10

Open Knowledge Discovery — Spiega OpenKnowledge, la configurazione di ok init, la condivisione del repo e l'apertura di file markdown sciolti

Cosa fa

Guida alla scoperta e all'installazione di OpenKnowledge (OK), la piattaforma di collaborazione markdown-CRDT di Inkeep: cos'è, come `ok init` configura `.ok/` e collega il server MCP più le skill dell'editor, come condividere un progetto tramite il suo repo git, cosa fanno `ok cowork` e OK Desktop, e come aprire un singolo file markdown al di fuori di qualsiasi progetto. Si attiva quando qualcuno chiede cos'è OpenKnowledge, vuole installarlo su un repository, o chiede come condividere un progetto OK con i collaboratori. Non include deliberatamente il contratto di lettura/scrittura in-project — questo viene fornito come skill separata a livello di progetto installata da `ok init`.

Rapporto di test

Recuperato SKILL.md raw (HTTP 200, 134 righe) e verificate le sue affermazioni rispetto alla fonte del repo piuttosto che fidarmi: `packages/cli/src/commands/init.ts` documenta "Scaffolds `.ok/`" più `--no-mcp` / `--skills discovery`, `cowork.ts` corrisponde all'esatta formulazione Customize → Skills → + → Create skill → Upload skill, e `get-preview-url.ts` espone realmente il parametro `file` per percorsi assoluti al di fuori di un progetto — tutto come scritto. npm `@inkeep/open-knowledge` restituisce 200 con l'ultima versione 0.35.0 (corrispondente alla versione del frontmatter della skill) e i binari `ok`/`open-knowledge`; `packages/server/src/skill-bundles.ts` mostra che `ok init` installa forzatamente questo bundle a livello utente come `open-knowledge-discovery`. Per l'output ho risposto due volte a "add OpenKnowledge to an existing repo and share it with two collaborators": la baseline ha indovinato il nome del pacchetto con incertezza dichiarata e non aveva nulla su `--no-mcp`, la skill a livello di progetto, `ok cowork`, `ok start`, o `preview_url`; la risposta della skill li ha nominati tutti correttamente. Due lacune reali: `@inkeep/open-knowledge-desktop` restituisce 404 su npm (i DMG esistono sulla pagina delle release), e la sezione di condivisione dice "commit `.ok/`" senza menzionare che `ok init` può mettere il progetto in modalità solo locale tramite `.git/info/exclude`, dove quel commit non fa nulla in silenzio finché non viene eseguito `ok config-sharing share`.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/inkeep/open-knowledge.git /tmp/open-knowledge-discovery-src
mkdir -p ~/.claude/skills
cp -R /tmp/open-knowledge-discovery-src/packages/server/assets/skills/discovery ~/.claude/skills/open-knowledge-discovery
# Or let the CLI place the same skill: npx @inkeep/open-knowledge init
# Acting on its advice needs the `ok` CLI: npm i -g @inkeep/open-knowledge (bins: ok, open-knowledge)

Comandi e prompt di esempio

  • /open-knowledge-discoverySpiega OpenKnowledge, la configurazione di ok init, la condivisione del repo e l'apertura di file markdown sciolti

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • What is OpenKnowledge and how do I install it
  • Set up ok init on this repository
  • Share this OpenKnowledge project with my team