Repository navigation
Install
macOS
Run this in Terminal. It picks the right build for your Mac, verifies its checksum and installs it in Applications:
curl -fsSL https://raw.githubusercontent.com/AhmedNavaz/codeshi/main/install.sh | shOr download the zip for your Mac:
| Mac | File |
|---|---|
| Apple Silicon (M1 and later) | Codeshi-0.48.0-mac-apple-silicon.zip |
| Intel | Codeshi-0.48.0-mac-intel.zip |
Unzip, move Codeshi to Applications and open it. Use your own configured Claude Code or Codex CLI connection, or connect Gemini through Google Antigravity in Settings (Install Google connection, then Connect account). Local continuation needs Codex CLI, Ollama and a downloaded tool-capable model. See the setup guide in the repository for authentication and billing details.
The app is not notarized by Apple yet, so the first time you open a browser download macOS says it cannot verify the developer. Open System Settings › Privacy & Security and click Open Anyway. You only need to do this once. If macOS instead says the app is damaged, run xattr -cr /Applications/Codeshi.app and open it again.
Windows
Run this in PowerShell. It downloads the Windows build, verifies its checksum, installs it for your user account and adds it to the Start menu:
irm https://raw.githubusercontent.com/AhmedNavaz/codeshi/main/install.ps1 | iexOr download Codeshi-0.48.0-windows-x64.zip, unzip it and open Codeshi.exe in the Codeshi folder. The app is not signed yet, so the first time you open a browser download Windows may say it protected your PC: click More info, then Run anyway. Use your own configured Claude Code or Codex CLI connection, or connect Gemini through Google Antigravity in Settings (Install Google connection, then Connect account). Updates install from inside the app on macOS; on Windows, run the installer again.
The private-link service for Ask a Friend is published as a container image: docker pull ghcr.io/ahmednavaz/codeshi-sharing:0.48.0
What's new
Added
- Voice input on Windows (#73). The microphone beside Send, Ctrl+Alt+V and Agent › Voice Input now work on Windows, in dictation and in Flow's conversation mode. Speech is recognized on your PC by the offline speech recognition that is part of Windows, so the audio never leaves it and nothing needs installing. It needs speech recognition for your language, which Windows installs with the language, and it does not add punctuation. Settings › Voice says what Windows allows.
- The
codeshicommand on Windows (#90). File › Install ‘codeshi’ Command… addscodeshito Command Prompt, PowerShell and Windows Terminal, without an administrator and without restarting the terminal. It is the same command as on macOS: an interactive session, orstatus,run,continue,wait,stopandtasksfor scripts, and it starts Codeshi in the background when it isn't open. File › Remove ‘codeshi’ Command takes it away. - Install Google Antigravity on Windows from Settings. In Settings › Accounts, Install Google connection now downloads and checks Google's official Antigravity runtime directly on Windows as well as macOS and Linux. Settings › Accounts also gives Windows PowerShell setup commands for Claude Code, and the Windows installer looks up the latest release without hitting GitHub's API limit.
Fixed
- The CLI tab and console input on Windows (#90). Opening CLI in the status bar on Windows now starts the interactive session cleanly inside the tab instead of opening blank and closing right away, and packaged
codeshicommands read interactive terminal input while keeping piped scripts unchanged. - Gemini status and Antigravity startup on Windows. Codeshi now finds a standalone Antigravity ACP installation under
%LOCALAPPDATA%\agy\bin, and gives the single-file Windows runtime time to unpack and initialize on startup. Background checks no longer flash console windows, and connection or timeout failures appear clearly in Settings instead of a local server error.
Codeshi is free and open source. If it's useful to you, star it on GitHub so more contributors find it, or support it on Patreon.