Help

Short guides for each module. Markdown in your Obsidian vault is the durable source of truth; this app is a command layer on top.

Overview

Use the sidebar (or top pills) to move between modules. Most features write plain Markdown notes your vault can open decades from now — no proprietary blobs.

Tasks live in Turso only. Ideas still live as notes under 10_Personal/.
Agent chat (message icon) can create/update tasks and ideas with tools.
Timezone for dates is Asia/Hong_Kong.

Home & Tasks

Home / Tasks is your Managing Tasks board: overdue, today, without due date, next 7 / 30 days (excluding today), created today, and done.

Quick Create Notes — enter a title and create immediately. People, priority, and due date are optional; open the row later to fill them in.
Open lists sort by priority (urgent → high → medium → low), then by due date (earliest first).
Done list sorts by done date only (newest first). No due-date column; titles are not struck through.
Click a title to edit the note. Checkbox toggles done / not done. Done view can permanently delete a task from Turso. Renaming a task updates the note heading and the Turso row together.
Column filters — click People, Priority, or Project in the list header (or the matching buttons on mobile) to select one or more values. The list shows tasks that match any selected person, priority, and project together. Clear a chip or use Clear filters to reset.
New tasks get a Markdown note stored in Turso, with YAML frontmatter and - [ ] checkboxes. Dropbox and Obsidian are not used for this board.

Notes storage

The notes board stores each task, including the Markdown body, in Turso. Creating, editing, ticking done, and deleting no longer read or write Dropbox or Obsidian.

Ideas, Links, Meetings, YouTube history, and 2nd-Brain still use the vault.

An external bot can manage these notes with POST /api/grok-webhook. Send header x-webhook-secret (or Authorization: Bearer) matching GROK_WEBHOOK_SECRET. JSON action is create, query, search, complete, or update. Update can set due_date, priority, and add, remove, or replace people and projects. A text or message field is parsed into the same actions. Success replies are Markdown.

Ideas Pool

Capture brain dumps (WhatsApp / WeChat / Email / Manual). Notes live under 10_Personal/IdeaInbox/. Review newest first; convert to a task, save as reference, or mark done. Files remain the source of truth in Obsidian.

Idea types — General (default), AI, Projects, plus any custom types you add. Stored as idea_type in frontmatter.
Filter each list (Pending / Mark done / Reference / Deleted) by type chips to show only that type.
Change type on a card anytime, or pick it when capturing / quick creating.

2nd-Brain

Compiles active inbox material into a linked wiki under 20_Wiki/. Full contract: SECOND_BRAIN.md in the repo.

Ingest — reads active 00_Inbox/ Markdown (not archive / hold), updates sources · entities · concepts, then archives the source. PDF, DOCX, XLSX, PPTX, and TXT need Convert first (sibling .md, then review, then ingest).
Query — ask questions; answers cite [[wikilinks]] from the wiki (not model memory alone).
Lint — health check (dead links, orphans, index drift); report-only unless you ask to fix.
On localhost, Local vs Cloud vault toggle is available (disk path vs Dropbox API).

YouTube Summarizer

Paste a video URL → summarize → browse history. Open Summary / Transcript / Highlights. Notes are stored as Markdown in 00_Inbox/youtube/ (TitleCase filenames from the video title). Held and archived folders are included in history. Video id stays in frontmatter.

Meetings (Plaud)

Connect your Plaud board, then import transcripts and AI summaries as Markdown under 00_Inbox/03-transcripts/. Those notes are what the agent and 2nd-Brain ingest read later.

Connect uses Plaud’s official OAuth (same tokens as npx -y @plaud-ai/cli login, stored in ~/.plaud/). Plaud Cloud Sync must be on.
Import writes type: transcript notes with Summary and Transcript sections. Re-import updates the same note by Plaud file id.
Ask the agent to find or read a meeting, extract action items, or turn follow-ups into tasks. Or run 2nd-Brain ingest on the inbox folder.
You can also paste a transcript if Plaud is not connected.

Email polish

Paste a draft and get three rewrites: professional, casual, and grammar. Use comment revise to refine a chosen version. Uses DeepSeek first, then Gemini (see AI providers).

Language

Two tools under Language (no LLM tokens for convert / dictionary):

Convert / Translate — Traditional ↔ Simplified via OpenCC, plus English ↔ Chinese via a free translation API. Three output cards: 繁體, 简体, English.
English Dictionary — look up a word for IPA, part of speech, definitions, examples, CEFR badge, and Traditional Chinese glosses. Audio uses Web Speech (or free MP3). Bookmark words into My Library (Turso — synced across devices). External links: Merriam-Webster, Cambridge 繁體, YouGlish.

Profile

Profile is your personal dashboard. Everything below is stored in Turso and syncs across devices:

Photo & name — paste an image URL for your avatar.
Quote — a favorite line and optional author.
Quick notes — auto-saved scratch pad.
Quick to-dos — add items and check them off (not vault tasks).
Gallery — image URLs with optional captions.
通勝 calendar — compact daily almanac on the page.

AI usage

The bottom of Profile shows a log of DeepSeek / Gemini token calls from Turso so you can spot costly features.

AI providers

Text AI features use DeepSeek first, then Gemini if DeepSeek fails or has no key: agent chat, YouTube summarize, email polish / revise, 2nd-Brain ingest/query.

Set DEEPSEEK_API_KEY from platform.deepseek.com/api_keys.
Optional AGENT_PROVIDER=auto|deepseek|gemini (default auto).
Language convert/dictionary and speech do not use LLM tokens.

File over App

Notes must stay readable without this app. Conventions for AI-written vault Markdown:

YAML frontmatter with status, type, date (AI-touched notes default to unreviewed).
Wikilinks for people and projects: [[Elvina]], [[Bryce]].
Tasks use standard checkboxes: - [ ] / - [x].
Tags stay plural: #tasks, #projects, #people, #ideas.