by ahpxex
An ebook reader with a self-evolving agent: it remembers your reading across books, and plugins extend the reader and the agent alike.
# Add to your Claude Code skills
git clone https://github.com/ahpxex/read-awareLast scanned: 9/11/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-09-11T08:36:42.066Z",
"npmAuditRan": false,
"pipAuditRan": true,
"promptInjectionRan": true
}read-aware is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ahpxex. An ebook reader with a self-evolving agent: it remembers your reading across books, and plugins extend the reader and the agent alike. It has 334 GitHub stars.
Yes. read-aware passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/ahpxex/read-aware" and add it to your Claude Code skills directory (see the Installation section above).
read-aware is primarily written in TypeScript. It is open-source under ahpxex on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh read-aware against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
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.
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.
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.
| Platform | Status |
|---|---|
| macOS | Available |
| Android | Available |
| Windows | Available; broader real-world testing is welcome |
| Linux | Available; broader real-world testing is welcome |
| iOS | Supported via the public TestFlight beta; App Store distribution is not available yet |
Cross-device sync is available now. Books, reading progress, highlights, notes, conversations, and memory sync between your devices. Supported app, AI, and plugin preferences roam too; device-specific settings such as reading typography stay local. Choose where your encrypted data is stored:
Both options use the same sync engine: data is encrypted on your device before upload, and the remote stores ciphertext. Use the same encryption passphrase on every device connected to the same account or WebDAV folder. Keep it safe: it cannot be recovered if forgotten. The WebDAV login password and the encryption passphrase serve different purposes.
ReadAware remains local-first: reading and writing notes work offline, changes merge when you reconnect, and disconnecting sync keeps your local data. Optional AI inference is separate from sync encryption: relevant reading context is sent to your chosen model provider.
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 storage ReadAware relay or WebDAV; encrypted events and blobs
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.
The repository itself 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, TTS voices, themes, RSS reader, sentence reader, jumper, reading goals, workspace profiles, WebDAV sync, and the annotation / library / memory / text / listening / maintenance desks |
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.
Version tags build macOS, Windows, Linux, Android, and iOS (unsigned, for
sideloading) artifacts through .github/workflows/release.yml. See the
latest release for
current downloads and installation files.
ReadAware is free and open source. A heartfelt thank-you to the sponsors who help keep it that way:
Interested in sponsoring ReadAware? Say hello on the ReadAware Discord.
Questions, ideas, bug reports, and reading stories are welcome on the ReadAware Discord.
ReadAware is free and open source under the GNU AGPL-3.0.
The public plugin API, @read-aware/plugin-types,
is MIT-licensed so third-party plugins can use any license they like.