tongo is a fast and keyboard-driven TUI (Terminal User Interface) for MongoDB. Navigate and manipulate your data without leaving your terminal.

• 🔌 Connect & save MongoDB connections
• ⚡️ Quickly navigate your data with customizable keybindings
• 🔍 Filter your data using Mongo queries
• 📝 Create and edit documents using your terminal editor of choice
• 🔎 Fuzzy search currently-visible data to quickly drill down to what you're looking for
• 📑 Run multiple sessions in tabs for quick data comparisons between collections
• 💾 Copy data directly to the system clipboard
• 🎨 Browse your data in style with customizable color themes

Install Rust and Cargo, then install:

cargo install tongo

Install Nix, then clone this repo and install:

git clone [email protected]:drewzemke/tongo.git
cd tongo
nix-build

Then you can move the created binary somewhere on your path:

cp ./result/bin/tongo /usr/local/bin/tongo

1. Launch tongo in your terminal of choice:

tongo

2. Start creating a new connection by pressing A
3. Set a name for the connection and enter your database's connection string
4. After connecting, select a database and then a connection to connect to
5. Use the arrow keys to navigate through the data. Press n and p to move between pages

At any time (except when inputting text), you can bring up a commands list by pressing ? that will explain what actions are available to you and what their keybindings are.

Load a connection directly:

tongo --url mongodb://localhost:27017 

If you've previously stored a connection, you can load it by name:

tongo --connection local

Restore your most-recently-closed session in the app:

tongo --last

The first time you run tongo, a config.toml will be created for you in ~/.config/tongo on Mac and Linux and in <your-user-folder>\AppData\Roaming\tongo on Windows. (You can also see that file here.) It contains a full commented-out configuration together with descriptions of each configuration point.

You can fully customize the colors used in tongo's UI to your liking by creating a theme.toml in the same directory as your configuration file. Check out our small themes collection for some examples to get you started.

Please open an issue if you run into a problem while using tongo, or if there's a piece of functionality you wish it had! You're also welcome to make changes yourself and open a PR.