{"id":19544868,"url":"https://github.com/ariary/wslight","last_synced_at":"2026-05-03T01:45:20.390Z","repository":{"id":109493503,"uuid":"395308381","full_name":"ariary/wslight","owner":"ariary","description":"Unix command translator on Windows cmd","archived":false,"fork":false,"pushed_at":"2021-09-27T07:16:43.000Z","size":65,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-26T05:42:21.787Z","etag":null,"topics":["bash","cmd","linux","pentest","pentest-tool","translate","windows","wsl"],"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/ariary.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":"2021-08-12T12:18:04.000Z","updated_at":"2024-07-31T22:21:35.000Z","dependencies_parsed_at":"2023-07-14T22:18:19.006Z","dependency_job_id":null,"html_url":"https://github.com/ariary/wslight","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ariary/wslight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariary%2Fwslight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariary%2Fwslight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariary%2Fwslight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariary%2Fwslight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ariary","download_url":"https://codeload.github.com/ariary/wslight/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ariary%2Fwslight/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262145203,"owners_count":23265892,"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":["bash","cmd","linux","pentest","pentest-tool","translate","windows","wsl"],"created_at":"2024-11-11T03:32:41.426Z","updated_at":"2025-11-04T11:03:07.241Z","avatar_url":"https://github.com/ariary.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\n\n\n# WSLight\n\nUnix command translator on Windows cmd (CLi)\n\n----\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003e\u003ca href=\"#-idea\"\u003e🔦 Idea\u003c/a\u003e\u003c/strong\u003e\n|\n\u003cstrong\u003e\u003ca href=\"#-installation\"\u003e💺 Installation\u003c/a\u003e\u003c/strong\u003e\n|\n\u003cstrong\u003e\u003ca href=\"#-usage\"\u003e🚀 Usage\u003c/a\u003e\u003c/strong\u003e\n|\n\u003cstrong\u003e\u003ca href=\"#-commands--features\"\u003e📝 Commands\u003c/a\u003e\u003c/strong\u003e\n|\n\u003cstrong\u003e\u003ca href=\"#limitsimprovements\"\u003e💭Limits/improvements\u003c/a\u003e\u003c/strong\u003e\n\u003c/p\u003e\n\n----\n\n\t\n## 🔦 Idea\n**Aim?**\n\nProviding equivalent of bash (Unix cmd) on Window\n\n\u003e Powershell \u0026 cmd already exist!\n\nExactly, but if you are not very comfortable with it and you have more references with unix commands\n\n\u003e [WSL](https://itsfoss.com/install-bash-on-windows/) already exists  and provides more utilities!\n\nYes but it requires  admin privileges to enable it. \n\nIf the command you want to launch is not available [see](#limitsimprovements)\n\n**Use cases?**\n\n - CTF, pentest etc with remote shell on windows device\n - Learn some `cmd.exe` command (by enabling debug with `+x`)\n\n\n ## 💺 Installation\n \nClone the repo and download the dependencies locally:\n```\ngit clone https://github.com/ariary/wslight.git\nmake before.build\n```\n\nTo build wslight :\n```\nmake build.wslight\n```\n\n ## 🚀 Usage \n \nMove `wslight.exe` binary on the windows machine on which you have a shell\n\n### Launch the cli\n```\nwslight.exe\n```\n\n\n### Launch equivalent of unix command in `cmd.exe`\nOnce the cli is launched\n```\n\u003e \u003cyour_command\u003e \u003cyour_argument\u003e\n```\nAs simple as that! \n\nsee [available commands](#-commands--features) or Type `help` to get available commands\n\n### Activate debug mode\n\nDebug mode is useful to see which command is in fact launch on cmd (to see the translation). It is useful to debug your behaviour or just learn some command\n```\n\u003e +x\n```\n\nDisable (by default) it with (`-x`)\n\n## 📝 Commands \u0026 Features\n\n - `wslight` could understand pipe commands\n\nList of available commands\n\n\n| Unix command  | flag accepted|\n|:--|:--|\n| hostname ||\n| pwd||\n| rm |-r,-f|\n| cp|-r |\n|grep| -R, -i|\n|ls|-l, -R, -a|\n|tree||\n|env||\n|cd| -, ~|\n\n*flags must be separated with spaces to be correctly parsed correctly*\n\nIf the command you want to launch is not available [see](#limitsimprovements)\n\n## 💭Limits/improvements\n\n**⚠️ Only a set of Unix command is available. I will provide more as things progress. Do not hesitate to let me know which one you will be interested in**\n\n*(Or a make a PR it is **simple**, just add a line in the `suggestions` slice (`cmd/wslight/main.go`) explaining what is the command, and  apply the command behavior in the `Translate` function (in `pkg/command/translate.go`)*\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fariary%2Fwslight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fariary%2Fwslight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fariary%2Fwslight/lists"}