Language: English | 简体中文

FLOWnote is an OpenCode-powered plugin for AI-assisted note management.

OpenCode is required: install OpenCode on your desktop before using FLOWnote chat, sessions, and skill workflows.

It is designed as an end-to-end workflow for:

• Capture -> Cultivate -> Connect -> Create
• Daily execution + weekly/monthly review
• Skill-driven structured writing, not generic chat only

FLOWnote is inspired by Claudian and built around the OpenCode runtime + SDK.

FLOWnote takes a different path:

• Integrates OpenCode runtime and OpenCode SDK into Obsidian
• Ships a domain-specific skill pack for knowledge workflows
• Focuses on note management loops, not just agent access

In short: this is not only "OpenCode inside Obsidian", but "OpenCode + a complete note-management skill system".

• OpenCode installed on your desktop (required): OpenCode / GitHub
• Obsidian v1.5.0+
• For mobile AI cleanup or URL resolving, configure third-party API keys as needed

• Session sidebar with persistent history
• Streaming chat responses and retry/cancel flows
• Model/provider switching and provider auth handling
• Powered by OpenCode SDK for session and tool orchestration
• Connection diagnostics for executable path, runtime mode, and startup failures

• Built-in skills are packaged in bundled-skills/
• On startup, FLOWnote syncs bundled skills into your vault skills directory (default: .opencode/skills)
• Only bundled skill IDs are enabled for execution in FLOWnote's skill menu
• Skill injection modes: summary (recommended), full, off

• One-tap capture modal to write into daily note
• Optional AI cleanup for spoken/raw text
• URL enrichment pipeline with fallback:
  • Resolver provider (choose one): TianAPI / ShowAPI / Gugudata
  • If resolver unavailable and AI configured: AI fallback
  • If no resolver and no AI key: keep plain text
• Original URL is preserved in output
• iOS keyboard avoidance fallback is included for focus visibility

FLOWnote currently bundles these skills:

• 打开
• 发送选中文本
• 新建会话
• 快速捕获想法 (mobile)

After approval, install from Community Plugins by searching FLOWnote. Before enabling FLOWnote, make sure OpenCode is installed and available on your desktop.

Put these files into:

<Vault>/.obsidian/plugins/flownote/

• main.js
• manifest.json
• styles.css

Then reload plugins in Obsidian.

1. Install Node.js on your desktop first, then run npm install -g opencode-ai to install OpenCode and verify opencode is available.
2. Open FLOWnote settings.
3. Keep CLI path empty first (auto-detect), or set explicit path if needed.
4. Choose launch strategy (auto / native install). WSL is no longer supported on Windows.

Even when mainly using mobile capture, FLOWnote still requires OpenCode installed on desktop.

1. Configure AI provider (or custom OpenAI-compatible endpoint).
2. Configure URL resolver provider and key if link parsing is needed.
3. Set daily note path and idea section header.

• FLOWnote itself does not require a separate FLOWnote account.
• Third-party AI or URL resolver usage requires user-provided credentials.

• Plugin state is stored in plugin data.json (Obsidian standard behavior).
• Capture output is written to user notes (for example, daily notes).

• No standalone telemetry/analytics pipeline is implemented by FLOWnote.
• Debug logs are local console output and controlled by debugLogs.

• AI endpoints (examples):
  • api.deepseek.com
  • dashscope.aliyuncs.com
  • api.moonshot.cn
  • open.bigmodel.cn
  • api.siliconflow.cn
  • user-defined custom endpoint
• URL resolver endpoints:
  • apis.tianapi.com
  • route.showapi.com
  • api.gugudata.com
• Local runtime communication to OpenCode service on local machine

• FLOWnote plugin itself is free.
• Third-party APIs may charge by their own pricing plans.

npm run ci
npm run build:release
npm run check:submission

Release assets are generated in release/:

• release/main.js
• release/manifest.json
• release/styles.css

• Thanks OpenCode for the runtime and SDK foundation.
• Thanks Obsidian for the plugin API.

FLOWnote is distributed under the MIT License.