{"id":13472221,"url":"https://github.com/cloudfoundry/cli","last_synced_at":"2025-05-12T13:20:20.062Z","repository":{"id":565384,"uuid":"12223350","full_name":"cloudfoundry/cli","owner":"cloudfoundry","description":"The official command line client for Cloud Foundry","archived":false,"fork":false,"pushed_at":"2025-05-12T09:14:16.000Z","size":177027,"stargazers_count":1772,"open_issues_count":63,"forks_count":946,"subscribers_count":231,"default_branch":"main","last_synced_at":"2025-05-12T13:19:40.736Z","etag":null,"topics":["cf-cli","cli","cloud-foundry","cloud-foundry-cli"],"latest_commit_sha":null,"homepage":"https://docs.cloudfoundry.org/cf-cli","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudfoundry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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":"2013-08-19T17:47:45.000Z","updated_at":"2025-05-09T13:32:16.000Z","dependencies_parsed_at":"2023-11-18T04:23:26.250Z","dependency_job_id":"e38ff15f-7bfd-436f-b2dc-63e6a805e967","html_url":"https://github.com/cloudfoundry/cli","commit_stats":{"total_commits":11780,"total_committers":456,"mean_commits":"25.833333333333332","dds":0.8852292020373514,"last_synced_commit":"eef705c5f6ec9c45de2e131b3b020fed0e18f8d0"},"previous_names":[],"tags_count":160,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry","download_url":"https://codeload.github.com/cloudfoundry/cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745196,"owners_count":21957319,"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":["cf-cli","cli","cloud-foundry","cloud-foundry-cli"],"created_at":"2024-07-31T16:00:53.075Z","updated_at":"2025-05-12T13:20:20.028Z","avatar_url":"https://github.com/cloudfoundry.png","language":"Go","readme":"\n\n\u003cimg src=\"https://raw.githubusercontent.com/cloudfoundry/logos/master/CF_Icon_4-colour.png\" alt=\"CF logo\" height=\"100\" align=\"left\"/\u003e\n\n# Cloud Foundry CLI\nThe official command line client for [Cloud Foundry](https://cloudfoundry.org).\n\nView the latest help for [**The v8 CLI**](https://cli.cloudfoundry.org/en-US/v8) -OR- [**The v7 CLI**](https://cli.cloudfoundry.org/en-US/v7), or run `cf help -a` to view the help for all commands available in your currently installed version.\n\n[![GitHub version](https://badge.fury.io/gh/cloudfoundry%2Fcli.svg)](https://github.com/cloudfoundry/cli/releases/latest)\n[![Documentation](https://img.shields.io/badge/docs-online-ff69b4.svg)](https://docs.cloudfoundry.org/cf-cli)\n[![Command help pages](https://img.shields.io/badge/command-help-lightgrey.svg)](https://cli.cloudfoundry.org)\n[![Slack](https://slack.cloudfoundry.org/badge.svg)](https://slack.cloudfoundry.org)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/cloudfoundry/cli/blob/main/LICENSE)\n\nCF CLI Binary Download Server's uptime:\n\n[![Downloads Uptime](https://uptime.com/devices/services/widget/689896/c6d4bb7ddd16186d/service?light)](https://uptime.com/devices/services/689896/01026e1a663caab4)\n\n***\n\u003cp align=\"left\"\u003e\n\u003cb\u003eSections: \u003c/b\u003e\n\u003cb\u003e\u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\u003c/b\u003e\n|\n\u003cb\u003e\u003ca href=\"#downloads\"\u003eDownload\u003c/a\u003e\u003c/b\u003e\n|\n\u003cb\u003e\u003ca href=\"#known-issues\"\u003eKnown Issues\u003c/a\u003e\u003c/b\u003e\n|\n\u003cb\u003e\u003ca href=\"#filing-issues--feature-requests\"\u003eBugs/Feature Requests\u003c/a\u003e\u003c/b\u003e\n|\n\u003cb\u003e\u003ca href=\"#plugin-development\"\u003ePlugin Development\u003c/a\u003e\u003c/b\u003e\n|\n\u003cb\u003e\u003ca href=\"#contributing--build-instructions\"\u003eContributing\u003c/a\u003e\u003c/b\u003e\n\u003c/p\u003e\n\n***\n## Getting Started\nDownload and install the cf CLI from the [Downloads Section](#downloads) for either the [v8 cf CLI](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide) or the [v7 cf CLI](https://github.com/cloudfoundry/cli/wiki/V7-CLI-Installation-Guide).\n\nOnce installed, you can log in and push an app.\nThere are now three supported versions of the cf CLI:\n1. The v8 cf CLI is backed by the [v3 CC API](http://v3-apidocs.cloudfoundry.org/version/3.85.0/) (with the exception of plugins). See [our v8 documentation](https://docs.cloudfoundry.org/cf-cli/v8.html) for more information.\n1. The v7 cf CLI is backed by the [v3 CC API](http://v3-apidocs.cloudfoundry.org/version/3.85.0/) (with the exception of plugins). See [our v7 documentation](https://docs.cloudfoundry.org/cf-cli/v7.html) for more information.\n\nView our [CLI v7 \u0026 v8 Versioning and Support Policy](https://github.com/cloudfoundry/cli/wiki/Versioning-and-Support-Policy) documentation.\n\nIf you have any questions, ask away on the #cli channel in [our Slack\ncommunity](https://slack.cloudfoundry.org/) and the\n[cf-dev](https://lists.cloudfoundry.org/archives/list/cf-dev@lists.cloudfoundry.org/)\nmailing list, or [open a GitHub issue](https://github.com/cloudfoundry/cli/issues/new).  \n\n## Contributing \u0026 Build Instructions\nPlease read the [contributors' guide](.github/CONTRIBUTING.md)\n\nIf you'd like to submit updated translations, please see the [i18n README](https://github.com/cloudfoundry/cli/blob/main/cf/i18n/README-i18n.md) for instructions on how to submit an update.\n\n![Example](.github/cf_example.gif)\n\nCheck out our [community contributed CLI plugins](https://plugins.cloudfoundry.org) to further enhance your CLI experience.\n\n## Downloads\n\n### Installation instructions\n- [Install V7](https://github.com/cloudfoundry/cli/wiki/V7-CLI-Installation-Guide)\n- [Install V8](https://github.com/cloudfoundry/cli/wiki/V8-CLI-Installation-Guide)\n- [Switching Between Multiple Versions](https://github.com/cloudfoundry/cli/wiki/Version-Switching-Guide)\n\n## Known Issues\n**Note:** For most up-to-date information in issues and workarounds please review [the open and closed github issues](https://github.com/cloudfoundry/cli/issues)\n\n* On Windows in Cygwin and Git Bash, interactive password prompts (in `cf login`) do not hide the password properly from stdout ([issue #1835](https://github.com/cloudfoundry/cli/issues/1835)). Please use an alternative command (non-interactive authentication `cf auth` instead of `cf login`) to work around this. Or, use the Windows `cmd` command line.\n* On Windows, `cf ssh` may not display correctly if the `TERM` is not set. We've found that setting `TERM` to `msys` fixes some of these issues.\n* On Windows, `cf ssh` will hang when run from the MINGW32 or MINGW64 shell. A workaround is to use PowerShell instead.\n* CF CLI/GoLang do not use OpenSSL. Custom/Self Signed Certificates need to be [installed in specific locations](https://docs.cloudfoundry.org/cf-cli/self-signed.html) in order to `login`/`auth` without `--skip-ssl-validation`.\n* API tracing to terminal (using `CF_TRACE=true`, `-v` option or `cf config --trace`) doesn't work well with some CLI plugin commands. Trace to file works fine. On Linux, `CF_TRACE=/dev/stdout` works too. See [this Diego-Enabler plugin issue](https://github.com/cloudfoundry-attic/Diego-Enabler/issues/6) for more information.\n* .cfignore used in `cf push` must be in UTF-8 encoding for CLI to interpret correctly. ([issue #281](https://github.com/cloudfoundry/cli/issues/281#issuecomment-65315518))\n* On Linux, when encountering message \"bash: .cf: No such file or directory\", ensure that you're using the [correct binary or installer for your architecture](https://askubuntu.com/questions/133389/no-such-file-or-directory-but-the-file-exists).\n* X-Cf-Warnings are printed through the `stdout`, if that's an inconvenience you could set `CF_RAISE_ERROR_ON_WARNINGS` and in that case warnings will be printed through the `stderr`. See [X-Cf-Warnings printed through stdout issue](https://github.com/cloudfoundry/cli/issues/2164)\n* False negative message for user org creation. CLI v7.0 and CLI v7.1 non-admin users with the user-org-creation feature flag enabled will experience a failure when running cf create-org. The command will explicitly fail attempting to grant the user an org-manager role. However, it actually succeeds because the user would have an org-manager role granted to them via CAPI and therefore be able to access their org. This issue is resolved as of CLI v7.2. See [Inconsistent v2/v3 behavior around creating new orgs + assigning roles](https://github.com/cloudfoundry/cloud_controller_ng/issues/1879). \n\n## Filing Issues \u0026 Feature Requests\n\nFirst, update to the [latest cli](https://github.com/cloudfoundry/cli/releases)\nand try the command again.\n\nIf the error remains or feature still missing, check the [open issues](https://github.com/cloudfoundry/cli/issues) and if not already raised please file a new issue with the requested details.\n\n## Plugin Development\n\nThe CF CLI supports external code execution via the plugins API. For more\ninformation follow:\n\n* [The CF CLI plugin development guide](https://github.com/cloudfoundry/cli/tree/main/plugin/plugin_examples)\n* [The official plugins repository](https://plugins.cloudfoundry.org/)\n\nWhen importing the plugin code use `import \"code.cloudfoundry.org/cli/plugin\"`.\nOlder plugins that import `github.com/cloudfoundry/cli/plugin` will still work\nas long they vendor the plugins directory.\n","funding_links":[],"categories":["Go","Command Line Tools"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry%2Fcli/lists"}