https://github.com/jeiel85/cli-here-windows
Launch AI coding CLIs (AntiGravity, Claude Code, Aider, Cursor, etc.) from Windows File Explorer's right-click menu.
https://github.com/jeiel85/cli-here-windows
ai-coding aider antigravity-cli claude-code cli-here context-menu cursor-cli windows-utility windsurf wpf
Last synced: about 18 hours ago
JSON representation
Launch AI coding CLIs (AntiGravity, Claude Code, Aider, Cursor, etc.) from Windows File Explorer's right-click menu.
- Host: GitHub
- URL: https://github.com/jeiel85/cli-here-windows
- Owner: jeiel85
- License: mit
- Created: 2026-05-08T02:13:20.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-16T07:16:54.000Z (24 days ago)
- Last Synced: 2026-06-16T07:31:57.332Z (24 days ago)
- Topics: ai-coding, aider, antigravity-cli, claude-code, cli-here, context-menu, cursor-cli, windows-utility, windsurf, wpf
- Language: C#
- Homepage: https://jeiel85.github.io/cli-here-windows/
- Size: 329 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: docs/SECURITY.md
- Roadmap: docs/ROADMAP.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# CLI Here
Launch AI coding CLIs from Windows File Explorer in one click.
English name: CLI Here · Korean name: CLI 여기서 열기
---
## Why CLI Here?
Running AI CLIs usually means:
1. Open terminal
2. `cd` into your folder
3. Run `gemini`, `codex`, `claude`, etc.
CLI Here removes those steps by adding Explorer context menu actions that open your selected CLI directly in the target folder.
---
## Highlights
- Context menu integration in three contexts:
- Folder right-click
- Folder background right-click
- Desktop background right-click
- Built-in CLIs:
- AntiGravity CLI
- OpenCode
- Claude Code
- OpenAI Codex CLI
- Cursor CLI
- Windsurf CLI
- Aider
- Continue
- Cline
- Custom CLI definitions (add/remove)
- Terminal modes:
- Windows Terminal
- PowerShell
- PowerShell 7 (`pwsh`, fallback-aware)
- CMD
- Git Bash
- Optional administrator launch (`runas` + UAC)
- Explorer menu grouping under a single `CLI Here` cascade parent
- One-click Repair / Remove-all registry actions
- GitHub Releases-based auto-update baseline
- Robust CLI detection: process PATH + registry PATH (HKCU/HKLM) + well-known fallback folders (npm, `.local/bin`, `.cargo/bin`, `.dotnet/tools`, etc.)
- Blue dark theme with a fully themed in-app message dialog
---
## Runtime Requirement
Default release packaging uses **framework-dependent publish** (`self-contained=false`) to keep downloads small.
You need:
- **.NET 9 Desktop Runtime (x64)** on the target Windows machine
---
## Installation (Release)
1. Download latest assets from [Releases](https://github.com/jeiel85/cli-here/releases/latest)
2. Use:
- `CliHere-win-x64.zip` for normal app delivery
- `CliHere.exe` + `CliHere.exe.sha256` for update flow verification/debugging
3. Extract and run `CliHere.exe`
4. Configure options and click `Apply`
---
## Supported CLI Table
| CLI | Command | Detection | Install / Docs |
|---|---|---|---|
| AntiGravity CLI | `agy` | PATH | https://github.com/nicholasgasior/antigravity-cli |
| OpenCode | `opencode` | PATH | https://opencode.ai/docs/cli/ |
| Claude Code | `claude` | PATH | https://docs.claude.com/en/docs/claude-code/setup |
| OpenAI Codex CLI | `codex` | PATH | https://help.openai.com/en/articles/11096431-openai-codex-ci-getting-started |
| Cursor CLI | `cursor` | PATH | https://cursor.sh/docs |
| Windsurf CLI | `windsurf` | PATH | https://windsurf.com/docs |
| Aider | `aider` | PATH | https://aider.chat/docs |
| Continue | `continue` | PATH | https://continue.dev/docs |
| Cline | `cline` | PATH | https://cline.bot/docs |
CLI Here does **not** auto-install third-party CLIs. It only detects availability and provides official links.
---
## Security Principles
- No telemetry
- No analytics SDKs
- No background network scanning of projects
- No project file upload
- Registry scope limited to `HKLM\SOFTWARE\Classes`
- Only `CliHere_`-prefixed keys are touched (never modifies other apps' menu entries)
---
## Apply requires UAC
Clicking **Apply / Repair / Remove all** triggers a **one-time UAC prompt**.
- Starting with Windows 11 25H2, the shell stopped honoring per-user (HKCU) context menu entries (Microsoft tightened shell security). The integration must therefore live in the system hive (HKLM).
- The app spawns a short-lived elevated child process that performs only the registry update and exits — the main window keeps running unprivileged.
- Declining UAC is safe; the app shows a friendly message and continues.
---
## How to find the menu on Windows 11
The Windows 11 **new (default) right-click menu hides classic registry entries by design**. Use either of:
1. `Shift` + right-click → classic menu opens immediately
2. Right-click → click `Show more options` at the bottom
Hover `CLI Here` in the classic menu to expand the cascade with all nine CLIs.
> Windows 10 classic menu users will see the entry without any extra step.
---
## Localization
- English
- Korean
Korean docs: [README.ko.md](./README.ko.md)
---
## Development
### Tech Stack
- C# / .NET 9 / WPF
- xUnit
- GitHub Actions
### Commands
```powershell
dotnet restore
dotnet build --configuration Release
dotnet test --configuration Release
```
---
## Roadmap Snapshot
- [x] MVP foundation + context menu + launcher modes
- [x] Custom CLI definitions
- [x] Repair / Remove-all actions
- [x] PowerShell 7 mode
- [x] Blue dark theme + themed in-app message dialog
- [x] HKLM registration with one-time UAC elevation (Win11 25H2 compatible)
- [x] Robust CLI detection (registry PATH + well-known folder fallbacks)
- [x] Desktop-background context support
- [~] Auto-update hardening and rollout validation
- [ ] Windows 11 *new* right-click menu (`IExplorerCommand` COM DLL / MSIX Sparse Package — separate effort)
---
## License
MIT