https://github.com/frankxai/library-os

The open-source Library Intelligence System — capture, extract, and publish every book you read into a permanent deep-dive on your own website.
https://github.com/frankxai/library-os

ai-tools book-intelligence claude-code claude-plugin claude-skill library-os nextjs personal-knowledge-management quote-management reading-list vercel

Last synced: about 1 month ago
JSON representation

The open-source Library Intelligence System — capture, extract, and publish every book you read into a permanent deep-dive on your own website.

Host: GitHub
URL: https://github.com/frankxai/library-os
Owner: frankxai
License: mit
Created: 2026-04-24T16:09:40.000Z (3 months ago)
Default Branch: main
Last Pushed: 2026-05-27T00:44:01.000Z (about 2 months ago)
Last Synced: 2026-05-27T02:21:59.284Z (about 2 months ago)
Topics: ai-tools, book-intelligence, claude-code, claude-plugin, claude-skill, library-os, nextjs, personal-knowledge-management, quote-management, reading-list, vercel
Language: TypeScript
Size: 172 KB
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          # Library OS

**The open-source Library Intelligence System.**

Capture, extract, enrich, and publish every book you read into a permanent deep-dive on your own website.

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Ffrankxai%2Flibrary-os&project-name=my-library&repository-name=my-library)

[![License: MIT](https://img.shields.io/badge/License-MIT-amber.svg)](./LICENSE)

[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-plugin-rose)](./claude-plugin.json)

> Live reference: **22 books, 277 curated quotes, dynamic OG images, JSON quote API** at [frankx.ai/library](https://frankx.ai/library) · The story: [frankx.ai/library/approach](https://frankx.ai/library/approach)

## Install (5 paths, pick one)

```bash

# Bootable Next.js site

git clone https://github.com/frankxai/library-os.git my-library && cd my-library && npm install && npm run dev

# Or — Claude Code plugin only (commands + skill + subagent)

rsync -av <(curl -sL https://github.com/frankxai/library-os/archive/main.tar.gz | tar xz)/library-os-main/.claude/ .claude/

# Or — via ACOS

npx @frankx/agentic-creator-os init  # library-os included from v11+

```

Full install paths in [`INSTALL.md`](./INSTALL.md) — bootable site, drop-in to existing Next.js, plugin-only, cross-AI (ChatGPT/Cursor/Codex/Gemini), via ACOS.

---

## Why

Readers forget up to ninety percent of what they read within a week. Kindle highlights die in Kindle. Notion docs scatter. Goodreads knows what you read but not what you took from it.

Every book you've read is capital. Without a system to compound it, that capital depreciates to zero the moment the book goes back on the shelf.

Library OS is the system that makes it compound. Every book becomes a permanent, intelligent, schema-rich page on your own website — TOC'd, quoted, chapter-distilled, FAQ-answered, cross-linked, SEO-ready, LLM-citable. In six months you own a library that compounds for decades.

## What you get

- **Data schema** — one TypeScript interface for everything a book can be

- **Next.js App Router template** — `/library` index + `/library/{slug}` deep-dive + `/library/approach` showcase

- **Three slash commands** — `/library-add`, `/library-deepen`, `/library-research`

- **One skill** — `library-os` (documents the full workflow)

- **One subagent** — `book-distiller` (the extraction specialist)

- **Full JSON-LD schema** — BreadcrumbList + Article + Review + FAQPage + Quotation on every book page

- **Two example deep-dives** — Profit First + The Fabric of Reality (ship real books in under an hour)

## Quick start (5 minutes to live)

```bash

# 1. Clone

git clone https://github.com/frankxai/library-os.git my-library

cd my-library

# 2. Install

npm install

# 3. Run

npm run dev

# open http://localhost:3000/library

```

Edit `data/book-reviews.ts` to add your first book. Redeploy via `git push` — Vercel picks it up.

## Alternative: cherry-pick into your existing Next.js project

If you already have a Next.js App Router site, copy these files into it:

```

app/books/types.ts

app/books/lib/books-registry.ts       ← customize for your own books

app/library/page.tsx

app/library/[slug]/page.tsx

app/library/approach/page.tsx         ← optional showcase page

data/book-reviews.ts                  ← your data

public/images/library/                ← book cover JPEGs

.claude/commands/library-*.md         ← the three slash commands

.claude/skills/library-os/SKILL.md    ← the workflow skill

.claude/agents/book-distiller.md      ← the extraction subagent

```

Requires: Next.js 14+ App Router, Tailwind CSS v3+, TypeScript. No other dependencies.

## The four-stage workflow

```

CAPTURE ──────► EXTRACT ──────► ENRICH ──────► PUBLISH

   │                │                │              │

   ▼                ▼                ▼              ▼

Photo, notes,   quotes[]      continueReading[]   /library/{slug}

Kindle export,  chapters[]    videos[]            (live, SEO+AEO)

voice memo      tldr, faq     + schema

```

**1 — CAPTURE.** A photo of handwritten margin notes, a Kindle highlights export, a voice memo, a book title in a text file. You refuse to let a thought leave the system.

**2 — EXTRACT.** Run `/library-add "Book Title"` to create the baseline entry with TL;DR, 5 key insights, Best-For audience, starter FAQ, and a book cover pulled from OpenLibrary.

**3 — ENRICH.** Run `/library-deepen {slug}` to populate 10–20 curated quotes and every chapter. Then `/library-research {slug}` to add Continue-Reading and Videos.

**4 — PUBLISH.** `git commit && git push`. Vercel redeploys. Your book is now a permanent URL with the full deep-dive hub + rich structured data.

## The data schema

`app/books/types.ts` — the spine of the system.

```ts

interface BookReview {

  // Identity

  slug, title, author, coverImage, rating, reviewDate, categories, readingTime

  // Core content (required)

  keyInsights: string[]   // exactly 5

  bestFor: string[]       // 3–4

  // AEO layer (optional, strongly recommended)

  tldr?: string

  faq?: Array<{ q, a }>

  publicationYear?: number

  // Deep-dive layer (optional — progressive depth)

  quotes?: BookQuote[]                  // text, chapter, context

  chapters?: BookChapterSummary[]       // number, title, keyIdea, summary

  continueReading?: RelatedReadingItem[]

  videos?: BookVideo[]

  // Wiring

  amazonUrl?: string

  relatedBook?: string    // links to your own books via booksRegistry

  hasCover?: boolean      // gates next/image render

}

```

Books without optional fields render as concise reviews. Books with all fields render as full knowledge hubs. One template, progressive depth.

## The three slash commands

| Command | Purpose | Writes to |

|---|---|---|

| `/library-add` | Create a new entry from just a title | `data/book-reviews.ts`, `public/images/library/` |

| `/library-deepen` | Add quotes + chapters to existing entry | `data/book-reviews.ts` |

| `/library-research` | Add continueReading + videos | `data/book-reviews.ts` |

Run in order. Each is idempotent. Full documentation in [.claude/commands/](./.claude/commands/).

## Cross-AI compatibility

| Tool | Native support | How to use |

|---|---|---|

| Claude Code | ✅ | Slash commands + skill + subagent all work out of the box |

| ChatGPT / Claude.ai (web) | — | Paste the prompt from `.claude/commands/library-*.md`, paste book details, get structured TypeScript back |

| Cursor / Codex / Gemini CLI | — | Read the command files as plain-text instructions, execute the steps |

| Pen & paper | — | The schema and template work without any AI. A hand-curated library is always valid. |

See [`docs/cross-ai-guide.md`](./docs/cross-ai-guide.md) for paste-ready prompts.

## Deployment targets

Library OS ships as a Next.js App Router app, but the **spine** (the `BookReview` TypeScript type + the JSON-LD schema emission) is framework-neutral.

| Stack | Port effort | Notes |

|---|---|---|

| **Next.js App Router** | Zero | Direct. This repo. |

| **Astro / Starlight** | Small | Port `app/library/` to `src/pages/library/`. Schema unchanged. |

| **SvelteKit** | Small | `routes/library/+page.svelte` and `+page.svelte` in `[slug]`. |

| **Hugo / Jekyll / 11ty** | Medium | Each BookReview becomes a markdown file with frontmatter. |

| **Plain HTML** | Medium | A small build script renders static pages. Schema works standalone. |

## Documentation

- [`MANIFESTO.md`](./MANIFESTO.md) — why we build libraries

- [`docs/getting-started.md`](./docs/getting-started.md) — zero-to-first-book walkthrough

- [`docs/cross-ai-guide.md`](./docs/cross-ai-guide.md) — paste-ready prompts for non-Claude-Code setups

- [`docs/schema.md`](./docs/schema.md) — every field explained

- [`.claude/skills/library-os/SKILL.md`](./.claude/skills/library-os/SKILL.md) — the canonical workflow documentation

## Contributing

Issues and PRs welcome. The spirit of Library OS is **curation over automation** — AI helps you move faster, but the final judgment on what deserves to be in your library is yours.

## License

MIT — see [LICENSE](./LICENSE).

## Credits

Built and maintained by [Frank](https://frankx.ai). Reference library at [frankx.ai/library](https://frankx.ai/library).

Inspired by the intuition that the best tools for thought are the ones you own and the ones that outlive their vendors.

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/frankxai/library-os

Awesome Lists containing this project

README