Skip to content

vaaleyard/bongo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bongo

A mongo management TUI dashboard

lines of code Code Size help wanted good first issue License: MIT

Screenshot

screenshot

Features

  • Navigate through database collections, views and users in a tree view
  • Run a database command and view it's output (you can also copy it to the clipboard)
  • Vim keybindings

Installation

With the binary

Download the binary for your distribution in the releases page.

With go install

go install github.com/vaaleyard/bongo@latest

With make

git clone https://github.com/vaaleyard/bongo.git
make build 

Usage

Export your mongodb uri and run bongo:

export MONGODB_URI='mongodb:https://user:password@host:27017/'
bongo --mongodb-uri $MONGODB_URI

Keybindings

esc: go to normal mode (unfocus)
d/D: focus the database finder block
i/I/: (colon) : focus the input block
p/P: focus the preview block
y/Y: (if preview is focused) [yank/copy] the content of preview block
s/S: (if database tree is focused) select the database to which database the command in input block will run
q/Q/Ctrl-c: quit

Features to do

  • Make a preview when viewing the items in the tree
  • Make an input field to run commands against the mongo connection, i.g. db.getUsers()
  • Create multiple connections with tabs
  • Improve colorscheme
  • Improve mongo connection handling
  • Create a help page/widget
  • Better cluster handling (maybe one page to add connections, etc.)
  • Expand input box if user paste a big mongo command

Contributing

See CONTRIBUTING.md.

License

MIT