Skip to content

Repository files navigation

Austen CLI

 █████  ██    ██ ███████ ████████ ███████ ███    ██ 
██   ██ ██    ██ ██         ██    ██      ████   ██ 
███████ ██    ██ ███████    ██    █████   ██ ██  ██ 
██   ██ ██    ██      ██    ██    ██      ██  ██ ██ 
██   ██  ██████  ███████    ██    ███████ ██   ████

This CLI tool uses AI to analyze books and generate character relationship diagrams in ASCII art directly from the command line.

2026-02-04.13-09-35.mp4

Features

  • 🔍 Search any book from Open Library
  • 🤖 AI-powered character relationship analysis via Cloudflare Worker
  • 🎨 ASCII art diagram rendering in terminal
  • 🔗 Shareable browser links for viewing and sharing diagrams

Usage

Quick Start

npx austen generate "Pride and Prejudice"

Or install globally

npm install -g austen

Generate a diagram

austen generate "The Art of Computer Programming"

austen generate Misery

View help

austen --help
austen generate --help

Installation

git clone https://github.com/herol3oy/austen-cli

cd austen-cli

npm i

npm run build

npm link

austen generate Emma

Development

Running Tests

npm t

Building

npm run build

Example Output

The Old Man and the Sea by Ernest Hemingway (1952)

┌─────────────┐            ┌─────────┐
│             │            │         │
│   Santiago  ├Apprentice─►┤ Manolin │
│             │            │         │
└──────┬──────┘            └─────────┘
       │                              
       │                              
       │                              
   Adversary                          
       │                              
       │                   ┌─────────┐
       │                   │         │
       ├──────────────────►│  Marlin │
       |                   │         │
       │                   └─────────┘
       │                              
       │                              
       │                              
  Adversaries                              
       │                              
       │                   ┌─────────┐
       │                   │         │
       └──────────────────►│  Sharks │
                           │         │
                           └─────────┘

How It Works

  1. Search: Searches Open Library for books matching your query
  2. Select: Lets you choose from the top 5 search results
  3. Analyze: Uses DeepSeek AI via Cloudflare Worker to analyze character relationships
  4. Render: Displays ASCII art diagram in your terminal
  5. Share: Generates a shareable link so you can view and share the diagram in a browser

Tech Stack

  • TypeScript - Type-safe development
  • Commander.js - CLI framework
  • Inquirer - Interactive prompts
  • Ora - Loading spinners
  • Chalk - Colored output
  • Beautiful Mermaid - Converting Mermaid syntax to ASCII
  • Cloudflare Workers - Serverless AI endpoint (DeepSeek integration)

Note: The Cloudflare Worker is pre-deployed and hardcoded in the CLI for simplicity. No environment setup required!

API Credits

Related Projects

About

CLI tool to generate diagrams for book character relationships

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages