Skip to content
Back to search

cowiki

LLM Wiki, but multiplayer

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wfnuser--cowiki/badge.svg)](/listings/wfnuser--cowiki)

HTML

<a href="/listings/wfnuser--cowiki"><img src="/api/listings/wfnuser--cowiki/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 126 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="web/public/cowiki-logo.svg" width="88" alt="CoWiki logo" />
  3. </p>
  4. <h1 align="center">CoWiki: An LLM Wiki, but multiplayer.</h1>
  5. <p align="center">
  6. <strong>Product philosophy / 产品理念</strong>
  7. <br />
  8. <a href="https://x.com/weiraolilun/status/2078748340813189471">Read the original thread on X</a>
  9. ·
  10. <a href="https://www.xiaohongshu.com/explore/6a57ae3100000000070229aa?xsec_token=AB3r79vLLhY9g4EOR2V9GfBSUNgWPYIsJJYs7GQ4DsmaI=&amp;xsec_source=pc_user">阅读小红书原文</a>
  11. </p>
  12. <p align="center">
  13. <a href="https://github.com/wfnuser/cowiki/actions/workflows/macos-desktop.yml"><img src="https://img.shields.io/github/actions/workflow/status/wfnuser/cowiki/macos-desktop.yml?branch=dev&label=macOS%20build" alt="macOS build" /></a>
  14. <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-EF5A29" alt="Apache 2.0 license" /></a>
  15. <a href="docs/okf-v0.1.md"><img src="https://img.shields.io/badge/OKF-v0.1-EF5A29" alt="Open Knowledge Format v0.1" /></a>
  16. <a href="https://github.com/wfnuser/cowiki"><img src="https://img.shields.io/github/stars/wfnuser/cowiki?style=flat&color=EF5A29" alt="GitHub stars" /></a>
  17. <a href="https://github.com/wfnuser/cowiki/issues"><img src="https://img.shields.io/github/issues/wfnuser/cowiki?color=6B625C" alt="Open issues" /></a>
  18. <a href="https://github.com/wfnuser/cowiki/graphs/contributors"><img src="https://img.shields.io/github/contributors/wfnuser/cowiki?color=6B625C" alt="Contributors" /></a>
  19. </p>
  20. <p align="center">
  21. <img src="docs/assets/cowiki-desktop.png" alt="CoWiki reviewing local Markdown changes beside an embedded Claude Code terminal" />
  22. </p>
  23. <p align="center">
  24. <strong>A local-first, Git-based workspace where teams and their agents compile sources into a portable, reviewable, and shareable LLM Wiki.</strong>
  25. <br />
  26. <sub>Bring your own agents. Turn files and URLs into linked OKF knowledge, review every diff, and keep only what you trust.</sub>
  27. </p>
  28. > **macOS-first alpha:** local Spaces work today. Cloud collaboration comes next.
  29. ## Features
  30. | Feature | What it means |
  31. | --- | --- |
  32. | **Local Spaces** | A Space is an ordinary folder. No account, server, or external database is required. |
  33. | **Agent-compiled Wiki** | Add URLs, PDFs, documents, spreadsheets, or slides. Agents compile them into structured, linked knowledge. |
  34. | **Bring your own agents** | Use the built-in Codex and Claude terminals, or let Grok, Antigravity, and other file/MCP-capable agents work on the same Space. |
  35. | **Git-based review** | Inspect human and agent edits as diffs, then merge, discard, commit, or checkpoint them. |
  36. | **OKF-native** | CoWiki follows [Google's Open Knowledge Format v0.1](docs/okf-v0.1.md), keeping knowledge readable, linked, and portable. |
  37. | **Collaboration-ready** | The same local Space can later gain cloud publishing, permissions, and team review. |
  38. ## Ingest. Compile. Review.
  39. <p align="center">
  40. <img src="docs/assets/compilation-pipeline.svg" alt="Ingest, compile, lint, and review pipeline" width="100%" />
  41. </p>
  42. Drop source material into a Space. Your agents compile it into linked OKF
  43. knowledge, check its structure, and return a Git diff for human review. Keep
  44. the result, continue editing it, or discard the change as a unit.
  45. ## Your Space is a folder
  46. ```text
  47. research-space/
  48. ├── index.md
  49. ├── architecture.md
  50. ├── projects/
  51. │ └── cowiki.md
  52. ├── .cowiki/
  53. │ └── sources/
  54. └── .git/
  55. ```
  56. Markdown and Git are the source of truth. SQLite only stores a rebuildable
  57. local search and backlink index. You can open the same files in another
  58. editor, use normal Git tools, or leave CoWiki without exporting anything.
  59. CoWiki aligns Spaces with [Open Knowledge Format v0.1](docs/okf-v0.1.md) and
  60. preserves frontmatter fields it does not understand.
  61. ## Local-first, collaboration-ready
  62. CoWiki is local-first, not local-only. Today the desktop app keeps a complete
  63. offline Space and supports local human–agent review. The next layer will let
  64. you publish that same Space for team permissions, browser access, asynchronous
  65. review, and reusable remote MCP—without changing its portable source format.
  66. ## Run from source
  67. Requires macOS, Xcode Command Line Tools, [Node.js 24+](https://nodejs.org/),
  68. and [Rust stable](https://rustup.rs/). Install Codex CLI and/or Claude Code to
  69. use the embedded Agent panel.
  70. ```bash
  71. git clone https://github.com/wfnuser/cowiki.git
  72. cd cowiki/web
  73. npm ci
  74. npm run desktop:dev
  75. ```
  76. Create a Space with an empty local folder, or import an existing folder of
  77. Markdown files. The desktop app runs as a complete standalone workspace.
  78. Agents launched by the app receive CoWiki's read-only local MCP for retrieval
  79. and edit the Space's Markdown files directly. The
  80. [`cowiki-space` skill](skills/cowiki-space/SKILL.md) defines the same contract
  81. for external Agents; local work never requires a CoWiki account, API key, or
  82. backend.
  83. Before launch, the Agent panel checks the selected local CLI in the user's login
  84. shell environment and delegates authentication to that CLI, so CoWiki never
  85. reads or stores Agent credentials. Available Agents start in the Current Draft.
  86. ## Roadmap
  87. - Make the macOS alpha easier to install and trust.
  88. - Improve local review and conflict resolution for many agents.
  89. - Publish local Spaces for team permissions, sync, and browser review.
  90. - Offer compatible remote MCP and expand desktop platform support.
  91. ## Contributing
  92. CoWiki is early, and the collaboration model is still an open design problem.
  93. Issues, product criticism, experiments, and code are welcome. See
  94. [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
  95. ## License
  96. CoWiki is licensed under the [Apache License 2.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.