Build a Personal Reading Card System with Claude Code

hero

If you finish a book and can barely remember the title two weeks later, you're not alone — and it's not a discipline problem. The real issue is friction. Opening a note-taking app, searching for the author, copying a key quote, writing a summary — that's 20 minutes of overhead that kills the habit before it starts.

This tutorial shows you how to drop that overhead to under 30 seconds using Claude Code. You give it a book title and one sentence of your thoughts. It gives you back a structured reading card, ready to archive.

overall flow — from raw input to archived card

The Problem: Why Reading Logs Always Die

Every reading habit system I've tried had the same failure mode. The ritual was too heavy. Here's what a "proper" book log looked like in my workflow:

  1. Open notes app
  2. Create a new entry, format the header
  3. Search for the author's full name and publication year
  4. Copy out a key quote (requires flipping back through the book)
  5. Write a structured summary and reflection

That's a minimum 15-20 minutes per book — after finishing the reading. The moment you're tired or distracted, you skip it. Skip it twice and the log is dead.

The first thing I tried was a pre-made template in Obsidian. It reduced the typing, but I still had to fill in every field manually. The friction dropped maybe 30%. Not enough.

old manual workflow bottlenecks

The Fix: One Prompt, One Card

Claude Code takes a single natural-language input and returns a fully structured card. Here's the exact prompt pattern I use:

claude "Book: Pachinko / Author: Min Jin Lee / Impression: A four-generation survival story of one ethnic group. Kept making me think about what identity even means. Please make a reading card."

That's it. What comes back looks like this:

## Reading Card — Pachinko
Author: Min Jin Lee

### Core Theme
Identity, belonging, and the cost of survival across generations. The novel asks whether the country you were born in defines who you are — or whether you get to decide.

### Line to Remember
"Pachinko was a foolish game, but he had been good at it."

### One-Line Summary
Four Korean generations in Japan — each fighting a different version of the same question: who am I allowed to be?

### Question It Left Me With
If your nationality is an accident of history, what do you actually owe it?

Claude structures four things automatically: the core theme, one memorable line, a tight summary, and a follow-up question — even if your raw impression was just two rough sentences. The "chef receives ingredients, plates the dish" analogy holds here. Your input doesn't have to be polished. Claude does the finishing.

prompt-to-card transformation

Verification

After running the command, your terminal should output the card directly. You can pipe it straight to a log file:

claude "Book: Pachinko / Author: Min Jin Lee / Impression: Four-generation survival story. Kept thinking about identity." >> ~/reading-log.txt

Open the file and you'll see the new card appended at the bottom. No overwriting, no reformatting needed.

tail -n 30 ~/reading-log.txt

Expected output: the last card you added, fully structured, timestampable if you prefix entries.

Scaling Up: Your Cards Become a Searchable Library

Here's where it gets genuinely useful. Once you have 30-50 cards in reading-log.txt, you can query the whole file as context.

claude "$(cat ~/reading-log.txt)

Based on every card above, which books I read this year fall under the theme of personal growth? Summarize the pattern."

Claude's 200K token context window handles this without issue. A card averages around 150-200 words, so 50 cards is roughly 10,000 tokens — well inside the limit. You're essentially running a librarian who has read every book on your shelf and can cross-reference them on demand.

Queries I've actually run against my own log:

Query What It Returns
"Books about identity this year" Grouped list with one-line rationale per book
"Which book had the strongest question for me?" The card with the sharpest follow-up question field
"Recommend my next read based on patterns" Suggested genre/theme based on what I've gravitated toward
"What topics did I avoid?" Gaps in the log — forces honest reflection

query flow across accumulated cards

Getting Started Today

Install Claude Code globally if you haven't:

npm install -g @anthropic-ai/claude-code

Set your API key:

export ANTHROPIC_API_KEY=your_key_here

Create the log file:

touch ~/reading-log.txt

Now run your first card. Use this template — fill in your own book:

claude "Book: [Title] / Author: [Name] / Impression: [Your raw thoughts in 1-3 sentences.] Please make a reading card." >> ~/reading-log.txt

The workflow I settled on: the moment I close a book — or even on the last page — I open the terminal on my phone or Mac Mini and type the impression while it's still warm. Takes 30 seconds. The card goes into the file automatically.

Variations and Gotchas

What if I haven't finished the book?
Works fine mid-read. Just note it: "Impression: Still reading, but chapters 1-4 are about X." Claude cards mid-book actually make great progress markers.

What if my impression is one word?
Don't do that. Even two sentences give Claude enough signal to generate a useful card. One word produces generic output — garbage in, garbage out still applies.

Mac vs. Linux vs. Docker

Environment Notes
macOS (native) Works directly; use ~ for home path
Linux Same commands; check Node version ≥ 18
Docker container Mount a volume so reading-log.txt persists after container stop
Windows (WSL2) Run inside WSL2; treat it the same as Linux

Appending vs. overwriting: Always use >> (append), never > (overwrite). One wrong redirect and your six-month log is gone.

One file or many? I keep one flat file per year (reading-log-2026.txt). Simple to query, easy to back up, no directory structure to maintain.

file management approach

The One-Line Takeaway

Reading logs fail because the entry cost is too high — not because you lack discipline. Drop the cost to one sentence, and the habit survives.

Six months of 30-second card entries gives you a queryable record of your intellectual year. That's the actual payoff. Start with the next book you finish, not the backlog you'll never catch up on.


🐦 Faster updates on X: @baegseungh7061
📚 More in this series: Code Intro
💌 Subscribe: Follow on X or grab the RSS

댓글