Guide

Gianna from the command line

For the technically inclined — gianna-cli reaches your own account from a terminal.

channelscli

Updated 2026-06-17

For the technically inclined: gianna-cli lets you reach your own Gianna account from a terminal — handy for quick checks or scripting, over the same secure connection as the web app.

This is optional. Most people never need it; the web app and Telegram cover everything.

Signing in

gianna-cli login

This opens your browser to authorize the machine (you stay signed in to your own account) and saves a revocable token under ~/.config/gianna. Check who's signed in with:

gianna-cli whoami

Reading your own data

With --remote, the CLI talks to the hosted Gianna as you — your household, your data:

gianna-cli --remote tasks         # your household's to-do list
gianna-cli --remote routines      # your morning note, weekly review, examen
gianna-cli --remote reminders     # your upcoming reminders
gianna-cli --remote intentions    # your prayer intentions
gianna-cli --remote memory        # what Gianna remembers about your household
gianna-cli --remote memory -q "the children"   # focus the recall on a topic

Signing out

gianna-cli logout

revokes the saved token on the server and deletes it from your machine. A password reset also revokes every signed-in machine.

The same Gianna

The CLI reads the very same account you use on the web and in Telegram — it's another window onto one household, not a separate copy.