Repository navigation
CatGo 1.4.14
CatGo 1.4.14 is the completed cross-platform reliability release for CatBot,
Campaigns, scientific workflows, large trajectories, and the integrated
terminal. It supersedes the unpublished 1.4.10–1.4.13 drafts and includes a
Windows UTF-8 correction found by the packaged-runtime release smoke test.
Highlights
- Installed CatBot is complete on Windows, macOS, and Linux — Claude,
Codex, and Gemini discovery, attachments, voice, Skills, CatGo MCP tools,
structures, workflows, and Campaigns are exercised from packaged backends. - Windows Campaigns are fast and Unicode-safe — frozen actions execute in
the existing backend process, and every Campaign Markdown read/write uses
UTF-8 instead of the Windows cp1252 locale. - Surface workflows are scientifically complete — the clean slab is
relaxed before adsorbate branches, while exact frozen atoms propagate through
slab optimization, adsorbate optimization, and frequency calculations. - Large trajectories and terminals stay usable — bounded frame caches
reduce memory pressure, and terminal reflow keeps CJK text and the final
column visible beside the scrollbar. - Release assets are version-bound — desktop packages, mobile builds,
sidecars, VSIX, HPC bundles, legal files, signatures, and mirror metadata are
validated against the exact tag before publication.
Fixed
Windows CatBot and Campaigns
- Fixed packaged Campaign actions timing out after recursively relaunching the
PyInstaller one-file backend. Frozen dispatch now runs in-process without
blocking asynchronous REST or MCP requests. - Fixed Campaign creation failing on Windows with
UnicodeEncodeErrorwhen a
generated Markdown file contained characters such as→,₂, or CJK text.
Campaign scaffolding, status, analysis, literature, report, and VASP sanity
text I/O now specifies UTF-8 explicitly. - Added a regression test that rejects Campaign scaffolding code which falls
back to the operating-system locale codec. - Fixed GUI-launched desktop apps failing to find user-installed Claude, Codex,
or Gemini CLIs because Windows and macOS launchers supplied a reduced PATH. - Fixed Windows local terminals selecting the wrong shell or losing their
working directory across runtime transitions.
CatBot integration
- Preserved each user's Codex Skills and MCP configuration while registering
CatGo desktop tools in an independent namespace. - Added live Codex model discovery so the CatBot label follows the installed
CLI instead of displaying a stale hard-coded model version. - Fixed images, PDFs, text documents, and general attachments appearing in the
composer without reaching Claude, Codex, Gemini, or backend-relay requests. - Fixed the first microphone request racing the native voice router and getting
stuck on an unavailable browser fallback. - Routed structure, workflow, Campaign, and export operations through the active
CatGo runtime connection instead of fixed localhost ports. - Preserved structures when pop-out chat or viewer windows are closed and later
reopened.
Workflows and surface science
- Added safe bulk selection and deletion for project and workflow lists, with
durable success and failure feedback. - Derived workflow state from task evidence so CHECK, PAUSED, FAILED,
REMOTE_ERROR, RUNNING, and completed workflows are not mislabeled. - Added clean-slab geometry optimization before adsorbate branches generated by
CatBot. - Persisted manually selected frozen atoms and slab-generated constraints into
downstream geometry optimization and adsorbate-only frequency inputs. - Fixed slab and geometry-optimization previews displaying different frozen
layers for the same structure.
Networking, trajectories, and terminal rendering
- Prevented Materials Project, OPTIMADE, and PubChem requests from inheriting
agent-only SOCKS proxy settings while retaining ordinary backend proxy
support. - Improved OPTIMADE provider recovery and error reporting.
- Synchronized typed trajectory positions with topology and bond snapshots in
Large System Performance Mode, bounded decoded frame caches, and avoided
retaining an unbounded bond-object graph. - Reserved terminal columns beside the scrollbar and reflowed active full-screen
applications when the font changes, preventing clipped CJK characters.
Packaging and verification
- Windows, Linux, and macOS frozen backends run end-to-end CatBot smoke tests,
including Provider discovery, all bundled core Skills, CatGo MCP tools,
structure and pane access, workflows, and real Campaign creation. - Compiled Agent Bridge tests cover Claude, Codex, and Gemini sessions,
attachments, permissions, failures, and stream completion. - VS Code Marketplace and Open VSX publication waits for exact-version Linux,
macOS, and Windows sidecars plus SHA-256 metadata on the public mirror. - Linux packaging selects an ABI-compatible conda C++ runtime and validates all
collected CXXABI and GLIBCXX requirements.
Upgrade notes
- No project, workflow database, structure-file, trajectory, or Campaign
migration is required. - Existing Codex Skills and MCP configuration are retained. CatGo's desktop MCP
entry is isolated automatically. - Workflow deletion remains disabled for genuinely executing tasks and remote
jobs whose identity is unresolved. - Review generated slab constraints and calculation inputs before HPC submit;
scientific structure and submit safety gates remain enabled. - Reattach a file before a restored-chat follow-up that must reread its bytes;
restored history keeps attachment metadata, not the original file payload.
Downloads
- Windows x86-64 —
.msior-setup.exe - macOS Apple Silicon — Developer-ID signed
.dmg - Linux x86-64 —
.debor.rpm - Android —
CatGo-v*-android-universal.apk - iOS — TestFlight beta
- VS Code / Cursor / VSCodium / Theia —
.vsix - Headless/HPC — platform sidecars and
catgo-hpc-bundle.tar.gz
License and citation
CatGo 1.4.14 distributions use AGPL-3.0-or-later.
If CatGo contributes to your work, please include this acknowledgement and the
preferred citation:
This work used CatGo (https://app.catgo-ucsd.org).
Please cite DOI
10.1039/D6DD00273K.
This request is not an additional condition of the AGPL license. Third-party
materials retain their own terms. Historical AGPL grants remain in effect.
See the
CHANGELOG
for the complete release history.