Parsha Summary#

Quick weekly Torah portion summaries from Sefaria. Lightweight — no heavy commentary, just the text and a brief overview.

Quick Start#

bash

# This week's parsha
parsha-summary

# Specific parsha
parsha-summary "Bereshit"

# Short summary (50 words)
parsha-summary --words 50

# With Hebrew text
parsha-summary --hebrew

# JSON output
parsha-summary --json

Commands#

CommandDescriptionExampleparsha-summaryThis week's parshaparsha-summary``parsha-summary <name>Specific parshaparsha-summary "Noach"``parsha-summary --words NLimit to N wordsparsha-summary --words 100``parsha-summary --hebrewInclude Hebrewparsha-summary -H``parsha-summary --jsonJSON outputparsha-summary -j

Output Format#

text

📖 Vayera
   Genesis.18.1-22.24
   106 verses

Abraham welcomes three angels who announce that Sarah will bear a son. Abraham pleads for Sodom. Lot is saved but his wife becomes a pillar of salt. Sarah gives birth to Isaac. Abraham is tested with the binding of Isaac (Akedah)...

📖 Sample verses:
   1. And the Lord appeared to him in the plains of Mamre: and he sat in the tent door in the heat of the day...
   2. And he lifted up his eyes and looked, and, lo, three men stood by him: and when he saw them, he ran to meet them from the tent door...

Parsha Names#

Accepted names (case-insensitive):

• Bereshit, Noach, Lech-Lecha, Vayera, Chayei Sara, Toldot, Vayetzei, Vayishlach, Vayeshev, Miketz, Vayigash, Vayechi
• Shemot, Vaera, Bo, Beshalach, Yitro, Mishpatim, Terumah, Tetzaveh, Ki Tisa, Vayakhel, Pekudei
• Vayikra, Tzav, Shemini, Tazria, Metzora, Achrei Mot, Kedoshim, Emor, Behar, Bechukotai
• Bamidbar, Naso, Beha'alotcha, Shelach, Korach, Chukat, Balak, Pinchas, Matot, Masei
• Devarim, Vaetchanan, Eikev, Re'eh, Shoftim, Ki Teitzei, Ki Tavo, Nitzavim, Vayelech, Ha'Azinu, Vezot Haberakhah

Features#

• Auto-detects this week's parsha via Hebcal
• Fetches text from Sefaria API
• Configurable summary length
• Optional Hebrew text inclusion
• JSON output for programmatic use

Data Sources#

• Hebcal API — Calendar data, parsha detection
• Sefaria API — Torah text (Hebrew + English)

Limitations#

• Requires internet for text fetch
• Summary is algorithmic (first N verses), not AI-generated
• Hebrew text truncated in non-JSON mode