Skip to content

v1.0.0

Choose a tag to compare

View all tags
@aylusltd aylusltd released this 22 Aug 02:41
· 18 commits to main since this release
v1.0.0
ea6a3fb

First stable release. Waikiki is a small local wiki built for a human and an LLM
to edit the same page — SQLite per wiki, hybrid search, live co-editing, and an
MCP server so Claude works in the same document you do.

Install — macOS app:

brew tap VerinFast/waikiki
brew install --cask waikiki

Or download the zip below. The app updates itself from then on.

What's in 1.0

  • A wiki per file. Each wiki is one SQLite database you can copy, back up,
    or hand to someone. Wikis are fully isolated — pages, search and [[links]]
    never cross between them.
  • Live co-editing backed by CRDTs, so a human and an agent editing the same
    page merge instead of overwriting.
  • An MCP server sharing one code path with the UI: whatever Claude does to a
    page renders, versions and indexes exactly as your own edit would.
  • Hybrid search — FTS5 BM25 fused with vector similarity.
  • Agent-aware navigation. Tools report what they are not showing you, so
    an agent can tell the difference between "no such page" and "not in this
    listing" (#45–#48).
  • Typed page metadata, declared per template and reported rather than
    enforced — an invalid value is flagged, never silently rewritten (#28).
  • Doorman integration, entirely optional: when it is running, generation,
    chat, images and speech route through its agents, and Waikiki says which
    backend answered.
  • A capabilities view that tells you what this machine can do and puts a
    button on what it can't, instead of failing at the moment you click something.
  • Signed self-update. Every release is Ed25519-verified against a key pinned
    at build time before it is installed; an unverifiable download is refused.

Known limits, stated plainly

  • Apple Silicon only. An Intel build is a second pipeline, not a flag.
  • Not notarized yet (#66) — the Apple Developer portal is unavailable. Until
    it is, install with brew install --cask waikiki --no-quarantine, or
    right-click → Open the first time.
  • A page save is several transactions rather than one, so a crash at exactly the
    wrong moment can leave the canonical document a revision behind its projection
    (#72). docs/data-safety.md has the measurements, including what a hard kill
    actually costs (0 of 826 acknowledged writes) and how restore works.
  • A corrupt default wiki currently stops the app starting (#71).

Source-available under the Elastic License 2.0: use it, modify it, redistribute
it — just don't offer it to others as a hosted service.

Also on PyPI, for the half that runs anywhere Python does — the web app and the MCP server, no desktop window:

pipx install waikiki      # then: waikiki   (web)  /  waikiki-mcp   (stdio MCP)

Published via Trusted Publishing (OIDC), so no long-lived token exists to leak.

Assets 4
Loading