Files
openwiki-wiki/quickstart.md
T
2026-08-02 02:22:26 +08:00

5.3 KiB

Robin's Local Knowledge Base

This is Robin's personal OpenWiki — a local, growing knowledge base that synthesizes notes, recurring themes, open questions, commitments, and personal logistics from configured sources.

What this wiki is

  • Personal brain — durable notes about Robin's life, work, people, projects, and recurring patterns.
  • Synthesis layer — OpenWiki connector ingestion writes raw data under ~/.openwiki/connectors/<connector>/raw; this wiki is the opinionated, deduplicated map on top of that evidence.
  • Living document — pages evolve as new connector data lands. Each update run reviews open-questions.md and refreshes the relevant canonical pages.

How this wiki is organized

Page Purpose
/quickstart.md This page — orientation, navigation, status.
/open-questions.md Unresolved questions about Robin's memory/wiki. Active, Answered, Stale.
/themes.md Recurring topics and signals index — terse table.
/commitments.md Work tasks, follow-ups, approvals, scheduled items.
/personal-logistics.md Personal errands, appointments, travel, life admin.
/sources/ Per-connector evidence indexes (one page per active connector).

Current status

  • Wiki state: initialized — Hacker News, the local Obsidian vault, and Tavily web search are active and feeding /sources/hackernews.md, /sources/git-repo.md, /sources/web-search.md, and /themes.md.
  • Connectors: Hacker News, git-repo, and web search active. Gmail, Slack, Notion, and X are not yet configured — see "Adding sources" below.
  • Last update: see /.last-update.json — the latest source run is git-repo (obsidian-robin-1 2026-08-01 18:10 UTC). Vault HEAD remains 1a81e485 with no new commits or newly observed working-tree paths, so no canonical synthesis pages changed. The preceding HN-only run (hackernews-1 2026-08-01 18:00) was a second consecutive empty pull: feeds: [] and queryResults: [] — connector completed normally at fetchedAt: 2026-08-01T18:04:23.983Z with no items. Per the prior run's "if the next pull is also empty, check HN connector config" note, the next scheduled run should check ~/.openwiki/connectors/hackernews/config.json and Algolia / HN API status before continuing to schedule the lane. No theme row Last-seen was refreshed (zero in-scope evidence); the source-backed rows (class-organoid-3d-bioprinting, hermes-agent-v0-19-quicksilver, agent-memory-architecture, china-cde-cell-gene-therapy-rules-2026, china-order-no-818-clinical-translation, MiniMax-m3) keep their 2026-07-30 / 2026-07-29 Last seen. No new commitments, no new open questions, no new personal-logistics items. The prior multi-connector run (2026-07-31 cycle covering HN + web-search + git-repo) remains documented on /sources/hackernews.md as the previous empty pull; previous material-evidence run was the 2026-07-30 cycle documented on /sources/web-search.md pull 7.

How to use this wiki

  • Ask questions about the wiki — Robin can ask things like "what's on my plate this week?" or "what recurring themes have you noticed?" and answers come from these pages first.
  • Update on demandopenwiki personal opens the personal chat; openwiki personal --update "<message>" ingests configured connectors and refreshes synthesis pages.
  • Trust labels — facts use confirmed, source-backed, watchlist, or saved-context so Robin can see how solid each claim is.

Adding sources

When Robin is ready, configure connectors to start populating the wiki:

  • Gmailopenwiki auth google (needs Google OAuth refresh token)
  • Slackopenwiki auth slack (needs Slack user token with search:read for definitive self-message search)
  • Notion — configure Notion MCP via ~/.openwiki/connectors/notion/
  • X / Twitteropenwiki auth x (needs OPENWIKI_X_ACCESS_TOKEN)
  • Web Search — set TAVILY_API_KEY (active; see /sources/web-search.md)
  • Hacker News — public feeds, no auth needed
  • Local git repo — point the git-repo connector at a repo path

Auth instructions and env var names live in the OpenWiki operations docs and ~/.openwiki/skills/write-connector.md.

Backlog

Deferred until Robin configures connectors or asks for specific documentation:

  • Gmail evidence index/sources/gmail.md (no Gmail connector configured yet)
  • Slack evidence index/sources/slack.md (no Slack connector configured yet)
  • Notion evidence index/sources/notion.md (no Notion MCP configured yet)
  • X / Twitter evidence index/sources/x.md (no X connector configured yet)
  • Hacker News evidence index/sources/hackernews.md (active; last refreshed 2026-08-01 18:00 UTC)
  • Web search evidence index/sources/web-search.md (active; last refreshed 2026-07-29 18:03 UTC)
  • Git repo evidence index/sources/git-repo.md (active; last refreshed 2026-08-01 18:10 UTC — covers Robin's Obsidian vault)
  • Project / people / company pages — only created when durable entities emerge from ingested data

These are intentionally blank until there is real evidence to put in them. Populating them with placeholders would dilute the synthesis layer.