Go to file
Joop Kiefte e21177ed03 Change import path 2023-10-14 01:27:00 +01:00
.gitignore Add gitignore. Adding .dolt so I can test in the same directory. 2023-09-28 22:33:22 +01:00
LICENSE.md Add MIT license 2023-09-28 22:27:34 +01:00
README.md Add some documentation to the README 2023-09-28 22:44:02 +01:00
go.mod Change import path 2023-10-14 01:27:00 +01:00
main.go Table check stopped debby from working when not in an already existing database, e.g. with help or init. 2023-10-14 01:23:46 +01:00



Debby is a CLI tool that wraps Dolt and Visidata to enable you to do quick database and table interactions on the command line.

Instalation instructions

  1. Install VisiData. Any version should work, although I recommend getting a later version.
  2. Install Dolt. Again, it should work with any version, but tested with the most recent ones.
  3. Make sure you have Go installed for compiling debby.
  4. go install git.kiefte.eu/lapingvino/debby@latest

If you have ~/go/bin on your path, you can now invoke debby directly, otherwise you might want to move it to a location that is in your path.


Debby has two main ways to use it. Running it without any arguments starts an interactive session. Here you can run any dolt command without the dolt part, e.g. status, add and commit to perform a normal versioning sequence. Of course the sql command works as well, but debby's special sauce is in the run command which will open the result of your query in visidata. If you want to do anything with this result, save it to a new file and e.g. import it.

The edit command on the other hand just takes a table name as input but does import the changes back into dolt. It might not be the best option for massive tables, but should be fine for most reasonable tables.

The create command lets you create a table from scratch. You can edit the headers with ^, add new rows with a, add new columns with i, delete rows with d, hide columns with - (they are not deleted but everything hidden won't be saved) and edit any cell with e. Check the visidata documentation for more advanced tricks. When you are done, debby will check the schema that dolt wants to give to this table and opens it in your default editor so you can adjust the schema before you submit it.

That's it for now. Feel free to ping me about any suggestions for improvement!