{"id":20373199,"url":"https://github.com/simatwa/sqlite3-cli-manager","last_synced_at":"2026-04-20T04:36:02.526Z","repository":{"id":261627345,"uuid":"884709838","full_name":"Simatwa/sqlite3-cli-manager","owner":"Simatwa","description":"Python tool designed to interact with SQLite databases via command-line interface","archived":false,"fork":false,"pushed_at":"2024-11-09T16:37:30.000Z","size":85,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-15T06:49:42.975Z","etag":null,"topics":["database-manag","database-manager","sqlite","sqlite-manager","sqlite3","sqlite3-manager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Simatwa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-07T08:50:44.000Z","updated_at":"2024-11-09T16:37:33.000Z","dependencies_parsed_at":"2024-11-07T15:46:50.427Z","dependency_job_id":"991030f6-714f-4da7-b91e-68d9b7cd6542","html_url":"https://github.com/Simatwa/sqlite3-cli-manager","commit_stats":null,"previous_names":["simatwa/sqlite3-cli-manager"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fsqlite3-cli-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fsqlite3-cli-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fsqlite3-cli-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fsqlite3-cli-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simatwa","download_url":"https://codeload.github.com/Simatwa/sqlite3-cli-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241921836,"owners_count":20042763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database-manag","database-manager","sqlite","sqlite-manager","sqlite3","sqlite3-manager"],"created_at":"2024-11-15T01:17:06.237Z","updated_at":"2026-04-20T04:35:57.497Z","avatar_url":"https://github.com/Simatwa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003esqlite3-cli-manager\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/Simatwa/sqlite3-cli-manager/blob/main/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/static/v1?logo=GPL\u0026color=Blue\u0026message=MIT\u0026label=License\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/sqlite3-cli-manager/actions/workflows/python-package.yml\"\u003e\u003cimg alt=\"Python Package flow\" src=\"https://github.com/Simatwa/sqlite3-cli-manager/actions/workflows/python-test.yml/badge.svg?branch=main\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/sqlite3-cli-manager/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/Simatwa/sqlite3-cli-manager/total?label=Asset%20Downloads\u0026color=success\" alt=\"Downloads\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/sqlite3-cli-manager/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/Simatwa/sqlite3-cli-manager?color=success\u0026label=Release\u0026logo=github\" alt=\"Latest release\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/sqlite3-cli-manager/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/release-date/Simatwa/sqlite3-cli-manager?label=Release date\u0026logo=github\" alt=\"release date\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nThis tool is designed to interact with SQLite databases via command-line interface. Other than just issuing the sql staments by yourself, you can let AI generate sql statements based on your prompt.\n\n# Pre-requisite\n\n- [x] [Python\u003e=3.12](https://python.org) *(optional)*\n\n# Installation and Usage\n\n## Installation\n\n- Clone repo and install requirements\n\n```sh\ngit clone https://github.com/Simatwa/sqlite3-cli-manager.git\ncd sqlite3-cli-manager\npip install -r requirements.txt\n```\n\nAlternatively, you can download standalone executables for your system from [here](https://github.com/Simatwa/sqlite3-cli-manager/releases/latest).\n\n## Usage\n\n\u003cdetails open\u003e\n\n\u003csummary\u003e\u003ccode\u003e$ python manager.py --help\u003c/code\u003e\u003c/summary\u003e\n\n```\nUsage: manager.py [OPTIONS] COMMAND [ARGS]...\n\n  Interact with SQLite databases via command-line interface\n\nOptions:\n  --version  Show the version and exit.\n  --help     Show this message and exit.\n\nCommands:\n  execute       Run sql statements against database [AUTO-COMMITS]\n  interactive   Execute sql statements interactively\n  show-columns  List columns for a particular table\n  show-tables   List tables contained in the database\n\n```\n\n\u003c/details\u003e\n\n### Execute\n\n- The `execute` command accepts multiple sql statements and run each against the database before auto-commiting the changes.\n\u003cdetails open\u003e\n\n\u003csummary\u003e\u003ccode\u003e$ python manager.py execute --help \u003c/code\u003e\u003c/summary\u003e\n\n```\nUsage: sqlite-manager execute [OPTIONS] DATABASE\n\n  Run sql statements against database [AUTO-COMMITS]\n\nOptions:\n  -s, --sql TEXT  Sql statements  [required]\n  -j, --json      Stdout results in json format\n  -q, --quiet     Do not stdout results\n  --help          Show this message and exit.\n```\n\n\u003c/details\u003e\n\n`$ sqlite-manager execute \u003cpath-to-sqlite3-database\u003e -s \"\u003csql-statement\u003e\"`\n\n\u003e For example:\n\u003cdetails\u003e\n\u003csummary\u003e\u003ccode\u003e$ python manager execute test.db -s \"select * from linux\"\u003c/code\u003e\u003c/summary\u003e\n\n``` \n┏━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓\n┃ Index ┃ Col. 1 ┃ Col. 2 ┃ Col. 3    ┃ Col. 4 ┃ Col. 5 ┃ Col. 6     ┃ Col. 7     ┃\n┡━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩\n│   0   │ 1      │ Parrot │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:22:13   │ 13:22:13   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   1   │ 2      │ Kali   │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:22:21   │ 13:22:21   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   2   │ 3      │ Ubuntu │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:48:18   │ 13:48:18   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   3   │ 4      │ Fedora │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:48:49   │ 13:48:49   │\n└───────┴────────┴────────┴───────────┴────────┴────────┴────────────┴────────────┘\n```\n\u003c/details\u003e\n\n---\n\n### Interactive\n\n- The `interactive` command launches a recursive prompt that takes in sql statements and proceed to run them against the database.\n\u003cdetails open\u003e\n\n\u003csummary\u003e\u003ccode\u003e$ python manager.py interactive --help \u003c/code\u003e\u003c/summary\u003e\n\n```\nUsage: manager.py interactive [OPTIONS] DATABASE\n\n  Execute sql statements interactively\n\nOptions:\n  -c, --color TEXT           Results font color\n  -j, --json                 Stdout results in json format\n  -a, --auto-commit          Enable auto-commit\n  -C, --disable-coloring     Stdout prompt text in white font color\n  -S, --disable-suggestions  Do not suggest sql statements\n  -N, --new-history-thread   Start a new history thread\n  --help                     Show this message and exit.\n```\n\n\u003c/details\u003e\n\n`$ sqlite-manager execute \u003cpath-to-sqlite3-database\u003e -s \"\u003csql-statement\u003e\"`\n\n\u003e For example:\n\u003cdetails\u003e\n\u003csummary\u003e\u003ccode\u003e$ python manager.py interactive test.db \u003c/code\u003e\u003c/summary\u003e\n\n``` \nWelcome to interactive sqlite3-db manager.\nRun help or h \u003ccommand\u003e for usage info.\nRepo : https://github.com/Simatwa/sqlite3-cli-manager\n \n╰─\u003eselect * from Linux\n┏━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓\n┃ Index ┃ Col. 1 ┃ Col. 2 ┃ Col. 3    ┃ Col. 4 ┃ Col. 5 ┃ Col. 6     ┃ Col. 7     ┃\n┡━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩\n│   0   │ 1      │ Parrot │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:22:13   │ 13:22:13   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   1   │ 2      │ Kali   │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:22:21   │ 13:22:21   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   2   │ 3      │ Ubuntu │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:48:18   │ 13:48:18   │\n├───────┼────────┼────────┼───────────┼────────┼────────┼────────────┼────────────┤\n│   3   │ 4      │ Fedora │ community │ None   │ 1      │ 2024-11-07 │ 2024-11-07 │\n│       │        │        │           │        │        │ 13:48:49   │ 13:48:49   │\n└───────┴────────┴────────┴───────────┴────────┴────────┴────────────┴────────────┘\n╭─[Smartwa@localhost](smartBet2.db)~[🕒16:55:56-💻00:00:03-⚡-3.9s] \n╰─\u003eselect * from \n                  select * from Linux  \n                  select * from sqlite_schema\n                  select * from sqlite_temp_schema\n\n\n\n```\n\u003c/details\u003e\n\n---\n\n### Show-columns\n\n- The `show-columns` command lists the columns for a particular table in the database.\n\u003cdetails open\u003e\n\n\u003csummary\u003e\u003ccode\u003e$ python manager.py show-columns --help \u003c/code\u003e\u003c/summary\u003e\n\n```\nUsage: sqlite-manager show-columns [OPTIONS] DATABASE TABLE\n\n  List columns for a particular table\n\nOptions:\n  -j, --json  Stdout results in json format\n  --help      Show this message and exit.\n```\n\n\u003c/details\u003e\n\n`$ python manager.py show-columns \u003cpath-to-sqlite3-database\u003e \u003ctable-name\u003e\"`\n\n\u003e For example:\n\u003cdetails\u003e\n\u003csummary\u003e\u003ccode\u003e$ python manager.py show-columns test.db linux\u003c/code\u003e\u003c/summary\u003e\n\n```\n┏━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┓\n┃ Index ┃ Col. 1 ┃ Col. 2        ┃ Col. 3        ┃ Col. 4 ┃ Col. 5       ┃ Col. 6 ┃\n┡━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━┩\n│   0   │ 0      │ id            │ INTEGER       │ 0      │ None         │ 1      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   1   │ 1      │ distro        │ TEXT          │ 1      │ None         │ 0      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   2   │ 2      │ org           │ TEXT          │ 0      │ 'community'  │ 0      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   3   │ 3      │ logo          │ BLOB NULLABLE │ 0      │ None         │ 0      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   4   │ 4      │ is_maintained │ BOOLEAN       │ 0      │ 1            │ 0      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   5   │ 5      │ updated_on    │ TIMESTAMP     │ 0      │ CURRENT_TIM… │ 0      │\n├───────┼────────┼───────────────┼───────────────┼────────┼──────────────┼────────┤\n│   6   │ 6      │ created_at    │ TIMESTAMP     │ 1      │ CURRENT_TIM… │ 0      │\n└───────┴────────┴───────────────┴───────────────┴────────┴──────────────┴────────┘\n```\n\u003c/details\u003e\n\n---\n\n### Show-tables\n\n- The `show-tables` command lists the available tables across the entire database.\n\u003cdetails open\u003e\n\n\u003csummary\u003e\u003ccode\u003e$ python manager.py show-tables --help \u003c/code\u003e\u003c/summary\u003e\n\n```\nUsage: manager.py show-tables [OPTIONS] DATABASE\n\n  List tables contained in the database\n\nOptions:\n  -j, --json  Stdout results in json format\n  --help      Show this message and exit.\n```\n\n\u003c/details\u003e\n\n`$ python manager.py show-tables \u003cpath-to-sqlite3-database\u003e`\n\n\u003e For example:\n\u003cdetails\u003e\n\u003csummary\u003e\u003ccode\u003e$ python manager.py show-tables test.db\u003c/code\u003e\u003c/summary\u003e\n\n```\n┏━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━┳━━━━━━━━┓\n┃ Index ┃ Col. 1 ┃ Col. 2             ┃ Col. 3 ┃ Col. 4 ┃ Col. 5 ┃ Col. 6 ┃\n┡━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━╇━━━━━━━━┩\n│   0   │ main   │ sqlite_sequence    │ table  │ 2      │ 0      │ 0      │\n├───────┼────────┼────────────────────┼────────┼────────┼────────┼────────┤\n│   1   │ main   │ Linux              │ table  │ 7      │ 0      │ 0      │\n├───────┼────────┼────────────────────┼────────┼────────┼────────┼────────┤\n│   2   │ main   │ sqlite_schema      │ table  │ 5      │ 0      │ 0      │\n├───────┼────────┼────────────────────┼────────┼────────┼────────┼────────┤\n│   3   │ temp   │ sqlite_temp_schema │ table  │ 5      │ 0      │ 0      │\n└───────┴────────┴────────────────────┴────────┴────────┴────────┴────────┘\n```\n\u003c/details\u003e\n\n# Contrubutions\n\nContributions are always welcoming. Consider implementing new feature or fixing my bad code.\n\n## ToDo\n\n1. [ ] Let AI generate sql statements based on user's prompt.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Fsqlite3-cli-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimatwa%2Fsqlite3-cli-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Fsqlite3-cli-manager/lists"}