dotstell

Your knowledge is scattered. Dotstell connects it.

Capture · Connect · Ask

Notes · People · Tasks · Bookmarks · Wikilinks · Knowledge Graph · Meetings · Voice dictation · AI Chat & Writing · MCP server · Import & Export · Local Ollama

Website · Live App · Releases · Report a bug · Request a feature · Contact

What is Dotstell?

Dotstell is an open source personal knowledge graph — a single place to write notes, track people, manage tasks, save bookmarks, and connect all of them together through a visual graph. With a built-in AI layer that understands your entire knowledge base.

Most productivity tools are built around capture. Dotstell is built around connection — and now, conversation.

Capture your ideas, meeting notes, and research. Connect them to people, tasks, and bookmarks — building a knowledge graph that grows with you. Ask an AI that answers from your own notes, not the internet — chat, get person intelligence, generate writing, and discover what you already know.

*Everything you write, everyone you know, everything you do — all linked in one living knowledge graph. Now with AI that understands all of it.*

The question it answers that other tools don't:

*"What do I know about this person, this project, this decision — right now, in full context?"*

Support the project

Dotstell is free, self-hostable, and built in the open. If it saves you time or you believe in what we're building:

• [Star the repo](https://github.com/dotstell/dotstell/stargazers) — the single most useful thing you can do. It helps others find Dotstell and tells us the work is worthwhile.
• [Open an issue](https://github.com/dotstell/dotstell/issues) — bug reports and feature requests shape what gets built next.
• [Contribute code](CONTRIBUTING.md) — all skill levels welcome; see the contributing guide.
• Share it — tell someone who needs a better way to organise their work.

Every star, issue, and PR genuinely matters for an early-stage OSS project.

Features

Capture

Connect

Ask

Yours to keep

Screenshots

Live previews of the app are available on dotstell.com — the landing page includes an interactive knowledge graph, dashboard mockup, and feature walkthroughs.

Try the live app at dotstell.app or download the desktop build for Windows, macOS and Linux.

Getting Started

Prerequisites

• Node.js 20.9+
• pnpm — npm install -g pnpm

We use pnpm instead of npm/yarn because it is significantly faster (hard-linked global store, no re-downloading the same package twice), produces a deterministic pnpm-lock.yaml, and is required by the Tauri CLI toolchain used for the desktop build. The lockfile is committed — always use pnpm install, not npm install, to keep the lockfile consistent.

• A free Supabase account

1. Clone

git clone https://github.com/dotstell/dotstell.git

cd dotstell

2. Install dependencies

pnpm install

3. Set up Supabase

1. Create a new project at supabase.com
2. Go to SQL Editor and run supabase/schema.sql to create all tables, policies, and triggers.

That one file is all a new project needs. For an existing database, apply any migrations you have not run yet, in order:

supabase/migrations/

├── add_notebooks_table.sql ├── add_notes_soft_delete.sql ├── 002_bookmarks_enhancements.sql ├── 003_bookmark_visits.sql ├── 004_notes_parent.sql ├── 005_notes_sort_pin.sql ├── 006_notes_color.sql ├── 007_notebooks_constraints.sql ├── 008_ai_embeddings.sql ← vector(768) columns on notes + bookmarks (AI semantic search) ├── 009_ai_match_functions.sql ← pgvector cosine similarity RPC functions ├── 010_tasks_embedding.sql ← vector(768) column on tasks + match_tasks() (tasks in AI Chat RAG) ├── 011_fix_function_search_paths.sql ├── 012_mcp.sql ← MCP tokens and the read-only functions behind the MCP server └── 013_data_api_grants.sql ← explicit table grants (needed on new Supabase projects from 30 Oct 2026; safe to run on any)

1. Copy your project URL and anon key from Settings → API

4. Configure environment

cp .env.local.example .env.local

Edit .env.local:

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co

NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

Behind a corporate SSL proxy? Add NODE_TLS_REJECT_UNAUTHORIZED=0 to your .env.local. Do not set this in production.

5. Run

pnpm dev

Open http://localhost:3000, create an account and start connecting your knowledge.

AI Features

Dotstell ships a complete AI layer. All features work with five provider options:

AI features:

• Meeting assistant — paste or upload a Zoom, Teams or Meet transcript (or record the meeting) and get a summary, decisions and action items; turn action items into linked tasks
• Voice dictation — *Fast* (your browser, with spoken punctuation and automatic capitals, English) or *High accuracy* (your own OpenAI, Groq or Gemini speech key, with punctuation and capitals from the model); both work on phones
• Connect AI tools (MCP server) — let Codex, Claude Code, Cursor and Claude Desktop read your notes, bookmarks, tasks, people and meetings with a revocable, read-only token (see docs/MCP.md)
• AI Writing Assistant — draft notes from scratch using 8 starter templates (Outline, Meeting notes, Daily log, Research note, OoO email, Proposal, Status update, Email draft) or a custom prompt; improve existing notes with one-click actions (Improve English, Make formal, Make concise, Expand, Full rewrite)
• AI Chat — slide-out panel with RAG (semantic search grounds answers in your notes, bookmarks, and tasks), "This note" and "All knowledge" modes, People tab for person intelligence
• Inline Assist — select text → rewrite / expand / shorten / fix grammar / outline / checklist / explain
• Smart title & auto-tags — suggest a title and up to 5 relevant tags as you write
• Note & bookmark summaries — on