verified Open Source · Free Forever · MIT

Edit Private.
Think Faster.

The local-first Markdown vault with sandboxed AI orchestration for researchers, developers, and power users.

star Star on GitHub download Download v0.1.0
~12 MB
Installer
<15 MB
RAM Idle
150+
Source Files
34
Commits

Core Architecture

Built on Tauri v2 with Rust, Svelte 5, and Wasmtime.

speed
Performance

Ultra-lightweight

Zero-dependency core engine. Boot sequence under 200ms. ~12MB installer, <15MB RAM at idle.

auto_awesome
Privacy

Sandboxed AI

Your data never leaves your device. OpenAI, Claude, Gemini, Ollama — all through Wasmtime isolation.

LOCAL_ONLY SANDBOXED
account_tree
Workflow

Git Native

Version control baked in. Auto-commit on save, branching for experiments, commit history browser.

$ git commit -m "Capture thought"
api
Protocol

MCP Integration

First-class MCP client with stdio and HTTP transports. Connect GitHub, databases, and custom tools.

JSON-RPC SSE
api Protocol

Model Context Protocol

Connect ZarishNote to any MCP-compatible server — all from within the sandbox.

terminal

Stdio Transport

Spawn MCP servers as subprocesses. JSON-RPC 2.0 over stdin/stdout with streaming responses.

mcp_server.json → stdio
wifi

HTTP/SSE Transport

Connect to remote MCP servers via Server-Sent Events. Full duplex communication.

POST /mcp/messages → SSE
lock

Capability Model

Per-tool capability enforcement. Network allow-lists, filesystem scoping, resource limits.

capabilities.toml → Wasmtime

MCP Server Configuration

Configure in `.znrc` or through the Settings GUI.

description Read MCP Spec
schema Reference

Schemas & APIs

Everything is defined as code — from workspace config to plugin manifests.

settings

.znrc Schema

Workspace configuration

YAML-based workspace config defining AI providers, MCP servers, sandbox capabilities, and editor preferences.

View Schema
extension

Plugin Manifest

WASM plugin API

WebAssembly-based plugin system with capability declarations, resource limits, and marketplace integration.

View Plugin Spec
database

Knowledge Base RAG

Vector store + embeddings

Local vector store index with keyword + semantic search. Embeddings via FastEmbed, storage via in-memory HashMap (LanceDB pending).

View Knowledge Base Spec
publish

Publishing API

GitHub + Custom endpoints

One-click publish to GitHub repos, custom API endpoints, RSS feed generation, and image hosting (GitHub/Cloudflare).

View Publishing Spec
input

Ingestion Format Matrix

20+ document formats

PDF, DOCX, PPTX, XLSX, EPUB, HTML, CSV, Jupyter, YouTube, Wikipedia, RSS, SERP → Markdown via MarkItDown.

View Format Matrix
security

Security Model

Threat model + sandbox

STRIDE threat analysis, responsible disclosure policy, Wasmtime sandbox implementation with resource limits.

View Security Docs

Browse the Blueprint

39 specification documents across 7 categories.

lightbulb

Concept

Vision, personas, value proposition, glossary

Read Vision
description

Specifications

12 specs across 8 feature groups

Browse Specs
account_tree

Architecture

System design, directory layout, tech stack

View Architecture
security

Security

Threat model, security policy, sandbox

View Security
map

Roadmap

Phase 1-3 with progress tracking

View TODO
inventory_2

Assets & Prototypes

JDs, brand guidelines, .znrc examples

View Prototypes
menu_book Full Documentation Browser arrow_forward

Build Status

All CI checks passing across Linux, macOS, and Windows.

Format

cargo fmt —check

Lint

cargo clippy

Tests

8/8 pass

TypeScript

pnpm typecheck

Python

ruff lint

Spell Check

typos

open_in_new View CI Pipeline