{"id":15354033,"url":"https://github.com/riron/cfa","last_synced_at":"2026-05-10T19:18:07.314Z","repository":{"id":72721221,"uuid":"260091173","full_name":"Riron/cfa","owner":"Riron","description":"Run docker-compose commands on your project from anywhere 🐤","archived":false,"fork":false,"pushed_at":"2024-04-16T15:11:10.000Z","size":21,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-27T14:53:12.948Z","etag":null,"topics":["cli","docker","docker-compose","productivity","utility"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Riron.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-04-30T02:06:50.000Z","updated_at":"2024-04-16T15:11:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"ad1949fc-9d8d-4ee6-8fd6-42138de4defc","html_url":"https://github.com/Riron/cfa","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"0384a39b595e3e9d0781d90b1dba611a9b806a21"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Riron/cfa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Riron%2Fcfa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Riron%2Fcfa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Riron%2Fcfa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Riron%2Fcfa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Riron","download_url":"https://codeload.github.com/Riron/cfa/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Riron%2Fcfa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32868347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"ssl_error","status_checked_at":"2026-05-10T13:40:02.145Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli","docker","docker-compose","productivity","utility"],"created_at":"2024-10-01T12:16:47.288Z","updated_at":"2026-05-10T19:18:07.286Z","avatar_url":"https://github.com/Riron.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐤 Compose from anywhere\n\nSmall utility to run `docker compose` commands on your projects without having to `cd` into them.\n\nIt is heavily inspired from [Captain](https://github.com/jenssegers/captain) but aims at being fully transparent by forwarding commands to the `docker compose` [CLI](https://docs.docker.com/compose/reference/), so that all the commad you already use and know keep working out of the box.\n\n```bash\n# Replace\n$ cd path/to/my/project1\n$ docker compose down\n\n$ cd other/path/project2\n$ docker compose up -d\n\n# By\n$ cfa project1 down\n$ cfa project2 up -d\n```\n\n**cfa** scans your directories looking for a `docker-compose.yml` file. Every folder meeting the condition are marked as candidate projects that you can operate on from anywhere.\n\nNote that the project names are fuzzy searched. If several projects have a similar name, `cfa` will give you a list to chose from.\n\n## Installing\n\nUsing Compose from anywhere is easy. First, use `go get` to install the latest version of the library. This command will install the `cfa` executable along with the library and its dependencies:\n\n```bash\ngo get -u github.com/riron/cfa\n```\n\nIf you don't have Go installed on your machine you can download the executables.\n\n### MacOSX\n\n```\ncurl -L https://github.com/riron/cfa/releases/download/v1/cfa_darwin_amd64 \u003e /usr/local/bin/cfa \u0026\u0026 chmod +x /usr/local/bin/cfa\n```\n\n### Linux\n\n```\ncurl -L https://github.com/riron/cfa/releases/download/v1/cfa_linux_amd64 \u003e /usr/local/bin/cfa \u0026\u0026 chmod +x /usr/local/bin/cfa\n```\n\n### Windows\n\nDownload [the executable](https://github.com/riron/cfa/releases/download/v1/cfa_windows_amd64.exe), rename it to `cfa.exe` and add it to your path\n\n## Usage\n\n```bash\n$ cfa\nManage your compose projects from anywhere\n\ncfa allows you to use the same compose CLI you already know\nbut without the need to cd into your directories.\nJust pass your project name as the first argument\nand run your compose command on it.\n\nUsage:\n  cfa [flags] [project] [compose command]\n\nExamples:\ncfa my_project up -d\ncfa -u=dev my_project exec my_container sh\ncfa -f=my_pro\ncfa -s\n\nFlags:\n  -f, --find string     List projects corresponding to search\n  -h, --help            help for cfa\n  -l, --list            List all available projects\n  -s, --stop            Stop all running containers\n  -u, --suffix string   Use a suffixed compose file (ex: -u=dev will use the docker-compose.dev.yml file)\n```\n\n## Config\n\nTwo environment variables allow you ton configure **cfa**\n\n| ENV       | Description                                      | Default             |\n| --------- | ------------------------------------------------ | ------------------- |\n| CFA_ROOT  | Root folder from which to scan for compose files | User home directory |\n| CFA_DEPTH | Maximum scan depth                               | 5                   |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friron%2Fcfa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friron%2Fcfa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friron%2Fcfa/lists"}