openwiki-wiki/quickstart.md

# 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](/quickstart.md) | This page — orientation, navigation, status. |
| [/open-questions.md](/open-questions.md) | Unresolved questions about Robin's memory/wiki. Active, Answered, Stale. |
| [/themes.md](/themes.md) | Recurring topics and signals index — terse table. |
| [/commitments.md](/commitments.md) | Work tasks, follow-ups, approvals, scheduled items. |
| [/personal-logistics.md](/personal-logistics.md) | Personal errands, appointments, travel, life admin. |
| [/sources/](/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](/.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 demand** — `openwiki 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:

- **Gmail** — `openwiki auth google` (needs Google OAuth refresh token)
- **Slack** — `openwiki auth slack` (needs Slack user token with `search:read` for definitive self-message search)
- **Notion** — configure Notion MCP via `~/.openwiki/connectors/notion/`
- **X / Twitter** — `openwiki auth x` (needs `OPENWIKI_X_ACCESS_TOKEN`)
- **Web Search** — set `TAVILY_API_KEY` (active; see [/sources/web-search.md](/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.