{"id":50587787,"url":"https://github.com/felipetodev/bice-cli","last_synced_at":"2026-06-05T07:30:44.309Z","repository":{"id":350789838,"uuid":"1208174765","full_name":"felipetodev/bice-cli","owner":"felipetodev","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-12T04:09:08.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T06:12:10.025Z","etag":null,"topics":["bice","bun","hono","mcp-server","open-banking","playwright"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felipetodev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T23:21:10.000Z","updated_at":"2026-04-12T04:15:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/felipetodev/bice-cli","commit_stats":null,"previous_names":["felipetodev/bice-cli"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/felipetodev/bice-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipetodev%2Fbice-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipetodev%2Fbice-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipetodev%2Fbice-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipetodev%2Fbice-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipetodev","download_url":"https://codeload.github.com/felipetodev/bice-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipetodev%2Fbice-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33934342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bice","bun","hono","mcp-server","open-banking","playwright"],"created_at":"2026-06-05T07:30:43.650Z","updated_at":"2026-06-05T07:30:44.293Z","avatar_url":"https://github.com/felipetodev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n▬▬▬▬▬▬▬▬▬▬  ██████  ██  ██████ ███████    ██████ ██      ██ \n▬▬▬▬▬▬▬▬▬▬  ██   ██ ██ ██      ██         ██     ██      ██ \n▬▬▬▬▬▬▬▬▬▬  ██████  ██ ██      █████      ██     ██      ██ \n▬▬▬▬▬▬▬▬▬▬  ██   ██ ██ ██      ██         ██     ██      ██ \n▬▬▬▬▬▬▬▬▬▬  ██████  ██  ██████ ███████    ██████ ███████ ██ \n```\n[![npm version](https://img.shields.io/npm/v/bice-cli.svg)](https://www.npmjs.com/package/bice-cli)\n\nAn unofficial **BICE CLI** tool to manage your BICE accounts via terminal commands, REST API and more.\n\n## Installation\n\n```bash\n# From npm (requires Bun)\nbun add -g bice-cli@latest\n\n# Or clone and install locally\ngit clone https://github.com/felipetodev/bice-cli.git\ncd bice-cli\nbun install\nnpx bice\n```\n\n## Setup\n\n```bash\nbice login \u003cRUT\u003e \u003cPassword\u003e          # Example: bice login 123456789 mypassword\n```\n\nOr set environment variables:\n```bash\nexport BICE_RUT=123456789\nexport BICE_PASSWORD=mypassword\n```\n\n## CLI Usage\n\n```bash\n# Banking\nbice login                           # Log in with bank credentials\nbice user                            # Show user info\nbice products                        # List all products\nbice balance                         # Quick balance check\nbice transactions [page] [limit]     # View period transactions (default: page=1, limit=40)\nbice movements [month] [year]        # View historic account movements for a specific month and year (default: current month/year)\nbice monthly-summary [periods]       # View monthly summary (default: 4 past months)\nbice portfolios-summary [date]       # View portfolios summary for a specific date (YYYY-MM-DD)\n\n# Session\nbice whoami                          # Show session info and accounts\nbice logout                          # Disconnect and clear session\n````\n\n## REST API\n\n```bash\nbice server                          # Start REST API server (port 3002)\n```\n\n| Method | Endpoint                           | Description                     \n|--------|------------------------------------|---------------------------------------------------------|\n| GET    | /api/user                          | Get user info                                           |\n| GET    | /api/whoami                        | Get session info and accounts                           |\n| GET    | /api/products                      | Get all products                                        |\n| GET    | /api/transactions                  | Get transactions                                        |\n| GET    | /api/transactions?page=\u0026limit=     | Get transactions with pagination                        |\n| GET    | /api/movements?month=\u0026year=        | Get movements for a specific month and year             |\n| GET    | /api/balance                       | Get balance for all products                            |\n| GET    | /api/monthly-summary?periods=      | Get monthly summary (default: 4 past months)            |\n| GET    | /api/portfolios-summary?date=      | Get portfolios summary for a specific date (YYYY-MM-DD) |\n\n## Tech Stack\n\n- [Bun](https://bun.sh) — Runtime\n- [TypeScript](https://www.typescriptlang.org/) — Type safety\n- [Zod](https://zod.dev/) — Schema validation\n- [Hono](https://hono.dev/) — REST API framework\n- [Playwright](https://playwright.dev/) — Browser automation for BICE login\n\n## Security Considerations\n\n\u003e **This tool is intended for local and personal use only.**\n\u003e It runs on your machine and communicates directly with BICE services, but handling real banking credentials always involves risk.\n\n- Keep your credentials out of shell history whenever possible (use environment variables or secure prompts instead of plain command arguments).\n- Do not commit `.env` files, tokens, or session artifacts to Git. Add local secret files to `.gitignore`.\n- Use this CLI only on trusted devices with disk encryption and an up-to-date OS.\n- If you run `bice server`, bind it to localhost and avoid exposing it publicly unless you add your own auth and network controls.\n- Rotate your password and log out (`bice logout`) if you suspect your machine, terminal session, or logs were exposed.\n- Review this code before using it with production credentials; this is an unofficial project and is not affiliated with Banco BICE.\n\n## Credentials\n\nThis CLI persists authentication material locally so you can reuse your session between commands. That data is stored in plain JSON files inside the tool directory (for example, `.bice-config.json` and `.bice-checking-account.json`) and is not encrypted by default.\n\n- Restrict local file access with `chmod 600 .bice-config.json .bice-checking-account.json`.\n- Run `bice logout` when you finish to remove the active session file.\n- Treat these files as sensitive: never commit, upload, or share them.\n- Avoid running this tool on shared machines, remote shells, or environments with automatic folder sync unless you trust that setup.\n- Assume session cookies/tokens and account metadata can be present in local config, and protect your workstation accordingly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipetodev%2Fbice-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipetodev%2Fbice-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipetodev%2Fbice-cli/lists"}