iol-tui

Interfaz de terminal para interactuar con tu cuenta y portfolio de IOL (InvertirOnline).

Aviso legal

Este proyecto no está afiliado, respaldado ni asociado con IOL - InvertirOnline. Es un cliente no oficial, desarrollado por la comunidad, que utiliza la API pública de IOL.

https://api.invertironline.com/

Setup

Para instalar las dependencias:

bun install

Para ejecutar:

bun run start

Nota de seguridad

Tus credenciales de inicio de sesión y tokens de acceso de IOL nunca se envían a ningún servidor que no sea la API oficial de IOL, y nunca se escriben en disco en texto plano excepto si optás por guardarlas en el almacén de credenciales de tu sistema operativo.

• Al iniciar, iol-tui solicita usuario y contraseña si no hay credenciales guardadas.
• Después de un inicio de sesión exitoso, podés guardar las credenciales en el keychain nativo de tu sistema. Permanecen en tu máquina y no se transmiten a otro lugar.
• Los tokens de acceso y actualización se mantienen en memoria solo durante la sesión.
• Archivos locales que escribe la aplicación:
  • data/api-usage.json — conteo mensual de solicitudes a la API, asociado a un identificador de cuenta hasheado (sin credenciales)

Almacenamiento de credenciales (cross-keychain)

iol-tui usa cross-keychain para guardar usuario y contraseña en el backend nativo de cada plataforma:

Plataforma	Almacén
macOS	Keychain
Windows	Credential Manager
Linux	Secret Service (GNOME Keyring, KWallet, etc.)

Si no hay un backend nativo disponible, cross-keychain puede usar almacenamiento cifrado en archivo local como respaldo.

Referencias:

• macOS Keychain: https://support.apple.com/guide/keychain-access/what-is-keychain-access-kyca1083/mac
• Windows Credential Manager: https://grahamwatts.co.uk/windows-secrets/
• Linux Secret Service: https://specifications.freedesktop.org/secret-service/