{"id":13797486,"url":"https://github.com/takashabe/btcli","last_synced_at":"2026-02-28T10:16:20.804Z","repository":{"id":144202118,"uuid":"125171149","full_name":"takashabe/btcli","owner":"takashabe","description":"btcli is a CLI client for the Bigtable. Has many read options and auto-completion.","archived":false,"fork":false,"pushed_at":"2023-02-25T02:01:25.000Z","size":144,"stargazers_count":20,"open_issues_count":4,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-18T12:46:35.349Z","etag":null,"topics":["bigtable","cli","gcp","go","golang","google-cloud-platform"],"latest_commit_sha":null,"homepage":"","language":"Go","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/takashabe.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":"2018-03-14T07:15:19.000Z","updated_at":"2022-05-25T07:15:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"451b4b8a-787a-42c3-a22f-e572b281df26","html_url":"https://github.com/takashabe/btcli","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takashabe%2Fbtcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takashabe%2Fbtcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takashabe%2Fbtcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takashabe%2Fbtcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/takashabe","download_url":"https://codeload.github.com/takashabe/btcli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253876760,"owners_count":21977629,"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":["bigtable","cli","gcp","go","golang","google-cloud-platform"],"created_at":"2024-08-04T00:00:21.936Z","updated_at":"2026-02-28T10:16:20.771Z","avatar_url":"https://github.com/takashabe.png","language":"Go","funding_links":[],"categories":["Tools"],"sub_categories":["Command-line"],"readme":"[![GoDoc](https://godoc.org/github.com/takashabe/btcli?status.svg)](https://godoc.org/github.com/takashabe/btcli)\n[![CircleCI](https://circleci.com/gh/takashabe/btcli.svg?style=shield)](https://circleci.com/gh/takashabe/btcli)\n[![Go Report Card](https://goreportcard.com/badge/github.com/takashabe/btcli)](https://goreportcard.com/report/github.com/takashabe/btcli)\n\n# btcli\n\nbtcli is a CLI client for the Bigtable. Has many read options and auto-completion.\n\n![tty](https://user-images.githubusercontent.com/681508/44247754-9ad3ea80-a221-11e8-9172-2cb709e1420a.gif)\n\n## Features\n\nbtcli is the cloud bigtable client tool.  Connect to your bigtable instances and any read items with auto-completion.\n\n_write commands are not implemented yet_\n\n### Compare to cbt\n\n`cbt` is an official bigtable client tool\n\n- btcli has auto-completion\n- btcli can decode a big-endian values\n- btcli has a filter for `value`, `version` and `family`\n- A print format that same as the cbt\n\n## Installation\n\n```sh\ngo get -u github.com/takashabe/btcli/cmd/btcli\n```\n\n_Require go1.11 or later and GO111MODULE environemnts_\n\n## Usage\n\n### Connect to bigtable\n\n```sh\nbtcli -project \u003cGCP_PROJECT_NAME\u003e -instance \u003cBIGTABLE_INSTANCE_ID\u003e -creds \u003cGCP_CREDENTIAL_FILE\u003e\n```\n\n_-creds e.g. `~/.config/gcloud/application_default_credentials.json`_\n\n### Subcommand and options\n\n- ls\n\nList tables\n\n```\nls          List tables\n```\n\n- count\n\nCount rows in a table\n\n```\ncount \u003ctable\u003e\n```\n\n- lookup\n\nRead from a single row\n\n```\nlookup \u003ctable\u003e \u003crow\u003e [family=\u003ccolumn_family\u003e] [version=\u003cn\u003e]\n        version        Read only latest \u003cn\u003e columns\n        decode         Decode big-endian value\n        decode-columns Decode big-endian value with columns. \u003ccolumn_name:\u003cstring|int|float\u003e[,\u003ccolumn_name:...\u003e]\n```\n\n- read\n\nRead rows\n\n```\nread \u003ctable\u003e [start=\u003crow\u003e] [end=\u003crow\u003e] [prefix=\u003cprefix\u003e] [family=\u003ccolumn_family\u003e] [version=\u003cn\u003e]\n        start          Start reading at this row\n        end            Stop reading before this row\n        prefix         Read rows with this prefix\n        value          Read rows with has value\n        family         Read only columns family with \u003ccolumns_family\u003e\n        version        Read only latest \u003cn\u003e columns\n        from           Read cells whose version is newer than or equal to this unixtime\n        to             Read cells whose version is older than this unixtime\n        decode         Decode big-endian value\n        decode-columns Decode big-endian value with columns. \u003ccolumn_name:\u003cstring|int|float\u003e[,\u003ccolumn_name:...\u003e]\n```\n\n### Environments\n\n| Env | Detail |\n| --- | --- |\n| BTCLI_DECODE_TYPE | set the default decoding type.\u003cbr\u003evalues: `string, int, float` |\n\n## Support commands\n\n### Read commands\n\n- [x] ls\n- [x] count\n- [x] lookup\n    - [x] version\n    - [x] decode\n    - [x] decode-columns\n- [x] read\n    - [x] start\n    - [x] end\n    - [x] prefix\n    - [x] value\n    - [x] family\n    - [x] version\n    - [x] from\n    - [x] to\n    - [x] decode\n    - [x] decode-columns\n\n### Write commands\n\n- [ ] createfamily\n- [ ] createtable\n- [ ] deletecolumn\n- [ ] deletefamily\n- [ ] deleterow\n- [ ] deletetable\n- [ ] set\n- [ ] setgcpolicy\n\n### Others\n\n- [x] help\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakashabe%2Fbtcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftakashabe%2Fbtcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakashabe%2Fbtcli/lists"}