Repository navigation
Codeshi 0.43.0
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.43.0-mac-apple-silicon.zip |
| Intel | Codeshi-0.43.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.43.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. On Windows, connect Claude Code or the Codex CLI; installing the Google connection from Settings is not available on Windows yet. 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.43.0
What's new
Added
- A task board (#132). Board, beside Plan, keeps a workspace's work as cards in five columns: Backlog, Ready, Doing, Review and Done. You write each card with a description, a priority, a checklist and the cards it waits for, and choose its agent. Run starts a card as its own task, and Run Ready… runs exactly the Ready cards you tick, each after the cards it waits for. A finished card waits in Review with the agent's summary, the files it changed and its test result. Only you accept it. A stopped or failed card returns to Ready with the reason. Cards are saved with the workspace, not in your repository.
- Design notes in the preview (#125). Design in the preview's toolbar lets you mark several parts of your app's page and write a note for each. Click an element, or drag a box around an area, and it gets a numbered box on the page and a row in the Design notes panel beside it. Add to message puts every note into the message box as one numbered list, with the code location of each part where your dev build reports it. It adds a screenshot of the page showing the same numbers, and one of each part that has scrolled out of view. Nothing is sent until you send it. The boxes follow the page as it scrolls and reloads. Esc stops marking, so you can use the page between marks. A message holds up to 12 parts.
- Codeshi in your terminal (#90). On macOS, Codeshi › Install ‘codeshi’ Command… adds
codeshi. Run it in a project folder and you get an interactive session in that terminal. You type to the agent, and its steps, diffs and replies scroll by, with the agent, model and access shown under the prompt. Approvals and the agent's questions open as a small box you answer with the arrow keys or a number, and Esc stops a run. Shift+Tab switches between asking before changes, editing without asking, and read only. Type/for commands such as/agent,/model,/handoff,/tasksand/open, and@to mention a file. It's the same conversation as the window, so you can start a run in one and follow or answer it in the other, and leaving the session never stops a run. Codeshi doesn't need to be open:codeshistarts it in the background with no window, and it quits by itself a couple of minutes after you're done. For scripts,codeshi run "…",status,wait,stop,continueandtasksprint plain output, or JSON with--jsonand--jsonl. A script never approves anything for you: it ends with exit code 3, and the approval waits in Codeshi. You can also try it without installing anything: CLI in the status bar opens the same session in a tab, in the conversation's place, with Chat and CLI tabs above it. Chat goes back to the conversation and leaves the session running. ×, Ctrl+D or/exitcloses the tab, and a run carries on in the chat. See docs/cli.md. - Watch along with a teammate (#24). Share live in the status bar, beside Remote access, makes an invite link for one teammate. They paste it into Share live › Watch a teammate… in their own Codeshi, and you allow them after checking that both screens show the same six-digit code. They then see the workspace's conversation as it happens, read-only: messages, replies, what the agent is doing and when it waits for you. A line above your message box says who is watching. Their suggestions wait there until you add one to your message or dismiss it. Watchers can't send messages, answer approvals, open files or see other workspaces. The conversation goes through the remote access relay, encrypted on each computer.
Changed
- Weather in Flow. Rain and Snow, with their sound and volume, moved from the Lounge to Your space, beside Appearance. They now fall anywhere in Flow, and the choice is kept between sessions; Clear draws nothing.
- Flow's corners take less room. Appearance in Your space is one row of small icons, Graphite has a new icon, and Remote access, Share live and Keep awake sit side by side under Stay connected.
- Board and Plan sit at the left of the top bar. The search box now stays in the middle of the top bar, whatever the buttons at either end show.
- What's New explains each change. The notes shown after an update, and under Help › What's New, listed only each change's title. Each change now has its title and a sentence or two on what it does, in larger text.
- Add from GitHub no longer shows a notice. Adding an issue or pull request to the message box showed a line such as "Issue #84 is in the message box" above the chat. The text in the message box already says so, so the line is gone. A notice still appears when something was taken out of the text, such as a possible secret or a local path, or when it was shortened to fit.
Fixed
- Plan usage from Flow's plans card. Clicking an agent in What's left on your plans could open its usage window at the very top of the screen, often the first time, out of reach of its close button. The card redraws when a fresh reading arrives, and the window lost its place. It now stays beside the agent you clicked.