vmark

VMark

The Plain-Text Workspace Where Humans and AI Collaborate

Free. Local-first. Format-aware.

VMark is the plain-text workspace where humans and AI collaborate. Both parties read and write the same artifacts — Markdown, YAML, JSON, TOML, Mermaid, SVG, HTML, code — directly, with no translation layer. When the file is a known artifact (GitHub Actions workflow, Cargo.toml, package.json, pyproject.toml), VMark renders the right view, not a generic JSON tree.

Download · Documentation · Formats · Features

Highlights

• Multi-Format — Markdown (WYSIWYG + source), JSON / JSONL, YAML, TOML, Mermaid, SVG, HTML (sandboxed), plain text. Code files (.ts, .py, .rs, .go, .css, …) open as syntax-highlighted viewers; toggle to edit in place or open in your $EDITOR.
• Schema-Aware Previews — .github/workflows/ci.yml opens with a workflow-graph view. Cargo.toml, package.json, and pyproject.toml open with a dependency-tree view. Generic JSON / YAML / TOML get a navigable tree.
• AI-Native — MCP integration for Claude Desktop, Claude Code, Codex CLI, Antigravity CLI, Grok CLI, and opencode. AI Genies for inline writing assistance. Both you and the AI work on the same plain-text files.
• Three Markdown Modes — WYSIWYG (Tiptap/ProseMirror), Source Peek (F5), Source Mode (F6, CodeMirror 6)
• Multi-Cursor — Mod + D to select next match, Alt + Click to add cursors, Mod + Alt + ↑↓ for vertical cursors
• Tab Escape — Auto-pair brackets/quotes, press Tab to jump past closing characters
• CJK Done Right — 20+ formatting rules for Chinese, Japanese, Korean text
• 10 Languages — English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Español · Français · Italiano · Português (Brasil). Auto-detected on first launch.
• 6 Themes — White, Paper, Mint, Sepia, Night, Solarized on macOS; Windows and Linux offer White and Night.
• Local-First — No cloud, no accounts, no analytics. Documents stay on your machine.
• Shortcuts — Every one customizable in Settings

See the full feature list at vmark.app/guide/features.

Install

macOS (Homebrew):

brew install xiaolai/tap/vmark

Manual: Download from the Releases page.

• Apple Silicon: VMark_x.x.x_aarch64.dmg
• Intel: VMark_x.x.x_x64.dmg

Windows & Linux: Pre-built binaries on the Releases page. macOS is the primary platform; other builds are best-effort.

AI Integration

VMark speaks MCP natively. Settings → Integrations → Install — one click per assistant.

Supported: Claude Desktop, Claude Code, Codex CLI, Antigravity CLI, Grok CLI, opencode.

See the MCP Setup Guide.

Contributing: Issues Only, No PRs

VMark is vibe-coded — written entirely by AI under human supervision. We welcome issues (bug reports, feature requests) but cannot safely merge external PRs.

When you file an issue, AI fixes it with full context of the project's conventions, test suite, and architecture.

• Bug Report · Feature Request
• Read more: Why Issues, Not PRs

Building from Source

Prerequisites: Node.js 22+, pnpm 10+, Rust (stable), Tauri v2 prerequisites

git clone https://github.com/xiaolai/vmark.git
cd vmark
pnpm install

# Build the MCP sidecar once. Tauri bundles it as an external binary and it is
# a gitignored build artifact, so a fresh clone does not have it.
pnpm --dir server/mcp build:sidecar

pnpm tauri dev        # Development
pnpm tauri build      # Production
pnpm check:all        # Lint + test + build

Tech Stack: Tauri v2 (Rust), React 19, TypeScript, Zustand v5, Tiptap, CodeMirror 6, Tailwind CSS v4

AI-Assisted Development: The repo ships with full configuration for Claude Code, Codex CLI, and Antigravity. See AGENTS.md for conventions and .claude/ for rules, skills, and subagents.

Star History

License

ISC License — free to use, copy, modify, and distribute. See the license page for details.