{"id":31017127,"url":"https://github.com/sameerjs6/zed-cli-win-unofficial","last_synced_at":"2025-09-13T07:50:07.365Z","repository":{"id":299065738,"uuid":"989255825","full_name":"SameerJS6/zed-cli-win-unofficial","owner":"SameerJS6","description":"Unofficial CLI for launching and managing Zed on Windows. Built in Go.","archived":false,"fork":false,"pushed_at":"2025-06-14T13:00:24.000Z","size":526,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T13:30:03.072Z","etag":null,"topics":["cli","golang","zed","zed-editor","zed-industries","zed-windows"],"latest_commit_sha":null,"homepage":"https://zedcli.sameerjs.com","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/SameerJS6.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}},"created_at":"2025-05-23T18:51:26.000Z","updated_at":"2025-06-14T13:01:29.000Z","dependencies_parsed_at":"2025-06-14T13:30:12.727Z","dependency_job_id":"fd53066d-dabf-4f81-aff1-c56d2399beac","html_url":"https://github.com/SameerJS6/zed-cli-win-unofficial","commit_stats":null,"previous_names":["sameerjs6/zed-cli-win-unofficial"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/SameerJS6/zed-cli-win-unofficial","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SameerJS6%2Fzed-cli-win-unofficial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SameerJS6%2Fzed-cli-win-unofficial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SameerJS6%2Fzed-cli-win-unofficial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SameerJS6%2Fzed-cli-win-unofficial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SameerJS6","download_url":"https://codeload.github.com/SameerJS6/zed-cli-win-unofficial/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SameerJS6%2Fzed-cli-win-unofficial/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274935969,"owners_count":25376835,"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","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","golang","zed","zed-editor","zed-industries","zed-windows"],"created_at":"2025-09-13T07:50:06.403Z","updated_at":"2025-09-13T07:50:07.355Z","avatar_url":"https://github.com/SameerJS6.png","language":"Go","readme":"## Zed CLI For Windows (Unofficial)\n\nThis project is an unofficial Windows CLI for Zed (built from source). It provides all basic features:\n\n- Launching Zed (`zed`)\n- Launching \u0026 Managing mulitple instance of zed\n- Opening directories or projects with `zed \u003cpath\u003e`\n- Adding an 'Open with Zed' context menu integration.\n\n![Zed CLI for Windows (Unofficial) – Launch, manage, and integrate Zed editor from your terminal on Windows](./public/main-image.png)\n\n## Table of Content\n\n- [Usage](#usage)\n- [Features \u0026 Behavior](#features--behavior)\n  - [Auto-Directory Creation](#auto-directory-creation)\n  - [Single Instance Limitation (Zed versions below v0.177.0)](#single-instance-limitation-zed-versions-below-v01770)\n- [Installation](#installation)\n  - [Native Installation Scripts](#native-installation-scripts)\n  - [Scoop](#scoop)\n  - [Chocolatey (Coming Soon)](#chocolatey-coming-soon)\n  - [Manual (GitHub Release)](#manual-github-release)\n- [Disclaimer \u0026 Affiliation](#disclaimer--affiliation)\n- [License](#license)\n\n## Usage\n\n| Command                 | Description                          | Example                           |\n| ----------------------- | ------------------------------------ | --------------------------------- |\n| `zed`                   | Open Zed with last project           | `zed`                             |\n| `zed .`                 | Open current directory               | `zed .`                           |\n| `zed \u003cpath\u003e`            | Open specific file or directory      | `zed C:\\projects\\my-app`          |\n| `zed config get`        | Get current Zed executable path      | `zed config get`                  |\n| `zed config set \u003cpath\u003e` | Set Zed executable path              | `zed config set \"C:\\Zed\\zed.exe\"` |\n| `zed context install`   | Install \"Open with Zed\" context menu | `zed context install`             |\n| `zed context uninstall` | Remove \"Open with Zed\" context menu  | `zed context uninstall`           |\n\n\u003e [!NOTE]\n\u003e Use `zed context install` to add \"Open with Zed\" to your Windows context menu for easy right-click access. By default, it's not installed.\n\n## Features \u0026 Behavior\n\n### Auto-Directory Creation\n\nWhen opening a non-existent path, the CLI automatically creates the required directories before launching Zed:\n\n```bash\nzed D:\\projects\\monkeypress\n```\n\nIn this example, if `monkeypress` doesn't exist but `D:\\projects\\` does, the CLI will:\n\n1. Create the `monkeypress` directory under `D:\\projects\\`\n2. Open the newly created directory in Zed\n\n![A terminal-like window with a dark background shows a command and its output. The command entered is `zed D:\\projects\\monkeypress`. Below it are three lines of output](./public/auto-directory.png)\n\n### Single Instance Limitation (Zed versions below v0.177.0)\n\n**Important:** This CLI cannot open multiple Zed windows if Zed is already running — but only when using Zed versions below `v0.177.0`. This limitation exists because:\n\n- The CLI is unofficial and not integrated with Zed’s internal systems\n- It does not have access to Zed’s IPC (Inter-Process Communication), which handles multi-instance support in official workflows\n\nIf you're using an older version and attempt to open a new project while Zed is running, the CLI will notify you about this limitation.\n\n\u003e [!NOTE]\n\u003e This limitation does not apply to Zed versions v0.177.0 and above.\n\n![\nA retro-style terminal graphic displays a large “UPGRADE REQUIRED” message in blocky, pixelated text. Below it, a red warning icon is shown with the message: “Your Zed version is too old! This feature requires Zed v0.177.0 or newer. Please update Zed or close the existing window.” At the bottom, a boxed section shows the current version (v0.176.0.3), a warning about the required version, and two lightbulb-marked solutions.](./public/upgrade-required.png)\n\n## Installation\n\nRecommended installation methods in order of preference:\n\n1. [Native Installation Scripts](#native-installation-scripts)\n2. [Scoop](#scoop)\n3. [Chocolatey (Coming Soon)](#chocolatey-coming-soon)\n4. [Manual (GitHub Release)](#manual-github-release)\n\n### Native Installation Scripts\n\nRunning the native PowerShell scripts will handle everything related to setting up environment variables on your system.\n\n#### Install CLI\n\nDownload and run the installation script for the Unofficial Zed CLI:\n\n```powershell\nirm https://raw.githubusercontent.com/SameerJS6/zed-cli-win-unofficial/refs/heads/main/scripts/release/install-wrapper.ps1 | iex\n```\n\n#### Install Zed + CLI (All-in-One)\n\nInstall both Zed (Unofficial Build) and the Unofficial CLI with zero setup. This script handles everything automatically:\n\n```powershell\nirm https://raw.githubusercontent.com/SameerJS6/zed-cli-win-unofficial/refs/heads/main/scripts/release/install-with-zed-wrapper.ps1 | iex\n```\n\n\u003e [!NOTE]\n\u003e Installing via this method will place Zed and the Unofficial Zed CLI in their default directories.\n\u003e\n\u003e #### Zed\n\u003e\n\u003e ```powershell\n\u003e %LOCALAPPDATA%\\Programs\\Zed\n\u003e ```\n\u003e\n\u003e #### Unofficial Zed CLI\n\u003e\n\u003e ```powershell\n\u003e %LOCALAPPDATA%\\zed-cli-win-unofficial\n\u003e ```\n\n### Scoop\n\nInstall using [Scoop](https://scoop.sh/) for easy updates and management:\n\n#### 1. Add the bucket\n\n```powershell\nscoop bucket add zed-cli-unofficial https://github.com/SameerJS6/zed-cli-win-unofficial\n```\n\n#### 2. Install the CLI\n\n```powershell\nscoop install zed-cli-unofficial/zed-cli-win-unofficial\n```\n\n✅ That’s it! You can now launch and use zed from any terminal window.\n\n\u003e [!TIP]\n\u003e If you don't have **Scoop** installed, run the following commands in **PowerShell** to install it:\n\u003e\n\u003e ```powershell\n\u003e Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n\u003e Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression\n\u003e ```\n\n### Chocolatey (Coming Soon)\n\n\u003e A Chocolatey package for zed-cli-win-unofficial is coming soon.\n\n### Manual (GitHub Release)\n\nDownload and install manually from the GitHub releases page:\n\n1. Visit the [Releases page](https://github.com/SameerJS6/zed-cli-win-unofficial/releases).\n2. Download the `windows-x86_64.zip` asset.\n3. Extract to a folder of your choosing (default: `%LOCALAPPDATA%\\zed-cli-win-unofficial`).\n4. Update your user `PATH` to include that folder (choose one method below):\n\n\u003cdetails\u003e\u003csummary\u003ePowerShell (CLI)\u003c/summary\u003e\n\n```powershell\n$path = \"$env:LOCALAPPDATA\\zed-cli-win-unofficial\"\n[Environment]::SetEnvironmentVariable('PATH', $env:PATH + ';' + $path, 'User')\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eGUI\u003c/summary\u003e\n\n- Press Win, type \"Environment Variables\", and open \"Edit user environment variables\".\n- Go `Advanced` tab and click on `Environment Variables`, now a pop up will appear.\n- Under \"User variables\", select \"Path\" → click \"Edit\" → click \"New\".\n- Paste `%LOCALAPPDATA%\\zed-cli-win-unofficial` and click \"OK\" on all dialogs.\n\n\u003e If you have PowerToys installed, you can use the PowerToys _Environment Variables_ tool to manage your variables more easily.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003eCommon Pitfalls\u003c/summary\u003e\n\n- Unblock the downloaded ZIP if prompted (Right-click → Properties → Unblock).\n- Verify both `zed-cli-win-unofficial.exe` and `zed.bat` are present.\n- Restart your terminal after updating the `PATH`.\n\n\u003c/details\u003e\n\n## Disclaimer \u0026 Affiliation\n\nThis project is an unofficial Windows CLI launcher for [Zed](https://zed.dev). It is not affiliated with or endorsed by the Zed team.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameerjs6%2Fzed-cli-win-unofficial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsameerjs6%2Fzed-cli-win-unofficial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameerjs6%2Fzed-cli-win-unofficial/lists"}