Reado

A calm place to read code.

reado.watermelon-studio.it

Most IDEs are built for writing code. Reado inverts that: the primary
experience is reading, and the primary action is leaving durable comments
anchored to precise points in the code. Those comments are not throwaway notes —
they are persistent, lifecycle-bearing artifacts that an AI agent (Claude Code /
Codex) resolves, and that accumulate into a consultable knowledge base.

The mental model is an inverted code review: you are the reviewer (read,
annotate), the AI is the committer (implements the fixes).

Reado is built with Tauri 2, React 19 and a Rust backend.
It runs on macOS, Linux and Windows.

Download

Grab the latest signed build for your platform from the
Releases page —
macOS (.dmg, signed & notarized), Linux (.AppImage / .deb / .rpm) and
Windows (.exe / .msi). Reado updates itself from signed releases after that.

Status

Reado is in active development. The current focus is the read → annotate →
AI-resolve loop. See openspec/changes/add-reado-mvp
for the full specification and the sequenced task list.

What works today:

• Open any local folder (git repository or not) from a recent-projects launcher.
• Gitignore-aware file tree with a "show hidden" toggle.
• A read-first CodeMirror 6 viewer with broad syntax highlighting, large-file
  virtualization, a line-wrap toggle, comfortable reading width, and a soft
  landing highlight when you jump to a location.
• Dedicated rendering for markdown, images and foldable JSON.
• Fuzzy file open (Cmd/Ctrl+P), full-text project search (ripgrep when
  present, with a built-in pure-Rust fallback), and a command palette
  (Cmd/Ctrl+K).
• Code reading aids: an outline of file symbols, sticky scope headers,
  go-to-definition (Cmd/Ctrl+click / F12), go-to-line, and Format Document
  through the project's own formatters (Biome/Prettier/rustfmt/…).
• Git introspection with stage/unstage/discard/commit, inline blame, and a
  local diff view.
• Four research-grounded themes (dark, light, high-contrast, sepia) with manual,
  follow-system, and time-of-day selection.
• Italian and English UI.
• Anchored comments as an external overlay: leave a comment on a line range
  (hover the + or press the shortcut), with types, states, task/note, threads,
  and a gutter marker. Comments are stored as .md files under .reado/ and
  survive external edits (git-diff-free fuzzy re-anchoring; orphans never point
  at the wrong line).
• An integrated terminal (real PTYs, multiple tabs) with one-click launch of
  claude/codex, and Send review to hand your open tasks to the agent.
• A knowledge base unifying the project's docs, specs (OpenSpec /
  speckit), and the notes captured while reading, with full-text search and
  a knowledge graph linking comments, files, specs and docs.
• A reado CLI — the stable contract the agent uses to read and resolve tasks
  (and to consult the knowledge base).

The AI loop

Reado's core loop is read → annotate → AI-resolve:

1. You read code and leave comments. Comments flagged as tasks are the work
   list; notes stay out of the agent's way.
2. Open the terminal (Cmd/Ctrl+J), launch Claude or Codex, then click
   Send review. Reado injects a prompt asking the agent to fetch and resolve
   your tasks through the reado CLI.
3. The agent reads tasks with reado task list, makes the changes, and marks
   each reado task done <id> (or reado task fail <id> "<reason>"). Reado's
   watcher reflects the result live, and resolved comments move to history.

The reado CLI is the stable contract — the on-disk format can evolve without
breaking the agent. The packaged app bundles the CLI: install it from
Settings → Command-line tool (links reado into ~/.local/bin, VS Code
style). From a source checkout, build and link it directly:

scripts/install-cli.sh           # builds release + links into ~/.local/bin
reado --help

Contract: reado task list|show|done|fail|link,
reado comment add|reply|search, and reado kb list|show|search (to consult
the docs and specs before resolving). Agent identity comes from $READO_AGENT
(Reado sets it when launching an agent).

An agent plugin in plugin/ teaches Claude Code (and Codex, via
AGENTS.md) this contract so the agent resolves tasks correctly. See
plugin/README.md to install it.

Keyboard shortcuts

Development

Prerequisites: Node.js 22+, pnpm,
the Rust toolchain, and the
Tauri system dependencies for your OS.
ripgrep (rg) on your PATH makes
full-text search faster; without it Reado falls back to a built-in scanner.

pnpm install        # install frontend dependencies
pnpm tauri dev      # run the app in development
pnpm tauri build    # produce a native installer for the current platform

Useful checks:

pnpm typecheck                                   # TypeScript
cargo test    --manifest-path src-tauri/Cargo.toml
cargo clippy  --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings

Contributing

Reado aims to be a friendly open-source project. Contributions are welcome — see
CONTRIBUTING.md and our Code of Conduct.
Security issues: see SECURITY.md. All code, comments and
documentation are written in English.

License

MIT © Reado contributors