Pray CLI

Prayers in your terminal: for a quiet moment with the Lord between builds, or a prayer to St. Carlo Acutis logged before tonight’s deploy.

Try
  • pray rosary

Install

On macOS or Linux, with Homebrew:

brew install jamesmagoo/tap/pray

Or with Go 1.25 or newer:

go install github.com/jamesmagoo/pray-cli/cmd/pray@latest

This puts pray in $(go env GOPATH)/bin, so make sure that folder is on your PATH.

On Linux, a .deb, .rpm or .apk is attached to each release.

Or build it from a clone:

git clone https://github.com/jamesmagoo/pray-cli
cd pray-cli
just install        # or: go install ./cmd/pray

Prebuilt binaries for macOS, Linux and Windows are on the releases page, if none of the above fits.

Pray the rosary

A full-screen rosary, right in the terminal.

Choose which mysteries to pray, then move bead by bead through the whole rosary: the opening prayers, five decades, and the Hail Holy Queen to close.

Praying the rosary in the terminal: choosing the mysteries, then moving bead by bead from the crucifix to the first decade
pray rosary
space, enter, →The next prayer
←, backspaceBack one prayer
↑, ↓Choose the mysteries, on the opening screen
x, escFinish

Needs a terminal at least 98×34 columns, or it says so rather than drawing a broken ring.

How to pray

Type pray and the name of a prayer.

pray hail mary
Hail Mary

Hail Mary, full of grace,
the Lord is with thee.
Blessed art thou amongst women,
and blessed is the fruit of thy womb, Jesus.

Holy Mary, Mother of God,
pray for us sinners,
now and at the hour of our death.

Amen.

You needn’t know the exact name. A nickname, a word from the title, or the start of a word will do.

pray ave
a nickname for the Hail Mary
pray carlo
the Prayer of Intercession for Technical Problems
pray saint carlo
“saint”, “st” and “st.” all work
pray acut
the start of a word is enough

If what you type could mean more than one prayer, pray lists them so you can be more specific.

To pray for someone or something, add --for and your intention.

pray hail mary --for "my mum"
Hail Mary

For my mum

Hail Mary, full of grace,
…

The intention is named before the prayer, as you would say it aloud. Some prayers have a place for it in their text: the St. Carlo prayer asks for help “specifically for the server migration”.

For Latin, add --lang la.

pray hail mary --lang la
Ave Maria

Ave Maria, gratia plena,
Dominus tecum.
Benedicta tu in mulieribus,
et benedictus fructus ventris tui, Iesus.
…

A prayer that hasn’t been translated yet comes in English.

To put a prayer on your clipboard, use pray copy.

pray copy carlo --for "the release"
Copied Prayer of Intercession for Technical Problems to the clipboard

It copies plain text, ready to paste into a message, a document or a commit. On Linux it needs xclip, xsel or wl-clipboard.

In a script, pipe or redirect it like any other command.

#!/bin/sh
pray carlo --for "tonight's deploy" >> deploy.log
./deploy.sh

When its output isn’t a terminal, pray always writes plain text, so it’s safe to log.

Options

--for "<intention>"Pray for someone or something
--lang <code>Language: en (the default) or la
--tag <tag>With pray list: only prayers with this tag, such as marian
-h, --helpHelp for pray or any command, such as pray copy --help

The prayers

Every prayer pray knows, as it prints them. pray list shows the same in your terminal.

Apostles' Creed

Symbolum Apostolorum

Pray it with
pray apostles-creed or pray the apostles creed, pray creed, pray credo, pray symbolum apostolorum
In
English, Latin
Tagged
rosary, creed

I believe in God, the Father almighty, Creator of heaven and earth, and in Jesus Christ, his only Son, our Lord, who was conceived by the Holy Spirit, born of the Virgin Mary, suffered under Pontius Pilate, was crucified, died and was buried; he descended into hell; on the third day he rose again from the dead; he ascended into heaven, and is seated at the right hand of God the Father almighty; from there he will come to judge the living and the dead.

I believe in the Holy Spirit, the Holy Catholic Church, the communion of saints, the forgiveness of sins, the resurrection of the body, and life everlasting.

Amen.

Credo in Deum Patrem omnipotentem, Creatorem caeli et terrae, et in Iesum Christum, Filium eius unicum, Dominum nostrum, qui conceptus est de Spiritu Sancto, natus ex Maria Virgine, passus sub Pontio Pilato, crucifixus, mortuus, et sepultus, descendit ad inferos, tertia die resurrexit a mortuis, ascendit ad caelos, sedet ad dexteram Dei Patris omnipotentis, inde venturus est iudicare vivos et mortuos.

Credo in Spiritum Sanctum, sanctam Ecclesiam catholicam, sanctorum communionem, remissionem peccatorum, carnis resurrectionem, vitam aeternam.

Amen.

Fatima Prayer

Pray it with
pray fatima-prayer or pray fatima, pray decade prayer, pray o my jesus
In
English
Tagged
rosary, fatima

O my Jesus, forgive us our sins, save us from the fires of hell, lead all souls to heaven, especially those in most need of thy mercy.

Amen.

Glory Be

Gloria Patri

Pray it with
pray glory-be or pray gloria patri, pray doxology, pray glory to the father
In
English, Latin
Tagged
rosary, praise

Glory be to the Father, and to the Son, and to the Holy Spirit.

As it was in the beginning, is now, and ever shall be, world without end.

Amen.

Gloria Patri, et Filio, et Spiritui Sancto.

Sicut erat in principio, et nunc, et semper, et in saecula saeculorum.

Amen.

Hail, Holy Queen

Salve Regina

Pray it with
pray hail-holy-queen or pray salve regina, pray holy queen
In
English, Latin
Tagged
marian, rosary

Hail, holy Queen, Mother of mercy, our life, our sweetness and our hope. To thee do we cry, poor banished children of Eve; to thee do we send up our sighs, mourning and weeping in this vale of tears.

Turn then, most gracious Advocate, thine eyes of mercy toward us; and after this our exile, show unto us the blessed fruit of thy womb, Jesus.

O clement, O loving, O sweet Virgin Mary.

Amen.

Salve, Regina, Mater misericordiae, vita, dulcedo, et spes nostra, salve. Ad te clamamus, exsules filii Hevae; ad te suspiramus, gementes et flentes in hac lacrimarum valle.

Eia, ergo, advocata nostra, illos tuos misericordes oculos ad nos converte; et Iesum, benedictum fructum ventris tui, nobis post hoc exsilium ostende.

O clemens, O pia, O dulcis Virgo Maria.

Amen.

Hail Mary

Ave Maria

Pray it with
pray hail-mary or pray ave, pray ave maria
In
English, Latin
Tagged
marian, rosary

Hail Mary, full of grace, the Lord is with thee. Blessed art thou amongst women, and blessed is the fruit of thy womb, Jesus.

Holy Mary, Mother of God, pray for us sinners, now and at the hour of our death.

Amen.

Ave Maria, gratia plena, Dominus tecum. Benedicta tu in mulieribus, et benedictus fructus ventris tui, Iesus.

Sancta Maria, Mater Dei, ora pro nobis peccatoribus, nunc et in hora mortis nostrae.

Amen.

Our Father

Pater Noster

Pray it with
pray our-father or pray pater noster, pray lords prayer, pray the lords prayer
In
English, Latin
Tagged
rosary, scripture

Our Father, who art in heaven, hallowed be thy name; thy kingdom come, thy will be done on earth as it is in heaven.

Give us this day our daily bread, and forgive us our trespasses, as we forgive those who trespass against us; and lead us not into temptation, but deliver us from evil.

Amen.

Pater noster, qui es in caelis, sanctificetur nomen tuum. Adveniat regnum tuum. Fiat voluntas tua, sicut in caelo et in terra.

Panem nostrum quotidianum da nobis hodie, et dimitte nobis debita nostra, sicut et nos dimittimus debitoribus nostris. Et ne nos inducas in tentationem, sed libera nos a malo.

Amen.

Prayer of Intercession for Technical Problems

Pray it with
pray st-carlo-acutis or pray carlo, pray carlo acutis, pray st carlo, pray tech
In
English
Tagged
saints, work

Almighty and eternal God, you created us in your image, and you bid us seek all that is good and true and beautiful, fully manifest only in the divine person of your only-begotten Son, Jesus Christ.

You have inspired your servant, St. Carlo Acutis, to seek Your goodness, to proclaim Your truth, and to portray Your beauty through technology.

I humbly ask your servant's prayers, that I too may lead others to you through technology.

I humbly ask, through the intercession of St. Carlo, that you grant me clarity and patience in my technological work, specifically for the work before me.

Enlighten my understanding and direct my hands in every design and in every line of code, that my work may always serve your greater glory and benefit those who will use what I create.

Through Christ our Lord. Amen.

The underlined words are the prayer’s own intention. --for puts yours in their place.

Still to come

More prayers and more languages are on the way, and your contributions are welcome. A prayer is a folder of plain text in internal/prayers/data:

hail-mary/
  meta.yaml   aliases, tags and a default intention
  en.md       "# Title", a blank line, then the text
  la.md       other languages alongside, named by language code

Add one, run just test to check it can be found and has everything it needs, and open a pull request on GitHub. This site reads the same files, so the prayer appears here too.