Skip to content

Repository files navigation

Markwand

An AI-output curator for your desktop — discover, read, and re-enter the markdown docs scattered across your AI-driven projects.

License: MIT Platform: macOS Electron React TypeScript Latest Release

English · 한국어


Why Markwand?

You use Claude Code to draft a PRD. Codex to sketch a refactor plan. Cursor to generate an ADR. The next morning: "where did I save that file?"

AI-driven workflows produce a lot of markdown — scattered across dozens of project folders, never indexed anywhere. Markwand is a local, read-only desktop app that treats those .md files as a first-class knowledge stream: recent docs, tags, drift against source code, cross-project search.

Markwand demo

Highlights

  • 🗂 Multi-project workspaces — register ~/develop/* (or any roots) and browse all projects from one sidebar
  • 📅 Recent 7 days panel — whatever Claude/Codex just wrote floats to the top
  • 🏷 Frontmatter-native filters — filter by tags, source (claude, codex, design, review), status
  • 🔍 In-doc search + ⌘K cross-project palette
  • 🔗 Drift detection — docs reference code files; Markwand flags stale references with a badge
  • 🖼 Images as first-class assets — PNG / JPG / SVG / GIF live alongside your docs
  • 🌐 Remote SSH workspaces (beta, read-only) — browse docs on a remote server without leaving the app
  • 🇰🇷 🇺🇸 i18n — Korean / English, auto-switched from OS locale
  • 🔒 Local-only by default — no telemetry, no document contents leave your machine (SSH workspaces excluded by design)
  • 📝 Read-only by design — Markwand never writes to your files; edit in your own editor

Positioning

If you use… Markwand helps you…
Claude Code / Codex / Cursor / Cline / Aider find & re-enter the docs they left behind across projects
Obsidian / Bear / IA Writer complement them — those edit; Markwand indexes your AI output stream
A monorepo with scattered READMEs, ADRs, RFCs get a live, filterable inventory of everything in *.md

Markwand is not a markdown editor, not a cloud notes service, and not a knowledge graph tool. It is a fast local viewer optimized for the rhythm of AI-assisted development.

Installation (macOS)

Markwand ships as a free ad-hoc signed ZIP while in beta. Pick the ZIP matching your Mac:

  • Apple Silicon (M1/M2/M3/M4) → Markwand-*-arm64-free.zip
  • Intel → Markwand-*-x64-free.zip

Latest: Releases

First launch may show a macOS security warning because the free build is not notarized. The normal path is unzip, drag Markwand.app to Applications, then right-click or Control-click → Open once. If macOS still refuses to open it, the guide includes the verified one-line xattr fallback.

Windows / Linux builds are not shipped yet — Markwand is macOS-first while the core workflow stabilizes.

Build from source

# Prerequisites: Node 18+, pnpm 8+
pnpm install

# Dev server (HMR)
pnpm dev

# Production build
pnpm build

# Type check
pnpm typecheck

# Lint
pnpm lint

# Free ZIP build (macOS)
pnpm dist:mac

Architecture

Layer Stack
Shell Electron 33 · electron-vite · electron-builder
UI React 19 · TypeScript · Zustand · react-arborist
Markdown react-markdown · remark-gfm · remark-breaks · rehype-highlight · rehype-sanitize · mermaid
Watching chokidar · fast-glob · gray-matter · picomatch
Remote ssh2 · ssh-config (read-only transport)
i18n i18next · react-i18next
Storage electron-store (local prefs only)

Rendering goes through rehype-sanitize — untrusted document content never reaches the DOM as raw HTML.

Privacy

  • All scanning, parsing, and search happens locally on your machine.
  • No analytics, no telemetry, no document content is transmitted to any server.
  • The only network I/O Markwand ever performs is the SSH workspace feature you explicitly configure (read-only), and auto-update checks against GitHub Releases (when enabled).

Roadmap

Near-term:

  • Signed + notarized macOS builds
  • Windows build
  • Deeper "Ask this project" search on top of the SSH-aware ⌘K text search backend
  • Writable workspaces behind an explicit opt-in

Longer-term: VS Code / JetBrains companion, agent-friendly MCP integration, richer drift heuristics.

Contributing

Issues, bug reports, and workflow suggestions are welcome — especially from users of other AI coding tools (Cursor, Cline, Aider, Continue, etc.). Please open a GitHub Issue describing:

  • your AI-output workflow,
  • what you tried to find,
  • what Markwand got in the way of.

Pull requests: open an issue first so we can align on scope.

Credits

License

MIT © 2026 Spacewalk — free for personal and commercial use, attribution appreciated.

About

An AI-output curator for your desktop — discover, read, and re-enter the markdown docs scattered across your AI-driven projects. Electron + React + TypeScript.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages