Codeshi 0.48.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 | sh

Or 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 | iex

Or 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 codeshi command on Windows (#90). File › Install ‘codeshi’ Command… adds codeshi to 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, or status, run, continue, wait, stop and tasks for 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 codeshi commands 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.

Codeshi 0.47.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.47.0-mac-apple-silicon.zip
Intel	Codeshi-0.47.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 | iex

Or download Codeshi-0.47.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.47.0

What's new

Added

• Commits in Timeline (#20). Timeline now shows each folder's commits on its current branch among the checkpoints, in time order, from the oldest checkpoint on (or the latest 15 before there is one), up to 30 per folder. Each commit says who made it as far as Codeshi knows: From the Git panel for a commit made there, During Claude's run (or another agent's) for one made while a run was working, and otherwise its author. Clicking a commit's message opens its files and lines read only. A merge shows what it brought into the branch, and Open on GitHub appears when the folder's origin is on GitHub. Nothing in Git is written, and restoring files still goes through checkpoints.
• An evaluation task for each starter skill (#86). npm run eval has six new tasks, one per starter skill, for running with and without it: a view that handles every state, an endpoint that checks who may call it, a migration that works on existing data and can be undone, an accessible toolbar, a review that has to find two seeded defects, and tests that must catch four realistic slips. A failed check now lists which of its parts failed, by the check's own names, without storing the agent's code or reply. Results so far are in evals/README.md.
• Hear replies on your phone (#23). On a connected phone, the speaker under a finished reply reads it in the phone's own voice, a paragraph at a time, leaving out code and tables. Tap it again to stop. Read replies aloud, at the bottom of the workspace list, reads each reply as its run finishes while Codeshi is open on the phone. It's off by default. It works on Same Wi-Fi too, and stops when you hide the page, move to another conversation or tap the microphone.
• Open one of your GitHub repositories as a workspace (#159). New workspace has a From GitHub tab listing the repositories your GitHub CLI login can see: your own, your organizations' and those you collaborate on, most recently pushed first, with search. Click one and it's cloned into the folder under Clone into and opened as a workspace. A repository already on this computer, in a workspace or in that folder, says Open and opens its existing folder instead. The first time, Codeshi suggests the folder most of your workspaces are in, then remembers the folder you clone into. It uses gh and your own git: Codeshi asks for no sign-in, stores no token and never pushes. The list is read only when you open the tab, and shows up to the 500 most recently pushed repositories. Signing in without gh, and GitHub Enterprise, aren't supported yet.
• Move Codeshi to another computer (#160). Export Codeshi Backup… in the File menu, or Settings › General, saves your workspaces, their conversations, memory, skills, board cards and tasks, and your settings to one file locked with a passphrase. Checkpoints can go too. Import Codeshi Backup… on the other computer, also offered on the setup guide's first screen, asks where each workspace folder is there: a folder already there (found by its GitHub address or its path), a fresh clone through gh, another folder, or none. Folder IDs and paths in Codeshi's own records are rewritten to match. Importing into a workspace that already exists merges with it. A conversation that changed on both computers is replaced only if you choose, and this computer's copy is kept. Sign-ins, the GitHub login, phone pairings, always-allow approvals and tasks' working copies never move. Nothing goes through a server; moving directly between computers without a file isn't built yet.

Changed

• Alerts are set up by moment, with Try it. Settings › Alerts now has a card for each moment, Needs you first, then Finished and Stopped, each with a chip for each way: banner, sound, Dock bounce, Dock badge and phone. Try it shows the real thing. It plays the sound and, in the desktop app, shows the banner or panel and the Dock badge, then says what happened, including when macOS refused the banner and how to allow it. The Dock bounce comes if you switch to another app within a few seconds. Needs you suggests turning on a sound while it has none. Your alert choices carry over unchanged.
• Live status in one place. The menu bar status and the pill under it now sit together under While agents work at the top of Settings › Alerts. They're described as quiet status, apart from the alerts, and Show the pill shows the pill for a few seconds. Agent › Alerts and the menu bar's own Alerts menu can turn the pill on or off too, and their ticks match what Settings shows.
• The setup guide asks about alerts. A last step, Know when an agent needs you, shows the Needs you card with Try it and, on a Mac, the pill with Show the pill. Choices save as you make them, and the rest stays in Settings › Alerts.
• One focus ring in Settings search. The search box drew two rings while you typed in it.

Fixed

• The progress pill's × hides it instead of opening Codeshi (#75). On macOS, pressing × on the pill under the menu bar brought Codeshi forward and left the pill on for next time. It now hides the pill and puts you back in the app you were using. The pill stays hidden until you've been back in Codeshi, then shows again the next time you leave while agents work; before, it came back as soon as another run started. The same goes for × on an alert in the panel.
• Keyboard and screen reader fixes (#26). Switching side panels with Enter or Space dropped keyboard focus to the page, because each panel has its own row of tabs. Focus now stays on the tab, and the row is one stop in the Tab order: Left and Right move to the next panel, Home and End to the first and last. The Terminal and Run tabs of the bottom panel are one Tab stop too, with Home and End. Entering or leaving Flow with the keyboard also dropped focus, because the header moves; it now stays on the Flow button. Each message now starts with a heading (You, or the agent's name) for screen reader heading navigation. On the board's canvas, each card tells a screen reader that Option (Alt on Windows) with the arrow keys moves it, and the hint at the corner says so too. In the model picker, Connect… and More … models rows are now read as part of the list.
• Memories no longer need a recheck after every commit (#21). Since 0.30.0, any new commit in a folder marked every memory saved there Needs recheck, even an unrelated commit. Those memories went to agents as possibly out of date and started unticked in Copy to AGENTS.md. Now a commit by itself flags nothing. Conventions and decisions, the rules you set, need a recheck only when a file they name changes. Working fixes and failed approaches, facts found in the code, also need one after a switch to another branch, or when the folder's dependencies change in package.json, composer.json, deno.json, Cargo.toml, pyproject.toml, requirements.txt, Pipfile, Gemfile, go.mod, pubspec.yaml or Package.swift. A project's own version number, its scripts and lock files don't count. Hovering Needs recheck says which of these happened. Before, it said the folder had left the workspace whenever no named file had changed. Editing and saving a memory counts as checking it again on the current branch.

---

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 Patr...

Codeshi 0.46.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.46.0-mac-apple-silicon.zip
Intel	Codeshi-0.46.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 | iex

Or download Codeshi-0.46.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.46.0

What's new

Added

• A plan's steps are tested before later steps build on them (#89). When a step of a running plan finishes, Codeshi runs the test command marked in the Run panel on a temporary copy of its result. For a step that worked in its own copy, that is the folder with the step's changes merged on top. The folder and the copy are left untouched, and the step's merge review shows the same result. If the tests fail, the steps that depend on it wait. Fix the step in its task, or open the Plan and choose Check again or Continue anyway. Continuing is recorded as your decision. Each card in the Plan shows the result: Tests passed, Tests failed, No changes or Not tested, with the reason. A step is marked not tested when no test command is marked, its folder isn't a Git repository, or Codeshi closed while its tests were running. Failed tests show the end of their output in the step's details.
• Open a pull request from the Git panel (#18). After you commit, Open pull request shows where the branch will go before anything is sent: the repository, the branch and the branch it merges into, the commits GitHub doesn't have yet, and any files you haven't committed. The title and description are drafted from what Codeshi recorded, with no model: the branch's commits, the request that started the work, a link to any GitHub issue you brought into the conversation, and Codeshi's last test result. Secrets and local paths are removed as in exports, and you edit both before opening. You can open it as a draft. Clicking pushes the branch with your own Git login and opens the pull request with gh. Codeshi never force-pushes and never pushes the branch a pull request merges into. If you're on that branch (main, say), you name a new branch, your commits move to it, and main goes back to where GitHub has it. If the branch already has an open pull request, the same button pushes your new commits to it. This is the only place Codeshi pushes, and agents never push.

Changed

• A plan step's instructions are written when it starts (#89). Until now, every step's instructions were written when the plan started, so a step only saw the titles of the steps before it. Now each step gets what those steps actually did: whether their changes were merged or kept as a branch, the files they changed, their test result, and their final report, labelled as the contract, schema or findings the plan asked for. The step is told to check the files rather than rely on the reports. If an earlier step finishes again after a later one has started, the later step's card says it was built on an older version.
• The recap includes tasks and plans (#88). While you were away used to cover only each workspace's main conversation. It now also lists tasks that worked, finished or stopped while you were gone: who did each, which files it changed, and whether it waits for you to merge it or approve something. A plan's steps fold into one line, such as The plan “Checkout rewrite” has 2 of 4 steps done, followed by the steps still working, the steps whose tests failed and are holding the steps after them, and the steps ready to merge. A step whose tests failed stays in the recap until you deal with it. Merging, keeping and discarding are your own actions, so they're left out.
• Times use a 12-hour clock. Every time Codeshi shows is now written like 9:41 PM: on messages, limit resets, checkpoints, the board, the phone view and Ask a Friend's sharing page.
• Flow's What happened card is shorter. It shows the latest three runs, and its Timeline button is gone, since Files changed beside it already has one.

---

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.

Codeshi 0.45.1

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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.45.1-mac-apple-silicon.zip
Intel	Codeshi-0.45.1-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 | iex

Or download Codeshi-0.45.1-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.45.1

What's new

Added

• The board as a canvas (#97). Board has a Canvas view beside Columns: the same cards, placed wherever you drag them, with arrows from a card to the cards that wait for it. Drag from the dot on a card's right edge onto another card to make it wait, or select an arrow and press Delete to remove it. Moves, arrows and Arrange, which lays every card out by what it waits for, can be undone with Undo or ⌘Z. Scroll to pan, pinch or ⌘-scroll to zoom, and double-click empty space for a new card there. A card's place is only where it's drawn, so moving a card changes nothing an agent reads, and a card that's working can still be moved. Cards you haven't placed sit below the placed ones, in columns by what they wait for or in a grid. Columns stays the view for the keyboard and screen readers, and Alt with an arrow key moves a focused card on the canvas. Export saves the board as Markdown with a Mermaid chart of the cards and their arrows, followed by each card's details and checklist, without task ids or the agents' summaries.
• Share your results (#139). Smart results in the Tasks panel has a Share… link. It shows what a shared copy includes and leaves out, with the post and the file to read first. That copy never has your requests or routing reasons. Tasks are numbered 1, 2, 3 instead of keeping their IDs, and times keep only the date. Save file and open GitHub saves the copy and opens a prefilled post on Codeshi's GitHub Discussions. You attach the file there and decide whether to post it. Codeshi sends nothing itself.
• Approvals still waiting when a run ends (#85). When a handoff or Stop ended a run while an approval or a question was waiting for you, the request was dropped, and the next agent never learned it had been asked. The run now keeps a short line for each: the command, the kind of file change (a file with a private-looking name isn't named) or the question. The next agent gets them as history, told that none was answered or carried out, after a handoff, a context refresh or a restart. Once another run has ended they're left out. See the full brief in the Brief panel lists them under Waiting when the last run ended.
• What happened in Flow (#107). A new Flow card lists the decisions behind the last four finished runs, newest first: the agent, model and effort Codeshi chose and for what size of task, a handoff from one agent to another, a switch at a usage limit, a retry after failed tests, or a review. Each line shows how the run ended (tests passed or failed, tests waiting for your review, stopped, or stopped at a usage limit) and the reason Codeshi recorded at the time. It reads saved runs only, with no model call, and routing assessments aren’t listed. Timeline opens the full history. Earlier runs are included too, since it reads the reasons already saved with each run.

Changed

• What's New thanks contributors. The notes shown after an update, and under Help › What's New, now end each version with a Thank you line for the people who contributed to it, as the changelog credits them. A name opens that person's GitHub profile. Under the notes, Star Codeshi on GitHub and Support on Patreon open those pages, and the Help menu has both too. A star helps more contributors find Codeshi. Nothing is sent unless you open a link.
• The menu bar status is quiet while Codeshi is in front. On macOS, the words beside Codeshi's mark in the menu bar, such as Codex · Editing · 3 files changed or Approval needed, and the dot for something that needs you, now show only while Codeshi is behind another app. With a Codeshi window in front, the window already shows it, so the menu bar keeps the plain mark. Its menu still lists every busy workspace.
• A plan's steps fold into one row once it ends (#108). Under Tasks, a plan's row now says where it stands, such as 1 of 3 done, Finished or 1 didn't finish. When every step has ended and none waits for review or an approval, the steps fold away and the row shows what the whole plan used: steps, working time and new tokens, including the planning run, with at least when an agent didn't report everything. A click opens it again, and its × closes the plan. A plan you folded by hand still shows how many steps need you.

Fixed

• Smart results in a narrow Tasks panel. The results table could push the section past the panel's right edge, cutting off the last column, the verdict and the links under it. Column headings now wrap, and the section fits the panel.
• The board and the Plan view under the window buttons. On macOS, the close, minimise and zoom buttons sat on top of the top-left corner of Board and the Plan view. Both now start below the title bar.
• The message box in the Lounge during a run. In the Lounge's narrow chat column, one control could drop to a second line while Stop and Queue sat beside both lines. The row now stays on one line: in a narrow message box, Stop shows as its icon during a run. When the window is too small for one line, the controls keep the first line and Stop and Queue take the second, at the right.

---

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.

Codeshi 0.44.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.44.0-mac-apple-silicon.zip
Intel	Codeshi-0.44.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 | iex

Or download Codeshi-0.44.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.44.0

What's new

Added

• Claude's usage by model (#84). Claude Code calls a small model such as Haiku for its own jobs inside most runs. Its tokens were part of the run's total but couldn't be told apart. The Tasks panel and a run's details now split Claude's new tokens by model, for example Sonnet 5.5 40k · Haiku 5.5 13k. A run in a resumed session counts only what each model added. When Claude is connected through its command line and starts subagents, a line also shows at least how many new tokens they used. Both are already inside the total and are never added to it. Codex and Gemini report one total per turn, so they have no split.

Changed

• One handoff line for the whole task (#12). Smart, Saver and Ultra already used their 80, 90 and 95% lines to choose an agent and to decide when a task moves. The rest of a routed task now uses the same lines. In Smart and Ultra, a retry after failed tests now asks first only from 90% (Smart) or 95% (Ultra), not from 80% or 90%. Ultra asks another agent to review only when it has room under 95% for a usual run, not under a fixed 90%. After a reset, a waiting task resumes first on an agent under its mode's line, and past it only when no agent is. A step of an Orchestrate plan left to Auto is now chosen when it starts, from fresh usage and at the size the plan gave it, rather than when you pressed Run. A step whose agent you chose keeps it. A queued prompt that moves at a handoff keeps the size it was rated as. Routed runs record routing policy 3, so Smart results compare them only with each other.
• One layout for every dialog (#130). Dialogs now share one header and one footer: the title with a short line under it, the close button at the top right, and the actions at the bottom right at one height. This covers Previous conversations, Export, Changes, Undo changes, Ask a friend, Continue locally, the review dialogs, Add from GitHub, Run and review your project, workspace and folder settings, and the memory and skill forms. Their titles follow Text size, and the review dialogs' close button is the same icon as everywhere else. What's New keeps its logo heading, and Settings keeps its page title.

Fixed

• Setup with the keyboard and a screen reader (#129). Choosing a working style, an agent or what agents can do keeps keyboard focus on that choice. After you choose folders, focus moves to the result. A screen reader hears what each folder is, each agent's connection status with its button, and which steps are done.
• Badges are easier to read in every theme (#127). Status text such as Working, Finished, Failed, a waiting approval or a routing mode's limit now reaches WCAG AA contrast in Light, Dark and Graphite, on selected rows and tinted cards too. Running states and labels in the accent's colour use a brighter shade of it, because vermilion itself was too dim for small text. In Graphite, selected rows are a little darker and red and grey text a little lighter. In Light, green, amber, blue and link text are a little darker. The Working badge on Flow's plans card, the approval count in the sidebar and the plan badge in usage are no longer smaller than other badges. A test now checks every badge colour against the theme it appears in.

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 | sh

Or 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 | iex

Or 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, /tasks and /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: codeshi starts 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, continue and tasks print plain output, or JSON with --json and --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 /exit closes 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.

Codeshi 0.42.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.42.0-mac-apple-silicon.zip
Intel	Codeshi-0.42.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 | iex

Or download Codeshi-0.42.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.42.0

What's new

Added

• Suggestions after a run (#106). When a run finishes, the line above the message box can point to a feature that fits what just happened, in Normal and Flow. It suggests Remember when you've written the same rule in two messages, Make a skill when you've given the same steps in three, and, in Normal, Try Flow when small changes keep going to a strong model or high effort. Each says what it saw and opens a step that shows what will change; nothing changes from the line itself. They come from local rules with no model call and promise no saving. There's one at a time, never during a run, an approval or a question, and at most two a day. × dismisses one for good, and Settings › General › Suggestions after a run turns them off, along with usage notices.
• A skill from your messages. Make a skill from a suggestion saves steps you gave in several messages as a skill, after the same review as a skill made from memory. It's listed under Skills as From your messages.
• Status in the Windows notification area (#74). On Windows, Codeshi's mark now sits beside the clock, as it does in the macOS menu bar. A dot says something needs you and the tooltip says what, in general words and counts only. A click brings Codeshi forward, to the request when exactly one thing needs you, and a right-click opens a menu of busy workspaces with Keep Awake and Alerts. The icon follows a dark or a light taskbar. Turn it off in Settings › Alerts. It's covered by automated tests but hasn't been tried on a real Windows PC yet.
• Ready for translation (#27). Codeshi's interface can now be translated into other languages, with no build step. A language is a catalog file, and Settings › General › Language appears once one is added. It follows the computer's language until you choose another. The page's own text, Settings, the message box and model picker, and the desktop and tray menus are translatable, with plurals and values in each language's own order. Other panels, the phone page and messages from the server stay in English for now. No translations ship yet: npm run i18n -- <language> starts a catalog with every text to fill in, and CONTRIBUTING.md explains how to translate.
• Record Performance Trace. Help › Record Performance Trace measures Codeshi for ten seconds while it seems slow or uses the battery, in the installed app too. It then says how much of one CPU core the window's pages, the graphics process and the app itself used, and saves a trace of what each one ran, gzipped, under performance-traces in Codeshi's data folder. Show in Finder finds it, and Perfetto or Chrome's trace viewer opens it as it is. The trace holds timings, script names and request addresses, not chat text, and it stays on the computer. The latest five are kept.
• Six puzzles in the Lounge. The Lounge's grid now also has Codle, a word game where you guess a five-letter programming word in six tries; 2048; Minesweeper, in three sizes; Sudoku, in three levels with pencil notes; Pairs, a memory game with code symbols; and Fifteen, the sliding-tile puzzle. Each board grows with the window, and each puzzle plays with the mouse or the keyboard. A puzzle stays as you left it while the Lounge is closed, and best results are kept on this computer. The puzzles do no work between your moves, and the Minesweeper and Sudoku clocks stop when you leave them.
• Progress pill under the menu bar (#75). On macOS, Show what agents are doing in a pill under the menu bar in Settings › Alerts keeps a small pill under the menu bar while an agent works and you're in another app. It uses the menu bar status's words, such as Codex · Editing · 3 files changed and the workspace. With several runs it shows how many are working and the one whose step changed last. It's useful when the menu bar status is hidden, or a crowded menu bar puts it behind the notch. It changes only when its words do and doesn't move while it shows. It has no animation or sound, isn't read out by screen readers and doesn't appear over full-screen apps. With the panel as the banner style, an alert takes its place, and it comes back afterwards if work is still running. Click it to open the workspace. × hides it until another run starts, and it goes when the work ends. It's a choice apart from the menu bar status and the banner style, so you can use either, both or neither. A new installation has it on; an existing one keeps it off until you turn it on.
• Binary files in Ask a Friend (#25). A help request and a returned solution can now include binary files such as images, fonts and archives, up to 1 MiB each, as well as text. The review shows a binary change side by side: what each version is, its size and the start of its hash, with images as pictures. A program is flagged, and so is a code file whose new version isn't text, which also shows the text that can be read in it. Text is always sent as text, so every text change still has a diff. Applying and recovery work on the exact bytes, with the same conflict checks as text, and a new file is written without permission to run. Secret scanning reads the strings inside binary files. A patch with a binary file uses a new format that older versions refuse; a text-only patch is unchanged.
• Run your tests on a friend's patch (#10). After you apply a returned solution, Run tests runs your project's own Test command, the one marked for tests in Run, never a command from the friend. It shows the exact command and folder, and nothing runs until you confirm it. It names the patched files that decide what the tests run, such as package.json, test settings and test files, and warns when the command runs in a folder the patch didn't change. The run is Run's usual Test session, so it shows there and Stop works. Each result is saved with the solution's other checks, with a one-line note in the conversation and no agent called. A failure undoes nothing on its own: the patch stays applied and the result offers Undo this patch.

Changed

• Weather falls only in the Lounge. Rain and Snow kept falling over Flow's cards after you left the Lounge. That full-window animation used about a tenth of a CPU core, plus graphics work, for as long as Flow stayed on. The weather now stops when you leave the Lounge or it steps aside for an approval or a finished run, and comes back where it was, with the same choice, when you return. It also no longer asks the system about reduced motion on every frame.

Fixed

• An answered approval leaves the panel with the menu bar status hidden. With the menu bar status turned off, an approval's alert in the panel at the top of the screen stayed after the approval was answered, for example from your phone, until you dismissed it or came back to Codeshi. It now goes as soon as the approval is answered, as it did with the status shown.
• Keyboard and screen readers (#26). The More actions and Voice mode menus now move with the arrow keys, Home, End and letters, and Tab closes them. Plan usage and Software update take focus when they open, keep Tab inside and give focus back when they close; before, Tab skipped past Plan usage. The file tree in Files is now a tree for screen readers, one stop in the Tab order, with the arrow keys moving between rows and folders. The search bar now tells a screen reader which result is highlighted, and Tab no longer loses focus in its closing list. A new approval or questi...

Codeshi 0.41.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.41.0-mac-apple-silicon.zip
Intel	Codeshi-0.41.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 | iex

Or download Codeshi-0.41.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.41.0

What's new

Added

• A plan as a chart (#97). An Orchestrate plan now opens in a full-window Plan view instead of a narrow side panel. Each step is a card, in a column for its phase or for what it waits for, with arrows from a step to the steps that wait for it. A card shows the agent the step would run with, and its task's state once the plan runs. Selecting a card opens it beside the chart: its editor while the plan is a draft, its task while it runs. Outline shows the same steps as a list, for the keyboard, screen readers and narrow windows. The plan's cost, Save changes, Run as tasks, Stop plan and Close plan are at the bottom of the view. The Plan button beside Flow opens it and says where the plan stands: planning, ready, how many steps are done, or stopped. Open plan under What's next in Flow opens it too.
• Attach Word documents (#157). A .docx attached to a message, or opened in the file browser, is read as its text, with headings, lists and tables as Markdown. A document can be up to 5 MB, and its text counts toward the usual attachment limits. A .doc, a document with a password or a damaged one is refused, with what to do instead.
• Notifications on your phone's lock screen (#23). A phone connected Away from home can now be told when an agent needs you, or a run finishes or stops, while Codeshi isn't open on it. Turn them on from Notifications at the bottom of the phone's workspace list. On iPhone that's in the Home Screen icon; Android works in the browser too. A notification says only what happened and in which workspace, never a command, a file or a reply, and tapping it opens that workspace. Your computer sends each one itself, straight to Apple's or Google's push service and encrypted for that phone, with no Codeshi server and no Firebase function in between. Which moments are sent follows a new Phone notification row in Settings › Alerts. Notifications end with the connection, and Same Wi-Fi has none, as browsers allow them only over HTTPS.
• What a whole plan used (#84). An Orchestrate plan's planning run and its steps were counted as unrelated tasks, and planning showed as read-only work. Planning now has its own role, each step is labelled with its number, and the Tasks panel and the Plan view add up the whole plan: planning and every step, with their retries, follow-ups and reviews, working time, new tokens with planning's share, and how many steps' tests passed. Tokens an agent didn't report stay unreported, never zero.
• Rewind the conversation with a checkpoint (#20). Restoring a checkpoint from Timeline can now take the conversation back too: tick Also rewind the conversation in the restore preview, which says how many later messages that folds away. Folded messages stay in the saved history and in the chat behind one line, N messages rewound · Show, but no agent reads them again, and every agent starts a fresh session. Rewinding to before a run puts its prompt back in an empty message box. When the files already match the checkpoint, only the conversation goes back. It isn't offered while prompts are queued or a task waits for a usage limit to reset.

Changed

• Smart results leave Orchestrate plans out. A plan's planning run counted as a question and its steps as manual tasks. They're now listed as part of a plan and not compared, because a plan isn't comparable with a single routed or manual task.

Fixed

• Flow no longer starts a task on an agent it would hand off right away (#12). Choosing an agent for new work and handing a task off now use the same line: 80% of a limit in Saver, 90% in Smart and 95% in Ultra, and it rises near a reset. Smart could pick Claude at 91% of its weekly limit and hand the task off at the first usage check. Now an agent past the line is chosen only when no other agent is under it, and the reason says so. The task then stays until another agent has room. A task moves only to an agent with room under the line for a usual run, judged by what that agent’s runs usually spend in each window, so it isn’t moved twice. A quota-error fallback uses the mode’s line instead of 90%. Routed runs now record routing policy 2, so Smart results compare them only with each other.
• A notice about the message box goes when you send. A notice such as "Issue #84 is in the message box" stayed on screen after the message was sent. It now goes as the message is sent. A notice with a Retry or other button stays.

Thanks to @seeebbii for Word documents (#157).

Codeshi 0.40.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.40.0-mac-apple-silicon.zip
Intel	Codeshi-0.40.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 | iex

Or download Codeshi-0.40.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.40.0

What's new

Added

• Copy project memory to AGENTS.md (#21). Copy to AGENTS.md under Memory in the Brief panel writes the memories you choose into a folder's AGENTS.md as one marked section, after showing exactly what will be written. The rest of the file is kept as it is, copying again replaces only that section, and nothing is committed. The write is refused if the file changed after the preview or an agent is working in that folder.
• Hands-free voice conversations (#72), on macOS, in Flow. Choose Conversation from the arrow beside the microphone, or as Mode in Settings › Voice, and ⌥⌘V or the microphone starts a conversation that listens until you say "stop listening", press Esc or click the microphone. Say "send" as the last word, then pause, to send. "send" in the middle of a sentence stays part of the message, and Send after a pause sends after two seconds of silence. While a run works, what you send goes into it when the agent allows additions, or joins the queue, as While the agent works chooses. Listening pauses while Codeshi reads a reply or a request aloud, and a short tone says when it listens again. Approvals are read out: "deny" denies, and approving needs "approve" and then "yes, approve". Questions with choices are answered on screen, and listening waits for them. Each listening session still lasts at most two minutes, and the next starts by itself without losing what you said. Speech stays on your Mac.
• Add terminal output to your message (#71). Select output in the terminal, such as a failing test or a stack trace, and Add to message puts it in the message box as a code block that names its folder: a button at the top of the panel, the right-click menu, or ⇧⌘L (Ctrl+Shift+L on Windows and Linux). With nothing selected, it adds the screen as it shows. Nothing reaches an agent until you send the message, and the conversation never reads the terminal on its own. Output over 200 lines keeps its first 50 and last 150 lines, and at most 16,000 characters. Output that looks like it holds a token, key or password is left as it is, with a notice to check it before you send.
• Add Remote access to your Home Screen (#115). The Away from home page now has a web app manifest, the Codeshi icon and Apple's web app tags, so an icon added to the Home Screen opens full screen with the right name and mark. After a phone pairs, it shows Add to Home Screen once, suited to the device: the Share menu steps on iPhone, the browser's own Install prompt on Android, and on a QR scanner app's built-in browser, a way to move the connection to Safari first. It isn't shown in an installed app or on Same Wi-Fi, which uses plain HTTP and an address that can change, and it stays at the bottom of the workspace list.
• Type a code to move a connection to a Home Screen icon. An iPhone Home Screen icon keeps its own storage and has no address bar to open a link in, so Move to another browser now also gives an 8-character code for Away from home, valid once for 5 minutes. An unpaired page asks for it. The code only opens a short-lived meeting point; the connection's key then travels sealed with a fresh key exchange, so the code can't be used to open anything stored in Firebase.

Changed

• A finished run's reply is read aloud as written. Reading aloud used to say how long the run took, which files it changed and whether tests ran, then the first sentences of the reply. It now reads only the reply, in full, leaving out code and tables. A run that stopped early or left no reply still gets one short sentence. The setting is now Read the reply aloud.
• A task in its own copy has your installed packages (#88). Each node_modules the folder's .gitignore leaves out is cloned into the task's copy before the agent starts, so its builds and tests can run there. On disks that can clone it takes about a second and no extra space, and installing in the task doesn't touch the folder's own; elsewhere it's linked, and the task card says it's shared. .env files are never copied, and the task card names the ones the copy lacks. None of this becomes part of the task's changes.
• The Lounge fills the window (#14). The chat moves to the right of the window and stays live and full brightness, and the rest of the window is the Lounge. It opens on a grid of things to play, each with a title, a short description and your best score: Breakout, Snake, code trivia and a typing test. The developer quote and the weather choice share one row above the grid; an open game gets the whole Lounge. The weather keeps falling over Flow after you leave the Lounge, with no switch for it. Rain and Snow now have real sound: recorded loops that fade in and out as you switch, with a volume slider beside the weather choice (remembered on this computer). Nothing plays until you choose Rain or Snow, Clear is silent, and the recordings come with the app, so it still works offline. Sources and licences are listed in public/sounds/CREDITS.md. Choose one and it fills the Lounge, with Breakout and Snake drawn as large as the space allows and kept sharp; All activities or Escape goes back to the grid, and a game you leave waits, paused. The chat column is wide enough for the message box to keep its controls on one row. Opening and closing the Lounge moves the chat across to its new place instead of jumping, and the cards and the Lounge keep their size as they slide away.
• Rain in the Lounge looks more like rain. Drops now fall at different distances: near ones are longer, faster and brighter, far ones short and faint. Every streak leans with one slow wind and trails behind its drop, and a drop that lands leaves a few fine droplets and a thin ring instead of bouncing dots. Every drop splashes when it reaches the bottom of the window, far ones with a single fine droplet.
• Screenshots an agent takes show in the chat, side by side. Every agent is now told to save a picture it wants you to see inside the workspace and put it in its reply, instead of leaving it in a temporary folder for you to find. Images on lines of their own share a row, two or three across depending on the width of the chat, and a single image keeps its full size. Clicking one still opens it in the preview.

Fixed

• Rain and snow land only on what you can see. They used to splash and settle along edges with no visible outline, such as a reply's text and the strip above your prompt, and on cards that were covered or scrolled out of view. They now land only on a top edge whose border or fill shows against what is behind it, in view and not covered, inside its rounded corners, and settled snow goes when its surface does.
• Voice input keeps what you said before a pause. After a silence the speech recognizer can start again with only the new words, which replaced the earlier sentence in the message box. The earlier words now stay and the new ones follow them.

Thanks to @seeebbii for the energy measurements and fixes (#152, #154): weather drawn at most 30 times a second, games paced at 60 Hz speed, the setup glow running once and agent checks reused.

Codeshi 0.39.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 | sh

Or download the zip for your Mac:

Mac	File
Apple Silicon (M1 and later)	Codeshi-0.39.0-mac-apple-silicon.zip
Intel	Codeshi-0.39.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 | iex

Or download Codeshi-0.39.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.39.0

What's new

Added

• Add a GitHub issue or pull request to your message (#18). GitHub in the composer, beside Attach, takes an issue or pull request number or link, or This branch’s pull request, and puts it in the message box for you to read and send. A pull request comes with its reviews, the review comments on the code and its checks, with the part of each failing job’s log that shows the failure. It reads through your own gh login, only when you click, and never writes to GitHub. Secrets and local paths are removed first, as in exports.
• Run a plan as tasks (#108). A saved Orchestrate plan has Run as tasks, which starts each step as its own task beside the Workspace chat, with the agent, model and effort the step shows and the chat's own access. Steps wait for the steps they run after, count toward Tasks at once and the task limits, and work directly, in their own copy or waiting their turn like any task. If any step can't start, none does. The steps are grouped under the plan in Tasks, the Plan panel follows each one, Stop plan stops the working steps and cancels the rest, and Close plan closes them together. A step's task can't split into more tasks.
• A near-black Dark theme (#127). The themes are now Light, Dark and Graphite. Dark is new: near-black surfaces with cream text, for low light and OLED screens. Graphite is the warm dark that was called Dark before, and a saved Graphite choice keeps its look. System switches between Light and the new Dark, so if you use System on a dark computer, Codeshi now shows the near-black Dark; choose Graphite to keep the warm look. The status bar, Settings, setup, the desktop menu and the phone page all offer the four choices.
• Text size in Settings › Appearance (#127): Larger makes the sidebar, panels, Settings and the status bar about a point larger. Messages keep their size.
• Setup starts with your workspace and asks how you want to work (#129). The four steps are now: your workspace, your working style, your agents, then your defaults. Name the workspace and choose its folders, or drop them on the window. Codeshi then shows each folder's Git branch and number of changes, and the kind of project its files suggest. Choose your working style puts Normal and Flow side by side, each with a small picture of its layout and three short lines: who chooses the agent and model, what you see, and what happens near a usage limit. Codeshi opens in the one you pick, and you can switch at any time with the Flow button or in Settings › General.

Changed

• Settings has a page for each subject (#130): General (Normal or Flow, and Keep awake), Appearance, Agents & accounts, Routing & handoffs (handoff offers and the context limit), Testing, Phone & remote, Voice, Alerts and Updates. Before, General held most of these. Search still finds a setting on any page, and Remote access, the command search and the connection prompts open the page that holds the setting.
• Larger, steadier text and controls (#127, #130). The sidebar, the Tasks and side panels, the status bar and Settings use one type scale, with nothing below 11.5 px and status bar text at 12.5 px. The status bar is a little taller. Buttons use three heights (24, 28 and 32 px), and dialog titles share one size. Faint text is a little brighter in every theme, so it stays readable on selected rows.
• Entering Flow takes a moment to say what it is. The seal lands, then the word Flow and one line, "Let it flow. Watch it ship.", before the cards appear. It takes under two seconds. Leaving Flow is as quick as before, and with reduced motion the view just changes.
• Workspace rows in the sidebar use two lines (#127). The name has the first line to itself, and the folder count, running and approvals waiting sit on the line below. Neither cuts off the other, and the row's menu button no longer hides them.

Fixed

• The message box's bottom row stays on one line when the window is narrower. Can edit files, then the permissions picker, shrink to their icons before anything moves to a second line.
• Attachments leave the message box the moment you send or queue a message, together with its text, instead of staying until Auto finishes choosing an agent. The message shows its attachments in the chat at once, and they come back to the box if the message is refused.
• Removing an attachment corrects the "attached" count under the message box, and removing the last one clears the line.
• In Flow's What's next, the step being worked on is an ordinary row like the others, with a filled mark and stronger text, instead of a separate highlighted box that looked like the working agent's row in What's left on your plans.