Codex Desktop: replace the downloaded-update icon with a labeled Update action and three-pulse startup cue

Open
#35,219 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
rust
Domain
design, desktop

Research direction

Start with the linked startup-update-affordance-spec.md and prototype to understand the ready-state label, startup cue, reduced-motion behavior, and confirmation flow. Locate the account-row update state and existing confirmation entry point, then verify the three-pulse, non-looping behavior, narrow-width layout, and Update and restart activation against the acceptance criteria.

Written by the indexing model from the issue text.

Description

app enhancement windows-os

Summary

When a Codex Desktop update is already downloaded and ready to install, show a labeled Update action instead of an icon that conventionally means download. At app startup, contract a button-shaped aura toward the action exactly three times so the waiting update is noticeable, then stop.

Problem

In the observed Windows account row, the control rests as a download icon and reveals Update on hover. The resting state is ambiguous once the package is ready and is easy to miss at startup.

Proposed UX

  • Keep the control in the existing account-row position.
  • In the ready-to-install state, remove the download glyph and show Update.
  • On each app start while that state remains active, contract a visible aura toward the action three times over roughly 2.5 seconds.
  • Keep the button itself still; animate only the separate aura.
  • After the third pulse, keep the action still for the rest of the session.
  • Do not replay the cue on focus changes, navigation, sidebar interaction, or account-menu use.
  • Clicking Update opens the existing confirmation flow, whose primary action reads Update and restart.
  • Remove the action after the installed version becomes active.
  • Under reduced-motion preferences, skip the aura and keep the labeled action still.

Acceptance Criteria

  • Ready-to-install state uses the text Update, not a download icon.
  • The account label and action remain readable without overlap at narrow widths.
  • Startup animation runs exactly three times and never loops.
  • The cue is tied to app start and does not replay during normal use.
  • The button remains usable while emphasized.
  • Activation reaches the existing confirmation flow with Update and restart as the primary action and cannot be submitted twice.
  • Earlier downloading and progress states retain truthful state-specific treatment.

Evidence Boundary

This request is based on supplied Windows screenshots showing the account-row icon and labeled Update state. It does not claim that update downloading, verification, or installation is broken. The proposal is limited to the ready-state label and startup emphasis.

Prototype

The reporter's screenshots are not included. The prototype uses generic account and workspace labels.

Dominant language
Rust
Stars
125k
Forks
19.5k
Avg merge
1m
Merged PRs (30d)
1k

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from openai/codex

All issues in openai/codex

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.