Guide
Gianna from the command line
For the technically inclined — gianna-cli reaches your own account from a terminal.
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.