{"id":13581807,"url":"https://github.com/influxdata/influx-cli","last_synced_at":"2025-05-15T06:02:48.887Z","repository":{"id":37072436,"uuid":"356362815","full_name":"influxdata/influx-cli","owner":"influxdata","description":"CLI for managing resources in InfluxDB v2","archived":false,"fork":false,"pushed_at":"2025-02-03T12:49:48.000Z","size":1736,"stargazers_count":68,"open_issues_count":101,"forks_count":24,"subscribers_count":38,"default_branch":"main","last_synced_at":"2025-04-14T08:16:29.903Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/influxdata.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support.mk","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-09T18:21:15.000Z","updated_at":"2025-04-11T03:21:45.000Z","dependencies_parsed_at":"2024-06-18T15:28:50.333Z","dependency_job_id":"b34fd601-dc8e-434d-b542-c3549d10292d","html_url":"https://github.com/influxdata/influx-cli","commit_stats":{"total_commits":248,"total_committers":28,"mean_commits":8.857142857142858,"dds":0.5362903225806452,"last_synced_commit":"cea19bffa15fefc7cee211b7a9be672f8e5ef637"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finflux-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finflux-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finflux-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finflux-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/influxdata","download_url":"https://codeload.github.com/influxdata/influx-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248844000,"owners_count":21170499,"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":[],"created_at":"2024-08-01T15:02:15.221Z","updated_at":"2025-04-14T08:16:37.631Z","avatar_url":"https://github.com/influxdata.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# influx-cli\n\nCLI for managing resources in InfluxDB v2\n\n## Motivation\n\nThis repository decouples the `influx` CLI from the OSS `influxdb` codebase. Our goals are to:\n1. Make it easier to keep the CLI up-to-date with InfluxDB Cloud API changes\n2. Enable faster turn-around on fixes/features that only affect the CLI\n3. Allow the CLI to be built \u0026 released for a wider range of platforms than the server can support\n\n## Building the CLI\n\nFollow these steps to build the CLI. If you're updating your CLI build, see *Updating openapi* below.\n1. Clone this repo (influx-cli) and change to your _influx-cli_ directory.\n\n   ```\n   git clone git@github.com:influxdata/influx-cli.git\n   cd influx-cli\n   ```\n   \n2. Build the CLI. The `make` and `make influx` commands write the new binary to `bin/$(GOOS)/influx`.\n   \n   ```\n   make\n   ```\n   \n### Updating openapi\n\nIf you change or update your branch, you may also need to update `influx-cli/openapi` and regenerate the client code.\n`influx-cli/openapi` is a Git submodule that contains the underlying API contracts and client used by the CLI.\nWe use [`OpenAPITools/openapi-generator`](https://github.com/OpenAPITools/openapi-generator) to generate\nthe HTTP client.\n\nTo update, run the following commands in your `influx-cli` repo:\n\n1. Update the _openapi_ Git submodule. The following command pulls the latest commits for the branch and all submodules.\n\n   `git pull --recurse-submodules`\n   \n2. With [Docker](https://docs.docker.com/get-docker/) running locally, regenerate _openapi_.\n\n   `make openapi`\n   \n3. Rebuild the CLI\n\n   `make`\n \n## Running the CLI\n\nAfter building, use `influx -h` to see the list of available commands.\n\n### Enabling Completions\n\nThe CLI supports generating completions for `bash`, `zsh`, and `powershell`. To enable completions for a\nsingle shell session, run one of these commands:\n```\n# For bash:\nsource \u003c(influx completion bash)\n# For zsh:\nsource \u003c(influx completion zsh)\n# For pwsh:\nInvoke-Expression ((influx completion powershell) -join \"`n`\")\n```\nTo enable completions across sessions, add the appropriate line to your shell's login profile (i.e. `~/.bash_profile`).\n\n## Testing\n\nRun `make test` to run unit tests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfluxdata%2Finflux-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfluxdata%2Finflux-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfluxdata%2Finflux-cli/lists"}