How It Works
xNotePadAI is a private AI-powered knowledge workspace. Everything runs in your browser with zero-knowledge encryption, AI intelligence, and no tracking.
AI Actions
Open the AI Chat panel and click 🧠 Actions ▾ to run intelligent operations on your notes:
Actions work on selected text or the entire note. Results replace content (rewrite/translate) or append at the bottom (summarise/tasks/key points).
Agent Mode
Prefix your chat with agent: for multi-step AI operations across your notebook:
"agent: organise my project notes with tags and links"
- • AI proposes a set of actions (tag, link, create, rename, star, archive, merge)
- • Mandatory diff approval — all AI changes shown as a diff before applying
- • Schema validation — malformed AI plans are rejected before execution
- • Click Execute All to confirm, or Cancel
- • Full undo available — an ↩️ Undo toast appears after every bulk action
Note Linking & Backlinks
Link notes together with wiki-style syntax:
See also [[Project Plan]] and [[Meeting Notes]] - • Links become clickable in Markdown preview
- • Click a link to navigate to that note (or create it if it doesn't exist)
- • Backlinks panel — see which notes reference the current note
- • 🕸️ Graph View — visual SVG force-directed graph of all connections
Semantic Search
Two search modes in the AI Chat panel:
- • find: prefix — instant keyword-weighted search across all notes with clickable results
- • Normal chat — full semantic search via Vectorize embeddings (searches by meaning, not just exact words)
AI responses include clickable citations — note titles mentioned in answers link directly to the source note.
Timeline View
Click 🕐 Timeline in the toolbar for a chronological view of your notes:
- • Vertical timeline with clickable note nodes
- • Dates extracted from note content and metadata
- • Click any node to open that note
- • AI can answer "Show me the history of [topic]" using timeline data
Related Notes & Auto-Link Suggestions
xNotePadAI automatically detects relationships between your notes:
- • Link suggestions — when your note mentions another note's title, a suggestion bar appears
- • One-click linking — click to insert a [[wiki-link]] automatically
- • Related notes sidebar — shows similar notes while you're editing
- • Duplicate detection — fuzzy title + content similarity scoring flags potential duplicates
Templates
Click + to create a new note and choose from 11 quick-start templates:
Tags & Smart Collections
Organise notes with tags and automatic filters:
- • Tags — add/remove tags per note, coloured pills in sidebar, filter by tag
- • Auto-Tagging — AI suggests 2-4 tags for untagged notes after 10 seconds
- • Smart Collections — one-click filters: This Week, Has Tasks, Has Attachments, Starred
- • ⭐ Star — favourite important notes, filter to starred only
Tasks Panel
Click ☑️ Tasks in the toolbar to see all tasks across every note:
- • Scans all notes for
- [ ]and- [x]items - • Groups by pending/completed
- • Click any task to jump to its source note
- • AI "Extract tasks" action automatically creates checkboxes from prose
Auto-Expiring Notes
Click ⏱️ Expiry to set a self-destruct timer on any note:
- • Choose expiry: 1 hour, 6 hours, 24 hours, 7 days, or 30 days
- • Choose action: Archive (safe — moved to archive) or Delete (permanent)
- • Countdown indicator shows remaining time in the sidebar
- • Expired notes are cleaned up automatically on page load + every 60 seconds
- • Shared links for expired notes also stop working (410 Gone)
- • RAG vectors are cleaned up when notes expire
- • Remove expiry at any time to keep the note permanently
Note Reordering
Customise the order of notes in your sidebar:
- • ▲ / ▼ arrows — hover over any note to see move buttons (top-left / bottom-right)
- • Drag and drop — grab any note tile and drag it to a new position
- • Custom order persists across sessions (stored in localStorage)
- • Default sort: most recently updated first (until you manually reorder)
Notebook Health
Click 💚 Health for a full dashboard of your notebook's organisation:
Score %
Health
Orphans
Unlinked
Broken
Dead links
Topics
Clusters
Includes Knowledge Intelligence: topic clustering, relationship suggestions, timeline, and duplicate detection. Click ✨ Optimise to auto-tag and fix broken links.
Sharing & Publishing
Click 🔗 Share to generate a read-only link:
- • Unlisted — accessible only via link (not indexed by search engines)
- • Public — searchable and indexable
- • Password-protected — viewers must enter a password to see content (verified server-side, never in page source)
- • Expiring links — set links to auto-expire after 1, 6, 12, 24, or 48 hours
- • Comments — viewers can leave comments on your shared note
- • Suggest edits — viewers can submit change suggestions for your review
- • Duplicate to notebook — readers can copy the note to their own xNotePadAI with one click
- • Shared notes render at
/n/[id]/with Markdown formatting - • One-click copy link, unshare at any time
- • No one can edit your shared note — read-only always
Multi-Device Encrypted Sync
Your notes sync across devices — encrypted end-to-end:
- • Auto-sync — pushes every 60 seconds when changes are detected
- • Encrypted blobs — server stores only encrypted data (zero-knowledge)
- • Conflict detection — checksums compared before overwriting
- • Conflict resolution — choose Keep Local, Keep Remote, Save Both, or Cancel
- • Save Both — keeps both versions, tags conflicts with
sync-conflictfor easy filtering - • SHA-256 checksums — cryptographic change detection prevents data loss
- • Sync indicator — ☁️ shows status (✓ synced / ↻ syncing / ⚠️ conflict)
- • Offline queue — failed operations retry automatically when back online
Encrypted Backup
Click 🔐 Backup for portable encrypted backups:
- • Export — AES-256-GCM encrypted
.xnotefile (PBKDF2 600K iterations) - • Import — decrypt with password, choose to Replace or Merge with existing notes
- • Includes all notes + archived notes in one file
- • Zero-knowledge — password never leaves your browser
Attachments
Click 📎 Attach to add files to any note:
- • Images, PDFs, documents (up to 25MB via R2, 2MB locally)
- • Inline image preview in the attachment strip
- • Click to download, ✕ to remove
- • Falls back to localStorage if cloud storage unavailable
Import
Import notes from anywhere:
Batch import multiple files at once. All imported notes are auto-tagged with "imported".
Voice Intelligence
- • 🎙️ Dictation — speech-to-text via Web Speech API (Chrome/Edge)
- • 🔊 Reader — reads notes aloud with text-to-speech
- • AI Structuring — after long dictation (100+ chars), AI offers to structure the transcript into headings, bullet points, tasks, and summary
Pomodoro Timer
Built-in work/break timer with productivity tracking:
- • Configurable work time (15/30/45/60 min) and break time (5-30 min)
- • Sound notifications (Chime, Bell, Ping, Gentle)
- • Countdown persists across page refresh
- • Session history with 7-day chart (📊 icon)
- • Work-life balance warning after 1 hour
PWA & Offline
- • Installable — add to home screen on any device
- • Offline first — works without internet after first load
- • Service worker — caches pages, falls back when offline
- • Auto-queue — sync operations queue while offline, execute on reconnect
Auto-Save & Version History
Every 2 seconds after typing stops, your note saves. A version snapshot is created every 10 saves.
5
versions kept
Diff
line-by-line compare
Restore
one-click revert
Encryption
AES-256-GCM encryption with PBKDF2 key derivation (600K iterations):
- • Password-protected lock screen
- • Auto-lock timer (1-120 minutes)
- • Zero-knowledge — we can never read your notes
- • Change password (re-encrypts all notes)
- • No recovery — forgotten password = permanent loss
- • Error recovery — auto-detects corrupted stores and restores from backup
Rich Text & Markdown
22-option formatting toolbar + side-by-side Markdown preview (Ctrl+Shift+M):
AI Chat
Click 🤖 Chat to open the inline AI panel:
- • Ask questions about your notes ("What did I write about...?")
- • Dynamic prompts — 5 contextual example questions refresh based on your current note
- • Prefix
find:for instant keyword search - • Prefix
agent:for multi-step operations - • Responses include clickable note citations
- • Content marked 🔒 CONFIDENTIAL is automatically excluded
- • Powered by Llama 3.3 70B + Vectorize RAG
MCP Server (AI Agent API)
13-tool MCP server for AI agents — give your AI persistent, private memory.
Endpoint
POST /api/mcp/ Protocol
JSON-RPC 2.0 over HTTP
Auth
Bearer <token> Rate limit: 30 req/min per IP. Free tier: 1,000 calls/month. Agent-created notes sandboxed with agent-created tag. Get your token in Settings.
Export
- • Download as .txt or .pdf
- • Export all notes as .zip (with CRC32 checksums)
- • Encrypted .xnote backup
- • Copy to clipboard
- • Email note via mailto:
- • Drag & drop import
Security & Privacy
- • No cookies — no tracking cookies of any kind
- • No analytics — no Google Analytics, no telemetry
- • No server storage — notes live in your browser only (sync is opt-in + encrypted)
- • CSP headers — Content Security Policy restricts all external requests
- • Data-loss guard — refuses to save empty store over existing notes
- • Offline-first — works without any network connection
- • Undo for bulk actions — snapshot before Agent/Optimise, 15s undo window
Keyboard Shortcuts
Accessibility
- • Skip-to-content link on every page
- • WCAG AA contrast (4.5:1 minimum)
- • All icon buttons have aria-labels
- • Full keyboard navigation
- • Focus indicators (green + purple outlines)
- • Mobile responsive with collapsible sidebar
- • Screen reader friendly semantic HTML