Skip to content

herol3oy/austen-cli

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

License

Stars

Watchers

Forks

Contributors