[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-5722":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":35,"readmeContent":36,"aiSummary":37,"trendingCount":16,"starSnapshotCount":16,"syncStatus":38,"lastSyncTime":39,"discoverSource":40},5722,"rainfrog","achristmascarl\u002Frainfrog","achristmascarl","🐸 a database tool for the terminal","https:\u002F\u002Fcrates.io\u002Fcrates\u002Frainfrog",null,"Rust",5107,92,25,23,0,3,13,63,12,36.91,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34],"database-management","mysql","postgresql","ratatui","rust","sql","sqlite","terminal","2026-06-12 02:01:14","# 🐸 rainfrog\n\na database tool for the terminal\n\n![rainfrog demo](vhs\u002Fdemo.gif)\n\n> [!WARNING]\n> rainfrog is currently in beta\n\nthe goal for rainfrog is to provide a lightweight, terminal-based tool for\ninteracting with databases.\n\n## features\n\n- efficient navigation via vim-like keybindings and mouse controls\n- query editor with keyword highlighting, session history, and favorites\n- quickly copy data, filter tables, and switch between schemas\n- shortcuts to view table metadata and properties\n- cross-platform (macOS, linux, windows, android via termux)\n\n### why \"rainfrog\"?\n\n> [frogs find refuge in elephant tracks](https:\u002F\u002Fwww.sciencedaily.com\u002Freleases\u002F2019\u002F06\u002F190604131157.htm)\n\n### supported databases\n\nthe levels of support for different databases can be split into 4 tiers:\n- **tier 1**: most frequently tested, bugs will be addressed as soon as possible.\n- **tier 2**: often tested, fixed when necessary.\n- **tier 3**: community supported; contributions are welcome, but otherwise development is minimal.\n- **tier 4**: new or experimental; should be treated as unstable, and behavior is subject to change.\n\n\n| database | tier | known issues | via wire protocol* |\n| -------- | ---- | ------------ | ------------------ |\n| postgres | 1 |  | |\n| mysql | 2 |  | |\n| sqlite | 2  |          | |\n| redshift| 2  |          | postgres |\n| duckdb | 4 | musl binaries are not compatible with this driver      | |\n| oracle | 4 | requires additional runtime dependencies          | |\n\n\n\n*the postgres driver can also be used to connect to other databases that support \nthe postgres wire protocol, such as AWS Redshift. however, this functionality is not \nwell tested. in theory, the mysql driver should be able to do the same for databases \nthat support the mysql protocol. check each database's documentation for compatibility.\n\n## disclaimer\n\nthis software is currently under active development; expect breaking changes,\nand use at your own risk. it is not recommended to use this tool with write\naccess on a production database.\n\n## table of contents\n\u003C!-- TOC start (generated with https:\u002F\u002Fgithub.com\u002Fderlin\u002Fbitdowntoc) -->\n\n- [installation](#installation)\n   * [cargo](#cargo)\n   * [homebrew](#homebrew)\n   * [arch linux](#arch-linux)\n   * [termux](#termux)\n   * [nix](#nix)\n   * [conda](#conda)\n   * [pixi](#pixi)\n   * [install script](#install-script)\n   * [release page binaries](#release-page-binaries)\n   * [icons](#icons)\n- [dependencies](#dependencies)\n   * [oracle](#oracle)\n- [usage](#usage)\n   * [with connection options](#with-connection-options)\n   * [with connection url](#with-connection-url)\n   * [with environment variables](#with-environment-variables)\n   * [`docker run`](#docker-run)\n- [customization](#customization)\n   * [settings](#settings)\n   * [database connections](#database-connections)\n   * [keybindings](#keybindings)\n      + [n.b. for mac users](#nb-for-mac-users)\n      + [general](#general)\n      + [menu (list of schemas and tables)](#menu-list-of-schemas-and-tables)\n      + [query editor](#query-editor)\n      + [query history](#query-history)\n      + [query favorites](#query-favorites)\n      + [results](#results)\n- [exports](#exports)\n- [favorites](#favorites)\n- [roadmap](#roadmap)\n- [known issues and limitations](#known-issues-and-limitations)\n- [Contributing](#contributing)\n- [acknowledgements](#acknowledgements)\n\n\u003C!-- TOC end -->\n\n\u003C!-- TOC -->\u003Ca name=\"installation\">\u003C\u002Fa>\n## installation\n\n\u003C!-- TOC -->\u003Ca name=\"cargo\">\u003C\u002Fa>\n### cargo\n\nafter installing rust (recommended to do so via\n[rustup](https:\u002F\u002Fwww.rust-lang.org\u002Ftools\u002Finstall)):\n\n```sh\ncargo install rainfrog --locked\n```\n\nby default, all features are included. some features may not be compatible with your platform; \ncheck [Cargo.toml](.\u002FCargo.toml) to see what feature combinations are available.\n\n\u003C!-- TOC -->\u003Ca name=\"homebrew\">\u003C\u002Fa>\n### homebrew\n```sh\nbrew install rainfrog\n```\n\n\u003C!-- TOC -->\u003Ca name=\"arch-linux\">\u003C\u002Fa>\n### arch linux\n\narch linux users can install from the\n[official repositories](https:\u002F\u002Farchlinux.org\u002Fpackages\u002Fextra\u002Fx86_64\u002Frainfrog)\nusing [pacman](https:\u002F\u002Fwiki.archlinux.org\u002Ftitle\u002Fpacman):\n\n```sh\npacman -S rainfrog\n```\n\n\u003C!-- TOC -->\u003Ca name=\"termux\">\u003C\u002Fa>\n### termux\n\nif you are using [termux](https:\u002F\u002Ftermux.dev\u002F), you'll need to install rust via\ntheir package manager:\n\n```sh\npkg install rust\n```\n\nand then make sure to install with termux features (and disable default\nfeatures):\n\n```sh\ncargo install rainfrog --no-default-features\n```\n\n\u003C!-- TOC -->\u003Ca name=\"nix\">\u003C\u002Fa>\n### nix\n\n```sh\nnix-env -iA nixos.rainfrog\n```\n\n\u003C!-- TOC -->\u003Ca name=\"conda\">\u003C\u002Fa>\n### conda\n\n```sh\nconda install -c conda-forge rainfrog\n```\n\n\u003C!-- TOC -->\u003Ca name=\"pixi\">\u003C\u002Fa>\n### pixi\n\nThe command below installs rainfrog from conda-forge, the same repository as conda, but unlike conda it can be installed user-globally using [pixi](https:\u002F\u002Fpixi.sh\u002F).\n\n```sh\npixi global install rainfrog\n```\n\n\u003C!-- TOC -->\u003Ca name=\"install-script\">\u003C\u002Fa>\n### install script\n\nthere is a simple install script that assists in downloading and unpacking a\nbinary from the release page to `~\u002F.local\u002Fbin\u002F`, which you might want to add to\nyour `PATH` variable if it isn't already there. you'll need to select which\nbinary is appropriate for your system (if you're not sure, you can find out by\ninstalling rust and running `rustc -vV` to see the \"host\" target), and the\nscript also needs [jq](https:\u002F\u002Fgithub.com\u002Fjqlang\u002Fjq) and\n[fzf](https:\u002F\u002Fgithub.com\u002Fjunegunn\u002Ffzf) installed to run.\n\n```sh\ncurl -LSsf https:\u002F\u002Fraw.githubusercontent.com\u002Fachristmascarl\u002Frainfrog\u002Fmain\u002Finstall.sh | bash\n```\n\n\u003C!-- TOC -->\u003Ca name=\"release-page-binaries\">\u003C\u002Fa>\n### release page binaries\n\n1. manually download and unpack the appropriate binary for your os from the\n   latest [release](https:\u002F\u002Fgithub.com\u002Fachristmascarl\u002Frainfrog\u002Freleases) (if\n   you're not sure which binary to pick, you can find out by installing rust and\n   running `rustc -vV` to see the \"host\" target)\n2. move the binary to a folder in your `PATH` environment variable\n\n\u003C!-- TOC -->\u003Ca name=\"icons\">\u003C\u002Fa>\n### icons\nyou will need to have a nerd font installed and used by your terminal for the icons to show up.\n\n\u003C!-- TOC -->\u003Ca name=\"dependencies\">\u003C\u002Fa>\n## dependencies\nfor some of the databases supported by rainfrog, the driver has additional runtime dependencies.\nyou can find instructions for installing those dependencies below.\n\n\u003C!-- TOC -->\u003Ca name=\"oracle\">\u003C\u002Fa>\n### oracle\nthe oracle driver uses ODPI-C, which requires Oracle Client libraries to be installed. instructions\nfor installing the Oracle Instant Client can be found here: [ODPI-C Installation](https:\u002F\u002Fodpi-c.readthedocs.io\u002Fen\u002Flatest\u002Fuser_guide\u002Finstallation.html).\n\nafter installation, you may need to manually copy the client files to a\nlocation where ODPI-C can find them, which is either in the same folder as the rainfrog binary,\nor in the library path of your os. more details can be found in the ODPI-C\ninstallation instructions: [ODPI-C Client Library Loading](https:\u002F\u002Fodpi-c.readthedocs.io\u002Fen\u002Flatest\u002Fuser_guide\u002Finstallation.html#oracle-client-library-loading).\n\n\u003C!-- TOC -->\u003Ca name=\"usage\">\u003C\u002Fa>\n## usage\n\n```sh\nUsage: rainfrog [OPTIONS] [COMMAND]\n\nCommands:\n  edit  Edit the config file (create it first if missing)\n  help  Print this message or the help of the given subcommand(s)\n\nOptions:\n  -M, --mouse \u003CMOUSE_MODE>   Whether to enable mouse event support. If enabled, the default mouse event handling for your terminal\n                             will not work. [possible values: true, false]\n  -u, --url \u003CURL>            Full connection URL for the database, e.g. postgres:\u002F\u002Fusername:password@localhost:5432\u002Fdbname\n      --username \u003CUSERNAME>  Username for database connection\n      --password \u003CPASSWORD>  Password for database connection\n      --host \u003CHOST>          Host for database connection (ex. localhost)\n      --port \u003CPORT>          Port for database connection (ex. 5432)\n      --database \u003CDATABASE>  Name of database for connection (ex. postgres)\n      --driver \u003CDRIVER>      Driver for database connection (ex. postgres)\n  -h, --help                 Print help\n  -V, --version              Print version\n```\n\n\u003C!-- TOC -->\u003Ca name=\"with-connection-options\">\u003C\u002Fa>\n### with connection options\n\nif any options are not provided, you will be prompted to input them.\nif you do not provide an input, that option will\ndefault to what is in your environment variables.\n\n```sh\nrainfrog \\\n  --driver \u003Cdb_driver> \\\n  --username \u003Cusername> \\\n  --host \u003Chostname> \\\n  --port \u003Cdb_port> \\\n  --database \u003Cdb_name>\n```\n\n\u003C!-- TOC -->\u003Ca name=\"with-connection-url\">\u003C\u002Fa>\n### with connection url\n\nthe `connection_url` must include all the necessary options for connecting\nto the database (ex. `postgres:\u002F\u002Fusername:password@localhost:5432\u002Fpostgres`).\nit will take precedence over all connection options.\n\n```sh\nrainfrog --url $(connection_url)\n```\n\n\u003C!-- TOC -->\u003Ca name=\"with-environment-variables\">\u003C\u002Fa>\n### with environment variables\nif `connection_url` is not present, rainfrog will first check your `DATABASE_URL`\nenvironment variable, then it will check for `DATABASE_URL` in a `.env` file in\nthe current directory or a parent directory.\n\n\u003C!-- TOC -->\u003Ca name=\"docker-run\">\u003C\u002Fa>\n### `docker run`\n\nfor postgres and mysql, you can run it by specifying all\nof the options as environment variables:\n\n```sh\ndocker run --platform linux\u002Famd64 -it --rm --name rainfrog \\\n  --add-host host.docker.internal:host-gateway \\\n  -e db_driver=\"db_driver\" \\\n  -e username=\"\u003Cusername>\" \\\n  -e password=\"\u003Cpassword>\" \\\n  -e hostname=\"host.docker.internal\" \\\n  -e db_port=\"\u003Cdb_port>\" \\\n  -e db_name=\"\u003Cdb_name>\" achristmascarl\u002Frainfrog:latest\n```\n\nif you want to provide a custom combination of\noptions and omit others, you can override the Dockerfile's\nCMD like so:\n\n```sh\ndocker run --platform linux\u002Famd64 -it --rm --name rainfrog \\\n  achristmascarl\u002Frainfrog:latest \\\n  rainfrog # overrides CMD, additional options would come after\n```\n\nsince sqlite is file-based, you may need to mount a path to\nthe sqlite db as a volume in order to access it:\n\n```sh\ndocker run --platform linux\u002Famd64 -it --rm --name rainfrog \\\n  -v ~\u002Fcode\u002Frainfrog\u002Fdev\u002Frainfrog.sqlite3:\u002Frainfrog.sqlite3 \\\n  achristmascarl\u002Frainfrog:latest \\\n  rainfrog --url sqlite:\u002F\u002F\u002Frainfrog.sqlite3\n```\n\nrunning drivers which have runtime dependencies (like oracle) via docker\nis not currently supported.\n\n\n\u003C!-- TOC -->\u003Ca name=\"customization\">\u003C\u002Fa>\n## customization\n\nrainfrog can be customized by placing a `rainfrog_config.toml` file in\none of the following locations depending on your os, as determined by\nthe [directories](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fdirectories) crate:\n\n| Platform | Value                                                                   | Example                                                       |\n| -------- | ----------------------------------------------------------------------- | ------------------------------------------------------------- |\n| Linux    | `$XDG_CONFIG_HOME`\u002F`_project_path_` or `$HOME`\u002F.config\u002F`_project_path_` | \u002Fhome\u002Falice\u002F.config\u002Fbarapp                                    |\n| macOS    | `$HOME`\u002FLibrary\u002FApplication Support\u002F`_project_path_`                    | \u002FUsers\u002FAlice\u002FLibrary\u002FApplication Support\u002Fcom.Foo-Corp.Bar-App |\n| Windows  | `{FOLDERID_LocalAppData}`\\\\`_project_path_`\\\\config                     | C:\\Users\\Alice\\AppData\\Local\\Foo Corp\\Bar App\\config          |\n\nyou can change the default config directory by exporting an environment variable.\nto make the change permanent, add it to your .zshrc\u002F.bashrc\u002F.\\*rc file:\n\n```sh\nexport RAINFROG_CONFIG=~\u002F.config\u002Frainfrog\n```\n> [!WARNING]\n> this should be the path to the directory that the config file is in,\n> NOT the path to the actual file\n\n\u003C!-- TOC -->\u003Ca name=\"settings\">\u003C\u002Fa>\n### settings\n\n| Name | Default | Description |\n| -------- | ----------------------------------------------------------------------- | ------------------------------------------------------------- |\n| mouse_mode | `true` | whether to capture mouse events. capturing mouse events allows you to change focus and scroll using the mouse. however, your terminal will not handle mouse events like it normally does (you won't be able to copy by highlighting, for example). |\n| data_compact_columns | `true` | whether column widths should be dynamic based on the length of the contents of each column. there is still a max column width that won't be exceeded, so this will save some space by compressing the widths of columns with shorter strings. |\n| data_row_spacer | `false` | whether rows will have a space separating them to make the data table less visually dense.                    |\n\n\u003C!-- TOC -->\u003Ca name=\"database-connections\">\u003C\u002Fa>\n### database connections\n\ndatabase connections can be configured in the configuration file as shown below:\n\n```\n[db]\npostgres-local = { host = \"localhost\", driver = \"postgres\", port = 5432, database = \"postgres\", username = \"postgres\",  default = true }\npostgres-dev = { connection_string = \"postgresql:\u002F\u002Fpostgres:test123@127.0.0.1:5432\", driver = \"postgres\" }\nmysql-local = { host = \"localhost\", driver = \"mysql\", port = 32768, database = \"rainfrog\", username = \"root\" }\nsqlite-memory = { connection_string = \"sqlite:\u002F\u002F:memory:\", driver = \"sqlite\"}\nsqlite-disk = { connection_string = \"sqlite:\u002F\u002F.\u002Fmy_database.db\", driver = \"sqlite\"}\noracle-local = { host = \"localhost\", driver = \"oracle\", port = 1521, database = \"rainfrog\", username = \"rainfrog\" }\n```\n\nthe connection details can be provided in two formats: a raw connection string or specifying individual fields.\nconnections input are prioritized in the following order:\n\n- cli input\n- `DATABASE_URL` env variable\n- config file\n\nif no database connection in the config is set as the default connection, \na prompt will appear to select the desired database. The user will also be \nprompted for the password for the selected database and will have the option to \nstore it in a platform specific keychain for future reuse.\nfuture plans for database connections include switching database without having to restart rainfrog.\n\n\u003C!-- TOC -->\u003Ca name=\"keybindings\">\u003C\u002Fa>\n### keybindings\n\nyou can customize some of the default keybindings, but not all of\nthem. to see a list of the ones you can customize, see the default\nconfig file at [.config\u002Frainfrog_config.toml](.\u002F.config\u002Frainfrog_config.toml). below\nare the default keybindings.\n\n\u003C!-- TOC -->\u003Ca name=\"nb-for-mac-users\">\u003C\u002Fa>\n#### n.b. for mac users\non mac, for VS Code, terminal, kitty, and others, a setting for\n\"use option as meta key\" needs to be turned\non for Alt\u002FOpt keybindings to work. (In VS Code, it's\n`\"terminal.integrated.macOptionIsMeta\": true` in the settings; in\nkitty, it's `macos_option_as_alt yes` in the config.)\n\n\u003C!-- TOC -->\u003Ca name=\"general\">\u003C\u002Fa>\n#### general\n\n| keybinding                   | description                     |\n| ---------------------------- | ------------------------------- |\n| `Ctrl+c`                     | quit program                    |\n| `Alt+1`, `Ctrl+k`            | change focus to menu            |\n| `Alt+2`, `Ctrl+j`            | change focus to query editor    |\n| `Alt+3`, `Ctrl+h`            | change focus to results         |\n| `Alt+4`, `Ctrl+g`            | change focus to query history   |\n| `Alt+5`, `Ctrl+m`            | change focus to query favorites |\n| `Tab`                        | cycle focus forwards            |\n| `Shift+Tab`                  | cycle focus backwards           |\n| `q`, `Alt+q` in query editor | abort current query             |\n\n\u003C!-- TOC -->\u003Ca name=\"menu-list-of-schemas-and-tables\">\u003C\u002Fa>\n#### menu (list of schemas and tables)\n\n| keybinding                   | description                       |\n| ---------------------------- | --------------------------------- |\n| `j`, `↓`                     | move selection down by 1          |\n| `k`, `↑`                     | move selection up by 1            |\n| `g`                          | jump to top of current list       |\n| `G`                          | jump to bottom of current list    |\n| `h`, `←`                     | focus on schemas (if more than 1) |\n| `l`, `→`                     | focus on tables                   |\n| `\u002F`                          | filter tables                     |\n| `Esc`                        | clear filter                      |\n| `Backspace`                  | focus on tables                   |\n| `Enter` when searching       | focus on tables                   |\n| `Enter` with selected schema | focus on tables                   |\n| `Enter` with selected table  | preview table (100 rows)          |\n| `R`                          | reload schemas and tables         |\n\n\u003C!-- TOC -->\u003Ca name=\"query-editor\">\u003C\u002Fa>\n#### query editor\n\nkeybindings may not behave exactly like vim. the full list of active\nVim keybindings in rainfrog can be found at [vim.rs](.\u002Fsrc\u002Fvim.rs).\n\n| Keybinding        | Description                            |\n| ----------------- | -------------------------------------- |\n| `Alt+Enter`, `F5` | Execute query                          |\n| `F7`              | Bypass parser to execute query (cannot rollback, no validation) |\n| `j`, `↓`          | Move cursor down 1 line                |\n| `k`, `↑`          | Move cursor up 1 line                  |\n| `h`, `←`          | Move cursor left 1 char                |\n| `l`, `→`          | Move cursor right 1 char               |\n| `w`               | Move cursor to next start of word      |\n| `e`               | Move cursor to next end of word        |\n| `b`               | Move cursor to previous start of word  |\n| `0`               | Move cursor to beginning of line       |\n| `$`               | Move cursor to end of line             |\n| `gg`              | Jump to top of editor                  |\n| `G`               | Jump to bottom of current list         |\n| `Esc`             | Return to normal mode                  |\n| `i`               | Enter insert (edit) mode               |\n| `I`               | Enter insert mode at beginning of line |\n| `A`               | Enter insert mode at end of line       |\n| `o`               | Insert new line below and enter insert |\n| `v`               | Enter visual (select) mode             |\n| `V`               | Enter visual mode and select line      |\n| `r`               | Begin replace operation                |\n| `y`               | Begin yank (copy) operation            |\n| `x`               | Begin cut operation                    |\n| `p`               | Paste from clipboard                   |\n| `u`               | Undo                                   |\n| `Ctrl+r`          | Redo                                   |\n| `Ctrl+e`          | Scroll down                            |\n| `Ctrl+y`          | Scroll up                              |\n| `Ctrl+f`*, `Alt+f`  | Save query to favorites                |\n\n*only works in normal mode\n\n\u003C!-- TOC -->\u003Ca name=\"query-history\">\u003C\u002Fa>\n#### query history\n\n| keybinding | description                   |\n| ---------- | ----------------------------- |\n| `j`, `↓`   | move selection down by 1      |\n| `k`, `↑`   | move selection up by 1        |\n| `g`        | jump to top of list           |\n| `G`        | jump to bottom of list        |\n| `y`        | copy selected query           |\n| `I`        | edit selected query in editor |\n| `D`        | delete all history            |\n\n\u003C!-- TOC -->\u003Ca name=\"query-favorites\">\u003C\u002Fa>\n#### query favorites\n\n| keybinding | description                   |\n| ---------- | ----------------------------- |\n| `j`, `↓`   | move selection down by 1      |\n| `k`, `↑`   | move selection up by 1        |\n| `g`        | jump to top of list           |\n| `G`        | jump to bottom of list        |\n| `y`        | copy selected query           |\n| `I`        | edit selected query in editor |\n| `D`        | delete selected query         |\n| `\u002F`        | filter favorites                     |\n| `Esc`      | clear filter                      |\n\n\u003C!-- TOC -->\u003Ca name=\"results\">\u003C\u002Fa>\n#### results\n\n| keybinding                | description                    |\n| ------------------------- | ------------------------------ |\n| `P`                       | export results to csv          |\n| `j`, `↓`                  | scroll down by 1 row           |\n| `k`, `↑`                  | scroll up by 1 row             |\n| `h`, `←`                  | scroll left by 1 cell          |\n| `l`, `→`                  | scroll right by 1 cell         |\n| `b`                       | scroll right by 1 cell         |\n| `e`, `w`                  | scroll left by 1 column        |\n| `{`, `PageUp`, `Ctrl+b`   | jump up one page               |\n| `}`, `PageDown`, `Ctrl+f` | jump down one page             |\n| `g`                       | jump to top of table           |\n| `G`                       | jump to bottom of table        |\n| `0`                       | jump to first column           |\n| `$`                       | jump to last column            |\n| `v`                       | select individual field        |\n| `V`                       | select row                     |\n| `Enter`                   | change selection mode inwards  |\n| `Backspace`               | change selection mode outwards |\n| `y`                       | copy selection                 |\n| `Esc`                     | stop selecting                 |\n\n\u003C!-- TOC -->\u003Ca name=\"exports\">\u003C\u002Fa>\n## exports\n\nquery results can be exported to csv. exporting is a blocking action, \nso be careful about exporting too many rows at once, as it will freeze \nthe application.\n\nthe file will be saved in your downloads directory, which is one of the \nfollowing depending on your os, as determined by\nthe [directories](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fdirectories) crate:\n\n|Platform | Value                  | Example                  |\n| ------- | ---------------------- | ------------------------ |\n| Linux   | `XDG_DOWNLOAD_DIR`     | \u002Fhome\u002Falice\u002FDownloads    |\n| macOS   | `$HOME`\u002FDownloads      | \u002FUsers\u002FAlice\u002FDownloads   |\n| Windows | `{FOLDERID_Downloads}` | C:\\Users\\Alice\\Downloads |\n\nyou can change the default export location by exporting an environment variable.\nto make the change permanent, add it to your .zshrc\u002F.bashrc\u002F.\\*rc file:\n\n```sh\nexport RAINFROG_EXPORT=~\u002FDocuments\n```\n\n\u003C!-- TOC -->\u003Ca name=\"favorites\">\u003C\u002Fa>\n## favorites\n\nfrequently used queries can be saved as favorites. by default, \nfavorites are written to the application's data directory (the \nsame place that logs are written to), which is one of the \nfollowing depending on your os, as determined by \nthe [directories](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fdirectories) crate:\n\n|Platform | Value                                                                      | Example                                                       |\n| ------- | -------------------------------------------------------------------------- | ------------------------------------------------------------- |\n| Linux   | `$XDG_DATA_HOME`\u002F`_project_path_` or `$HOME`\u002F.local\u002Fshare\u002F`_project_path_` | \u002Fhome\u002Falice\u002F.local\u002Fshare\u002Fbarapp                               |\n| macOS   | `$HOME`\u002FLibrary\u002FApplication Support\u002F`_project_path_`                       | \u002FUsers\u002FAlice\u002FLibrary\u002FApplication Support\u002Fcom.Foo-Corp.Bar-App |\n| Windows | `{FOLDERID_LocalAppData}`\\\\`_project_path_`\\\\data                          | C:\\Users\\Alice\\AppData\\Local\\Foo Corp\\Bar App\\data            |\n\neach favorite will be a separate `.sql` file.\nyou can change the default export location by exporting an environment variable.\nto make the change permanent, add it to your .zshrc\u002F.bashrc\u002F.\\*rc file:\n\n```sh\nexport RAINFROG_FAVORITES=~\u002F.config\u002Frainfrog\u002Ffavorites\n```\n\n\u003C!-- TOC -->\u003Ca name=\"roadmap\">\u003C\u002Fa>\n## roadmap\n\n\u003Cdetails>\n  \u003Csummary>\u003Cb>🏁 v0.1.0 – alpha\u003C\u002Fb>\u003C\u002Fsummary>\n  \n- [x] scrollable table\n- [x] cancellable async querying (spawn tokio task)\n- [x] menu list with tables and schemas (collapsible)\n- [x] tui-textarea for query editor\n- [x] basic tui-textarea vim keybindings\n- [x] handle custom types \u002F enums\n- [x] display rows affected\n- [x] confirm before delete\u002Fdrop\n- [x] table selection and yanking\n- [x] multi-line pasting\n- [x] editor os clipboard support\n- [x] handle mouse events\n- [x] keybindings hints at bottom\n- [x] branch protection\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n  \u003Csummary>\u003Cb>🏁 v0.2.0 – beta\u003C\u002Fb>\u003C\u002Fsummary>\n\n- [x] vhs explainer gifs\n- [x] upgrade ratatui and tui-textarea\n- [x] shortcuts to view indexes, keys, etc.\n- [x] performant syntax highlighting\n- [x] session history\n- [x] changelog, release script\n- [x] handle explain \u002F analyze output\n- [x] show query duration\n- [x] install script for bins\n\n\u003C\u002Fdetails>\n\nnow that rainfrog is in beta, check out the\n[issues tab](https:\u002F\u002Fgithub.com\u002Fachristmascarl\u002Frainfrog\u002Fissues) for planned\nfeatures\n\n\u003C!-- TOC -->\u003Ca name=\"known-issues-and-limitations\">\u003C\u002Fa>\n## known issues and limitations\n\n- geometry types are not currently supported\n- for x11 and wayland, yanking does not copy to the system clipboard, only\n  to the query editor's buffer. see \u003Chttps:\u002F\u002Fgithub.com\u002Fachristmascarl\u002Frainfrog\u002Fissues\u002F83>\n- in visual mode, when selecting an entire line, the behavior is not the same as\n  vim's, as it simply starts the selection at the head of the line, so\n  moving up or down in lines will break the selection.\n- mouse events are only used for changing focus and scrolling; the editor does\n  not currently support mouse events, and menu items cannot be selected using\n  the mouse\n\nyou can find other reported issues in the\n[issues tab](https:\u002F\u002Fgithub.com\u002Fachristmascarl\u002Frainfrog\u002Fissues)\n\n\u003C!-- TOC -->\u003Ca name=\"contributing\">\u003C\u002Fa>\n## Contributing\n\nfor bug reports and feature requests, please [create an issue](https:\u002F\u002Fgithub.com\u002Fachristmascarl\u002Frainfrog\u002Fissues\u002Fnew\u002Fchoose).\n\nplease read [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) before opening issues\nor creating PRs.\n\n\u003C!-- TOC -->\u003Ca name=\"acknowledgements\">\u003C\u002Fa>\n## acknowledgements\n\n- [ratatui](https:\u002F\u002Fgithub.com\u002Fratatui-org\u002Fratatui) (this project used ratatui's\n  [component template](https:\u002F\u002Fgithub.com\u002Fratatui-org\u002Ftemplates\u002Ftree\u002F983aa3cb3b8dd743200e8e2a1faa6e7c06aad85e\u002Fcomponent\u002Ftemplate)\n  as a starting point)\n- [tui-textarea](https:\u002F\u002Fgithub.com\u002Frhysd\u002Ftui-textarea) (used in the query\n  editor)\n- [gobang](https:\u002F\u002Fgithub.com\u002FTaKO8Ki\u002Fgobang) (a rust db tui i drew inspiration\n  from)\n- [ricky rainfrog](https:\u002F\u002Fus.jellycat.com\u002Fricky-rain-frog\u002F)\n- [rainfroggg](https:\u002F\u002Fwww.rainfrog.gg\u002F) (my wife's tattoo studio)\n","rainfrog 是一个专为终端设计的数据库管理工具。它支持多种数据库，包括PostgreSQL、MySQL和SQLite等，并通过Vim风格的键绑定和鼠标控制提供高效的导航方式。该工具还具备查询编辑器，支持关键词高亮显示、会话历史记录及收藏夹功能，能够快速复制数据、过滤表格以及切换模式。此外，用户还可以利用快捷方式查看表元数据和属性。rainfrog适用于需要在命令行环境中高效管理和操作数据库的场景，特别适合开发人员和技术爱好者使用。项目采用Rust语言编写，确保了跨平台兼容性（支持macOS、Linux、Windows以及通过Termux运行于Android）。需要注意的是，rainfrog目前仍处于测试阶段，在生产环境中使用时需谨慎。",2,"2026-06-11 03:04:54","top_language"]