-
Notifications
You must be signed in to change notification settings - Fork 0
Settings Reference
Every panel in the Settings → Semantic Reading tab, top to bottom. All settings are stored in .obsidian/plugins/semantic-reading/data.json — never in vault notes.
Controls the tagbar palette and the default for notes without semantic_mode: frontmatter. 1–5; see Inline Syntax → Reading modes. Default 3.
On save, rebuild the semantic_tags: frontmatter array from inline {{Tag|text}} syntax. Inline is always the source of truth — this just maintains a cache for Dataview / search. Debounced 1.2s per file. Default on.
Where auto-generated concept hub pages live. Default Concepts. A note's path under this folder marks it as a hub, so the indexer skips it on rescan (avoids self-referential noise).
Where the auto-generated open-questions index lives. Default Questions.
On vault change, regenerate the affected hub pages. Off by default — run Cmd-P → Rebuild concept hub pages manually instead, or toggle on. Auto-rebuild is debounced 3s.
Master toggle for tag suggestion, consistency check, and synthesis. Off → no network calls at all.
Used for all AI commands. Stored in plugin data. Never written to vault.
Default claude-sonnet-4-6. Fast, cheap — for inline tag suggestion via Cmd-Shift-T.
Default claude-opus-4-7. Long-form generation for the Synthesize from vault tags… command.
Where generated documents land. Default Synthesis/.
Add tags beyond the built-in 19. Each row has:
| Field | Notes |
|---|---|
| Sigil | 1–12 alphanumerics, starts with a letter. Can't shadow a built-in. |
| Name | Required. Shown in the tagbar tooltip and view headers. |
| Family |
Anchor / Meaning / Structure / Execution. |
| Description | Free text. |
| Light color | Theme-light hex (#xxxxxx). |
| Dark color | Theme-dark hex. |
| Key | Single character. Skipped if it conflicts with a built-in binding. |
| Modes | Comma-separated 1,2,3,4,5 — which reading modes this tag appears in. |
Universal — applies to every note (unless a domain in subset/replace mode prunes the canonical set).
Import from current note: if you open a note with a semantic_tags_def: block (e.g. shared from another vault), this button adds its defs to your settings.
Per-note tag profiles. See Domain Profiles for the conceptual model. Each profile card has:
- Enabled checkbox — uncheck to hide without deleting.
-
Slug — matches
semantic_domain:frontmatter. - Label — human label for settings UI.
-
Merge mode dropdown —
add/subset/replace. -
Keep built-ins field — only shown for
subsetmode. Comma-separated sigils. - Default reading mode — optional 1–5 to set the tagbar default when this domain is active.
- Tag list — same row layout as Custom tags.
Buttons: + Add domain profile, Reset to presets (replaces all profiles with the bundled 5).
Forgets FSRS scheduling for every card. Cannot be undone.
Default http://127.0.0.1:8765. Match whatever your AnkiConnect add-on listens on.
Default Semantic Reading. Created on first sync if missing.
From readwise.io → Settings → Access Token.
Where book notes land. Used for both Readwise and Kindle. Created if missing. Default Readwise.
ISO timestamp passed to Readwise's updatedAfter parameter. Updated automatically after each successful run. Clear it (Reset button) for a full re-sync.
none (default), todoist, or things.
From Todoist → Settings → Integrations → Developer → API token.
Numeric Todoist project ID. Notes without a mapped domain land here. Leave empty for Inbox.
Things list name. Empty for Inbox.
Free-text, one mapping per line: domain = project_or_list_id. Example:
programming = 2334455667
meeting = 2334455700
Used by Things (which can't be queried). Wipes the dedup set so the next sync re-pushes every action.
Vault-relative. Default actions.ics at vault root. Subscribe to this file from Calendar.app / Fantastical / Google Calendar.
When you open a note named YYYY-MM-DD.md matching today, prepend 📚 N cards due · M open questions · K concepts. Idempotent via an HTML-comment marker. Default off.
Start an HTTP MCP server. Localhost-only. Off by default. Desktop only.
Default 8745. Change if it collides.
If set, clients must send Authorization: Bearer <token>. Empty = no auth (still localhost-only).
Copies a ready-to-paste config for Claude Desktop / Cursor / VS Code to clipboard.
The cards/sheet/gaps view (open with Cmd-P → Open cards / sheet / gaps view) has three tabs. None of them have dedicated settings — they all read from the active note and the indexer.
Per-paragraph card layout. Each card shows chips (one per tag with count) and rows grouped by CARD_GROUPS (Concepts / Relations & evidence / Limits & delays / Tensions & assumptions / Questions / Actions / Measures / Anchors).
Flat list grouped by family (Anchor / Meaning / Structure / Execution), then by sigil. Each row shows tag · text · ¶N.
Two sections: Open questions (every Q-tagged span) and Reader notes (every span with a note= annotation).