Access the timeless wisdom of the Bhagavad Gita directly from your terminal.
A fast, beautifully formatted, open-source CLI tool built in Go.
Splash screen
Interactive reader
curl -fsSL https://raw.githubusercontent.com/ACS-lessgo/gita-cli/main/install.sh | bashThen run:
gitaIf windows has blocked remote install just run the below command in powershell fist
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserirm https://raw.githubusercontent.com/ACS-lessgo/gita-cli/main/install.ps1 | iex- Go to the Releases page
- Download
gita-windows-amd64.exe - Rename it to
gita.exe - Move it somewhere on your PATH, for example
C:\Windows\System32\— or follow the steps below to add a custom folder
Adding to PATH on Windows (recommended):
# Run in PowerShell as Administrator
# 1. Create a folder for your CLI tools
New-Item -ItemType Directory -Force -Path "C:\tools"
# 2. Move the downloaded binary there (adjust path as needed)
Move-Item "$HOME\Downloads\gita-windows-amd64.exe" "C:\tools\gita.exe"
# 3. Add C:\tools to your PATH permanently
[Environment]::SetEnvironmentVariable(
"PATH",
$env:PATH + ";C:\tools",
[EnvironmentVariableTarget]::Machine
)Open a new terminal and run gita.
Requires Go 1.22+
git clone https://github.com/ACS-lessgo/gita-cli.git
cd gita-cli
go mod tidy
go build -o gita .
./gita| Command | Description |
|---|---|
gita verse <chapter> <verse> |
Retrieve a specific verse |
gita chapter <number> |
Display all verses in a chapter |
gita random |
Show a random verse |
gita search <keyword> |
Search verses by keyword |
gita quote |
Display an inspiring daily quote |
- 🎨 Beautiful terminal output with colors and borders (via
lipgloss) - ⚡ Embedded data — no external API calls, works fully offline
- 🔍 Fast keyword search across all 700 verses
- 🧪 Unit tested core functions
- 🛡️ Error handling for invalid chapters/verses
Run gita with no arguments to launch the full-screen interactive browser:
┌──────────────────────────────────────────┐ ┌──────┐ ┌──────────────────────────────────────────────┐
│ # Chapter │ │ v. │ │ Chapter 2: The Yoga of Knowledge Verse 47 │
│──────────────────────────────────────────│ │──────│ │──────────────────────────────────────────────│
│ Ch 1 Arjuna's Dilemma │ │ 1 │ │ │
│ Ch 2 The Yoga of Knowledge │ │ 2 │ │ Chapter 2: The Yoga of Knowledge │
│▶Ch 3 The Yoga of Action │ │ ▶47 │ │ │
│ Ch 4 The Yoga of Wisdom │ │ 48 │ │ Verse 47 │
│ Ch 5 The Yoga of Renunciation │ │ 55 │ │ │
│ Ch 6 The Yoga of Meditation │ │ 62 │ │ You have a right to perform your prescribed │
│ ... │ │ 63 │ │ duty, but you are not entitled to the fruits │
│ │ │ │ │ of action... │
└──────────────────────────────────────────┘ └──────┘ └──────────────────────────────────────────────┘
←→ panels ↑↓ navigate Enter select / search g/G top/bottom q quit
| Key | Action |
|---|---|
← / → or h / l |
Switch panels |
↑ / ↓ or k / j |
Navigate items |
Enter or Space |
Move focus right |
g / G |
Jump to top / bottom |
/ |
Open search |
n / N |
Next / previous search result |
Esc |
Clear search |
q |
Quit |
# Launch interactive TUI
gita
# Read a specific verse
gita verse 2 47
# Show all verses in a chapter
gita chapter 6
# Random verse
gita random
# Search across all 700 verses
gita search "duty"
gita search "soul" --limit 10
# Daily quote
gita quoteContributions are welcome! Feel free to open issues or pull requests.
git clone https://github.com/ACS-lessgo/gita-cli.git
cd gita-cli
go mod tidy
go test ./... # run tests
go build -o gita . # buildMIT © ACS-lessgo
"You have the right to perform your actions,
but you are not entitled to the fruits."
— Bhagavad Gita 2.47