A beautiful way to
read Markdown.

Markdown viewer and AI workspace — connect your coding agent, review plans, transcribe voice notes, and read docs beautifully. Cross-platform. Powered by Tauri.

Arandu — README.md
OUTLINE
Getting Started
Installation
Usage
Features
Syntax Highlighting
Live Reload

Getting Started

Arandu is a minimal Markdown viewer that renders your files with beautiful typography, syntax highlighting, and a live-updating preview.

Installation

brew install --cask devitools/arandu/arandu

Usage

arandu README.md
arandu doc1.md doc2.md
arandu *.md

Features

Feature Description
GFM Support Tables, task lists, strikethrough
Plan Reviews 2 GitHub-style inline comments
Syntax Highlighting Powered by highlight.js
Live Reload Auto-refresh on file save

Syntax Highlighting

Code blocks are highlighted automatically with support for over 190 languages.

function greet(name) {
  console.log(`Hello, ${name}!`);
}

Live Reload

Arandu watches your file for changes and refreshes the preview instantly when you save from any editor.

GitHub Flavored Markdown

Tables, task lists, strikethrough, and autolinks — all rendered faithfully, just like on GitHub. Your README looks exactly as intended.

Syntax Result
**bold** bold
~~strike~~ strike
`code` code
  • Design mockup
  • Write docs
  • Ship it

Syntax Highlighting

Code blocks are highlighted by highlight.js with automatic light and dark themes. Over 190 languages supported out of the box.

function greet(name) {
  const msg = `Hello, ${name}!`;
  console.log(msg);
}

greet("Arandu");

AI Workspace

Connect any coding agent — GitHub Copilot, Cursor, and others — and work in structured sessions tied to your project. Chat, plan, review, and execute without leaving your Markdown context.

Architecture Decision

Proposal for the new data layer 1

Use repository pattern with SQLite
Review this plan and suggest improvements
plan Consider adding a caching layer between the repository and the UI...
Create a detailed implementation plan
code Plan created · reviewing

Live Reload

Watches your file and refreshes instantly when you save from any editor.

Outline Navigation

Sidebar with all headings. Click to smooth-scroll to any section.

Theme Switching

Cycle between system, light, and dark themes. Your preference is remembered.

Voice to Text

Built-in speech transcription with OpenAI Whisper. Works offline, no API keys.

Multi-language

Available in English and Portuguese. Language syncs across all windows and the system tray.

Documentation

Learn how to get the most out of Arandu.

Installation

On first launch, Arandu offers to install the arandu CLI automatically. You can also install it later via Arandu → Install Command Line Tool… in the menu bar, or install via Homebrew:

brew install --cask devitools/arandu/arandu

Usage

arandu README.md           # open a file
arandu doc1.md doc2.md     # open multiple files
arandu *.md                # open all .md files in current directory
arandu                     # open the file picker

If Arandu is already running, files open instantly via IPC. Otherwise the app launches automatically.

Setup

Go to Settings → Voice to Text and download a Whisper model. Transcription runs entirely on your device — no internet connection or API key required.

  • tiny (~75 MB) — fastest, good for quick notes
  • base (~140 MB) — balanced speed and accuracy
  • small (~460 MB) — better accuracy for technical content
  • medium (~1.5 GB) — highest accuracy

Usage

Press the global shortcut (configurable in Settings) to open the floating recording window. Speak your text, then click to stop — the transcription is copied to your clipboard automatically. You can also configure the audio input device in Settings.

Connecting an Agent

Open a workspace directory, then click Connect to start a session. Arandu communicates with coding agents (such as GitHub Copilot CLI) via the Agent Communication Protocol (ACP) over stdin/stdout.

Interaction Modes

ask
General questions and explanations
plan
Create a structured implementation plan
code
Generate and modify code
edit
Apply targeted edits to files
agent
Autonomous multi-step execution
autopilot
Fully automated task completion

Plan Workflow

Switch to plan mode to generate a plan document. Review it inline with block comments, then move to the executing phase — all tracked per session within your workspace directory.

Download

Choose the right version for your operating system.

Quick Install

macOS Homebrew
brew install --cask devitools/arandu/arandu
Linux Snap
snap install arandu soon
Linux Flatpak
flatpak install flathub io.devitools.Arandu soon
Windows winget
winget install devitools.Arandu soon

macOS

Requires macOS 13+

Linux

x86_64

Windows

x86_64

Download .exe