Repository navigation
Install the CLI with npm install -g apexo-code@1.2.1, or download a standalone CLI archive below. Keep the CLI and its workflow interpreter together.
Desktop installers are available for macOS Apple Silicon, Linux x64, and Windows x64. The current macOS build uses an ad-hoc signature without notarization; the Windows build has no publisher certificate.
Detailed installation guide · Release automation guide
Verify downloads using the attached SHA256SUMS.
Highlights & Recent Changes (v1.2.0 → v1.2.1)
1. TUI Theme Contrast & Invisible Text Fixes (packages/tui) (#203)
- Transparent Background & Selection Foreground Guard (
selectedForeground): Fixed an alpha-channel bug inselectedForeground(theme, bg)where themes withbackground: "transparent"(such aslucent-orng) hadtheme.background.luminance() === 0and returned transparentRGBA(0, 0, 0, 0)text for highlighted list items, dialog buttons, and badges.selectedForeground()now ignores transparent backgrounds, checks contrast (>= 4.5:1) against the target highlight surface (bg ?? theme.primary), and falls back to opaque#000000or#ffffff. - Automatic Theme Token Contrast Normalization (
resolveTheme): Enforced readable contrast floors across canvas, panel, and element surfaces for all 34 built-in TUI themes andsystemin bothdarkandlightmodes (primary text>= 4.5:1, semantic/syntax/markdown tokens>= 3.2:1, muted/comment/diff-context tokens>= 2.8:1, andselectedListItemText>= 4.5:1). - Built-in Theme Asset Fixes (
lucent-orng,catppuccin-frappe,catppuccin-macchiato,vesper):- Added opaque panel, element, and menu surfaces to
lucent-orng.jsonwhile keeping the root canvas transparent. - Added proper Catppuccin Latte light-mode palettes to
catppuccin-frappe.jsonandcatppuccin-macchiato.json. - Added distinct dark panel/element surfaces and high-contrast light-mode tokens to
vesper.json.
- Added opaque panel, element, and menu surfaces to
- Opaque Floating Surfaces & Reactive
/themeLive Preview:- Updated
DialogandToastcontainers to fall back to an opaque surface whentheme.backgroundPanel.a < 0.85, preventing underlying transcript text from bleeding through modals. - Made
DialogSelectoption and footer action foregrounds reactive (createMemo) and switched the filter inputfocusedTextColorfromtheme.textMutedtotheme.text.
- Updated
2. CLI --mini Footer & System Theme Fixes (packages/apexo) (#203)
- Footer Menu Selected Row Contrast: Fixed dark-on-dark active menu row text (
~1.15:1contrast) in--minimode by pairingfooter.selected = footerTheme.backgroundElementwithfooter.selectedText = footerTheme.text. - System Light-Mode Fallback: Fixed
generateSystemso light mode falls back to#fafafa/#1f2937instead ofpalette[0](#000000) when the terminal does not report adefaultBackground.
3. Desktop / Web Theme Contrast & Typography (packages/ui) (#203)
- Accurate sRGB Relative Luminance: Fixed the green channel luminance weight in
packages/ui/src/theme/color.ts(0.587→0.7152). - Desktop V1 & V2 Theme Contrast Guardrails: Enforced contrast minimums across V1 (
text-base >= 4.5:1,text-weak >= 3.5:1) and V2 (v2-text-text-base >= 4.5:1,v2-text-text-muted >= 4.2:1,v2-text-text-faint >= 2.8:1) foreground resolvers, and updatedcatppuccin-frappe.json,catppuccin-macchiato.json, andmatrix.jsoninpackages/ui. - System & CJK Font Fallbacks: Added system UI and CJK fallback fonts (
PingFang SC,Hiragino Sans GB,Microsoft YaHei) to--font-family-text,--v2-font-family-sans, and--font-family-sans.
Pull Requests Included
- fix(ui): enforce readable theme contrast across tui, cli, and desktop by @cluster1900 in #203
Full Changelog: v1.2.0...v1.2.1