🌌 Shattered — A CLI Companion for the Cosmere

"The most important step a man can take. It's not the first one, is it? It's the next one. Always the next step." — Dalinar Kholin

Shattered is a command-line companion for fans of Brandon Sanderson's Cosmere. Get random quotes, learn about Knights Radiant orders, explore allomantic and feruchemical metals, and meditate on the words of your favorite characters.

Installation

# Clone and install
git clone https://github.com/shift-zero/shattered.git
cd shattered
npm install

# Run it
node src/index.js <command>

Or install globally:

npm install -g shattered
shattered <command>

Commands

Command	Description
fortune	Random quote from the Cosmere
radiant	Random Knights Radiant order + ideals
metal	Random metal (allomantic or feruchemical)
meditate	Quote + reflection prompt for journaling
insight	Random Cosmere lore / Realmatic Theory wisdom

Options

-h, --help      Show help
-V, --version   Show version

Radiant

# Random order
shattered radiant

# List all orders
shattered radiant --list

Metal

# Random metal
shattered metal

# Only allomantic metals
shattered metal --allomantic

# Only feruchemical metals
shattered metal --feruchemical

# List all metals
shattered metal --list

Examples

$ shattered fortune

  "❝ Honor is dead. But I'll see what I can do. ❞"
  — Kaladin Stormblessed, *Words of Radiance*

$ shattered meditate

  🧘  MEDITATE
  ─────────────

  "❝ Sometimes a hypocrite is nothing more than a man in the process of changing. ❞"
  — Dalinar Kholin, *Oathbringer*

  Reflection prompt: What question does this quote raise for you?

Data

• 40+ quotes spanning the entire Cosmere — The Stormlight Archive, Mistborn, Elantris, Warbreaker, Tress, Yumi, and The Sunlit Man
• All 10 Knights Radiant orders with spren, surges, herald, and ideals
• 16 allomantic metals + 16 feruchemical metals + 3 god metals with full descriptions
• 15 Cosmere insights covering Realmatic Theory, Investiture, Shards, and Hoid
• Reflection prompts for journaling and meditation

License

MIT — go build something radiant.

---

"The purpose of a storyteller is not to tell you how to think, but to give you questions to think upon." — Hoid