Read Aware
The only reader you need in the future, agent first, rich plugin, all with great elegance.
Install / Use
npx skills add ahpxex/read-awareInstalls into whichever agent you are using.
README
ReadAware is free and built in the open. If it makes your reading better, give it a star — stars are how new readers find the project.
One reader. One agent. Open-ended plugins.
ReadAware is a free and open-source reader for macOS, Windows, Linux, Android, and iOS. At its center is a single agent that can use tools, answer questions in context, and build an evolving memory from the books, passages, notes, and conversations that matter to you. Around it is a sandboxed plugin system that extends the reader — and the agent — from the inside.
- Stay with the sentence. Sentence-by-sentence reading keeps the page calm, focused, and ADHD-friendly.
- Mark things your way. Underline, highlight, and write notes without breaking your reading flow.
- Ask from the page. Chat with AI about an unfamiliar passage, follow an idea further, or look up a word without leaving the book.
- Extend it from the inside. Install sandboxed plugins from the built-in marketplace: read-aloud voices, reading themes, dictionaries, feeds that read like books, new commands — and new tools the agent picks up and uses.
- Keep words for later. Annotate vocabulary as you read so it can become useful review material instead of a one-off lookup.
- Make the page yours. Switch languages, color themes, fonts, type sizes, spacing, and other reading settings.
- See the habit forming. Reading-time statistics make progress visible across books and sessions.
- Bring almost any book. EPUB, MOBI, AZW3, FB2, PDF, TXT, HTML, CBZ, and CBR share one reading, selection, annotation, and progress model, with no format conversion.
Why it feels different
Most apps bolt AI onto a sidebar. ReadAware is built the other way around: one agent orchestrates retrieval, context assembly, tool use, and memory, and the interface is a surface it can act on. Plugins extend the same seams from the outside — sandboxed and permission-gated, they add voices, themes, dictionaries, feeds, commands, and tools the agent immediately knows how to use.
That combination is the long game: an agent that operates the app through the same contracts plugins are written against can, eventually, extend the app for you. The reader is designed to evolve itself.
The craft underneath is the floor, not the pitch. The interface stays quiet, coherent, and tuned to the pixel — typography first, controls only when they are useful, no AI slop — and the agent stays beside the reading experience rather than taking it over, because a reader earns attention with the page, not the chrome.
Platforms
| Platform | Status | | --- | --- | | macOS | Available | | Android | Available | | Windows | Available; broader real-world testing is welcome | | Linux | Available; broader real-world testing is welcome | | iOS | Supported; App Store distribution is not available yet |
Cross-device sync is planned. Today, ReadAware is local-first: books, reading progress, annotations, conversations, and memory stay on the device, while remote model inference remains optional and provider-controlled.
How it works
ReadAware uses one agent to orchestrate retrieval, context assembly, tool use, and memory updates. Chat transcripts are source material rather than the memory system itself: durable context is built from the reader's ongoing trace across books.
ReadAware app
├── React interface shelf, reader, annotations, chat, settings
├── Local agent runtime tools, retrieval, context, memory updates
├── Plugin runtime sandboxed workers, marketplace, contribution points
├── SQLite product data, event log, FTS, projections
└── Native filesystem imported books and large blobs
Remote services
├── Model provider optional inference through the reader's account
└── Sync relay planned encrypted event and blob transport
The source of truth is local. Raw domain events form the syncable record; memory and search state are rebuildable projections. Retrieval uses SQLite FTS plus scope, recency, and importance signals rather than requiring a vector database.
Plugins and the agent reach the product through the same domain API layer, and every read, write, and event carries its origin — the user, a plugin, or the agent. What the agent can do today, a plugin can extend tomorrow, and vice versa.
Repository
ReadAware is a Bun workspace monorepo orchestrated by Turborepo.
| Path | Responsibility |
| --- | --- |
| apps/web | React 19 interface, TanStack Router, Jotai, Tailwind CSS v4 |
| apps/desktop | Tauri 2 shell and native storage/platform commands |
| apps/landing | Public website and release downloads |
| packages/agent | Agent runtime, model adapters, retrieval, and memory pipelines |
| packages/core | Domain entities, events, and storage contracts |
| packages/ui | Shared design system and co-located Storybook stories |
| packages/plugin-types | The public plugin API surface |
| plugins/ | First-party plugins: dictionary, themes, RSS, read-aloud voices |
Architecture decisions and target data contracts live in
docs/agent-architecture.md and
docs/data-model.md. The plugin API reference and
publishing guide live at
readaware.app/docs/plugins.
Run locally
Prerequisites: Bun, the Rust toolchain, and the native dependencies required by Tauri for your platform.
bun install
bun run dev
Useful workspace commands:
| Command | Purpose |
| --- | --- |
| bun run dev | Run the Tauri app in development |
| bun run dev:web | Run only the UI shell in Vite |
| bun run storybook | Browse the design system and feature stories |
| bun run typecheck | Type-check all workspaces |
| bun run build | Build and type-check the application frontend |
| bun run build:desktop | Produce native desktop release bundles |
| bun run build:landing | Build the public website |
Product behavior must be verified in Tauri. A plain browser does not provide the native IPC, SQLite, filesystem, book-blob, or production CSP paths used by the shipped application.
Releases
Version tags build macOS, Windows, Linux, and Android artifacts through
.github/workflows/release.yml. See the
latest release for
current downloads and installation files.
Community
Questions, ideas, bug reports, and reading stories are welcome on the ReadAware Discord.
License
ReadAware is free and open source under the MIT License.
Related Skills
clawhub
385.5kSearch ClawHub for skills when a requested capability is not already available; install, verify, update, uninstall, publish, or sync skills.
coding-agent
385.5kDelegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup.
skill-creator
385.5kCreate, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.
taskflow
385.5kCoordinate multi-step detached tasks as one durable TaskFlow job with owner context, state, waits, and child tasks.
