Skip to content

Configuration

Config file

Account metadata is stored at ~/.config/rimo/config.yaml:

yaml
active_account: alice-rimo-personal
accounts:
  alice-rimo-personal:
    user_id: user_123
    org_id: org_456
    email: alice@rimo.app
    display_name: Alice
    org_name: Personal

This file is created and managed by rimo auth login / logout / switch — you normally do not edit it by hand.

Token storage

Tokens are never written to config.yaml. They are stored securely by your operating system's credential store and are never written in plain text.

See Authentication for the login flow and token resolution order.

Environment variables

VariableUsed byPurpose
RIMO_INSTALL_DIRinstall scriptDirectory to install the binary into (default ~/.local/bin).
RIMO_NO_UPDATE_CHECKthe binarySet to any non-empty value to disable the background "update available" notice.
CIthe binaryWhen set, the background update notice is suppressed automatically.

File locations summary

WhatWhere
Account metadata~/.config/rimo/config.yaml
TokensOS credential store (managed by rimo auth)
Binary (default install)~/.local/bin/rimo
Update-check cacheOS cache dir, rimo/update_check.json