{"id":37715574,"url":"https://github.com/cfengine/cfengine-cli","last_synced_at":"2026-04-07T13:01:20.478Z","repository":{"id":278740527,"uuid":"936613332","full_name":"cfengine/cfengine-cli","owner":"cfengine","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-30T16:15:30.000Z","size":449,"stargazers_count":0,"open_issues_count":1,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-30T18:14:20.758Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cfengine.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-21T11:40:34.000Z","updated_at":"2026-03-30T16:15:12.000Z","dependencies_parsed_at":"2025-12-19T00:08:38.792Z","dependency_job_id":null,"html_url":"https://github.com/cfengine/cfengine-cli","commit_stats":null,"previous_names":["cfengine/cfengine-cli"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/cfengine/cfengine-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfengine%2Fcfengine-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfengine%2Fcfengine-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfengine%2Fcfengine-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfengine%2Fcfengine-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cfengine","download_url":"https://codeload.github.com/cfengine/cfengine-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cfengine%2Fcfengine-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31513382,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"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":[],"created_at":"2026-01-16T13:25:12.078Z","updated_at":"2026-04-07T13:01:20.472Z","avatar_url":"https://github.com/cfengine.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CFEngine command line interface (CLI)\n\nA CLI for humans to interact with CFEngine, enabling downloading and installing packages, building policy sets, deploying, and enforcing policy.\nIt is practically a wrapper around our other tools, like `cf-agent`, `cf-hub`, `cf-remote` and `cfbs`.\n\n**Warning:** This is an early version.\nThings might be missing or changed.\nProceed with caution and excitement.\n\n## Installation\n\nInstall using pip:\n\n```bash\npip install cfengine\n```\n\n## Usage\n\n### Run the CFEngine agent - evaluate and enforce policy\n\n```bash\ncfengine run\n```\n\n### CFEngine CLI help\n\n```bash\ncfengine help\n```\n\n### Print CFEngine CLI version\n\n```bash\ncfengine version\n```\n\n### Automatically format source code\n\n```bash\ncfengine format\n```\n\n### Check for errors in source code\n\n```bash\ncfengine lint\n```\n\nYou can also specify filenames or folders;\n\n```bash\ncfengine lint main.cf\n```\n\nWhen it finds a mistake, it points out where the problem is like this;\n\n```\n    \"Hello, CFEngine\"\n      ifvarclass =\u003e \"cfengine\";\n      ^--------^\nDeprecation: Use 'if' instead of 'ifvarclass' at main.cf:5:7\nFAIL: main.cf (1 error)\nFailure, 1 error in total.\n```\n\nNote that since we use a different parser than `cf-agent` / `cf-promises`, they are not 100% in sync.\n`cf-agent` could point out something as a syntax error, while `cfengine lint` does not and vice versa.\nWe aim to make the tree-sitter parser (used in this tool) more strict in general, so that when `cfengine lint` is happy with your policy, `cf-agent` will also accept it.\n(But the opposite is not a goal, that `cfengine lint` must accept any policy `cf-agent` would find acceptable).\n\n### Build a policy set\n\n```bash\ncfengine build\n```\n\n(This is equivalent to running `cfbs build`).\n\n## Supported platforms and versions\n\nThis tool will only support a limited number of platforms, it is not intended to run everywhere CFEngine runs.\nCurrently we are targeting:\n\n- Officially supported versions of macOS, Ubuntu, and Fedora.\n- Officially supported versions of Python.\n\nIt is not intended to be installed on all hosts in your infrastructure.\nCFEngine itself supports a wide range of platforms, but this tool is intended to run on your laptop, your workstation, or the hub in your infrastructure, not all the other hosts.\n\n## Backwards compatibility\n\nThis CLI is entirely intended for humans.\nIf you put it into scripts and automation, expect it to break in the future.\nIn order to make the user experience better, we might add, change, or remove commands.\nWe will also be experimenting with different types of interactive prompts and input.\n\n## Development, maintenance, contributions, and releases\n\nLooking for more information related to contributing code, releasing new versions or otherwise maintaining the CFEngine CLI?\nPlease see the [HACKING.md](./HACKING.md) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcfengine%2Fcfengine-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcfengine%2Fcfengine-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcfengine%2Fcfengine-cli/lists"}