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 (`hackernews-1`, LLM agent topics) and the local Obsidian vault (`obsidian-robin`) are both active and feeding `/sources/hackernews.md`, `/sources/git-repo.md`, and `/themes.md`.
- **Connectors:** Hacker News and git-repo active. Gmail, Slack, Notion, X, and web search are not yet configured — see "Adding sources" below.
- **Last update:** see [/.last-update.json](/.last-update.json) — this run was a Hacker News (`hackernews-1`, LLM agent topics) source-specific update.

## 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`
- **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; refreshed in this run)
- **Web search evidence index** — `/sources/web-search.md` (no web search configured yet)
- **Git repo evidence index** — `/sources/git-repo.md` (no local repo wired up yet)
- **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.