https://github.com/taigrr/teaqlite
Tea-Quill-ite: A CLI-based sqlite browser
https://github.com/taigrr/teaqlite
bubbletea go sqlite
Last synced: 28 days ago
JSON representation
Tea-Quill-ite: A CLI-based sqlite browser
- Host: GitHub
- URL: https://github.com/taigrr/teaqlite
- Owner: taigrr
- License: 0bsd
- Created: 2025-07-13T04:29:06.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-07-14T04:12:41.000Z (11 months ago)
- Last Synced: 2025-07-14T06:02:50.585Z (11 months ago)
- Topics: bubbletea, go, sqlite
- Language: Go
- Homepage:
- Size: 125 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# TeaQLite
A colorful-but-minimal terminal user interface for browsing SQLite databases built with [Bubble Tea](https://github.com/charmbracelet/bubbletea).
## Features
- **Table Browser**: Browse all tables in your SQLite database with pagination
- **Fuzzy Search**: Search tables by name using `/` key with ranked results
- **Data Viewer**: View table data with pagination and row highlighting
- **Row Detail Modal**: View individual rows in a 2-column format (Column | Value)
- **Cell Editing**: Edit individual cell values with live database updates
- **SQL Query Interface**: Execute custom SQL queries with parameter support
- **Vim-style Navigation**: `j`/`k` movement, `gg`/`G` jumps, and more
- **Responsive Design**: Adapts to terminal size and fits content to screen
## Install
```bash
go install github.com/taigrr/teaqlite@latest
```
Or build from source:
```bash
git clone https://github.com/taigrr/teaqlite.git
cd teaqlite
go build -o teaqlite .
```
## Usage
```bash
teaqlite
```
Example with the included sample database:
```bash
teaqlite sample.db
```
## Keybindings
### Global
| Key | Action |
| -------- | ----------- |
| `ctrl+c` | Quit |
| `ctrl+z` | Suspend |
| `ctrl+g` | Toggle help |
### Table List
| Key | Action |
| --------- | -------------- |
| `↑`/`k` | Move up |
| `↓`/`j` | Move down |
| `←`/`h` | Previous page |
| `→`/`l` | Next page |
| `enter` | Open table |
| `/` | Search tables |
| `gg` | Jump to start |
| `G` | Jump to end |
| `s` | SQL query mode |
| `r` | Refresh |
| `esc` | Clear filter |
### Table Data
| Key | Action |
| --------- | --------------- |
| `↑`/`k` | Move up |
| `↓`/`j` | Move down |
| `←`/`h` | Previous page |
| `→`/`l` | Next page |
| `enter` | View row detail |
| `/` | Search data |
| `gg` | Jump to start |
| `G` | Jump to end |
| `q` | Back to tables |
| `s` | SQL query mode |
| `r` | Refresh |
### Row Detail
| Key | Action |
| ------- | --------- |
| `↑`/`k` | Move up |
| `↓`/`j` | Move down |
| `e` | Edit cell |
| `q` | Back |
| `esc` | Back |
### SQL Query Mode
| Key | Action |
| ------- | --------------- |
| `enter` | Execute query |
| `esc` | Back to tables |
| `↑`/`k` | Navigate results |
| `↓`/`j` | Navigate results |
| `e` | Edit query |
### Edit Cell
| Key | Action |
| ------- | ------ |
| `enter` | Save |
| `esc` | Cancel |
## License
[0BSD](LICENSE)