25.09.2

25.09.2 - 2025-09-25(hotfix)

A hotifx release after 25.09.1

Introduced a number of hotfixes for critical bugs:

• AppImage
  • Introduced additional points of termination for backend-manager(fixed fatal crash)
  • Removed raw usages of /tmp in parts of our codebase
  • Set relative rpath instead of depending on LD_LIBRARY_PATH(fixed fatal crash)
• macOS
  • Fix ruby not being symlinked
  • Removed raw usages of /tmp in parts of our codebase
  • Introduced additional points of termination for backend-manager
• Other fixes
  • The help message no longer uses the internal executable name instead of ct
  • The Gentoo package was renamed to codetracer-bin from codetracer
  • The AUR package now upgrades without having to uninstall it and delete its pacman caches

We're actively working on multiple exciting features, which are not fully released yet. Stay tuned!

Available downloads:

Key signatures:

25.09.1

25.09.1 - 2025-09-19

We are releasing our initial version with DAP support and reformed frontend architecture!

• DAP support and frontend architecture reform:
  Our backend and frontend have been reformed: now we use DAP instead of our older custom protocol, and
  our frontend components are more self contained and independent: needed for our work on a CodeTracer extension.
  Our DAP support is tested more under VsCode. We don't implement many optional aspects yet, but we do implement our custom
  functionalities and queries, defining our custom extensions to DAP: ct/-namespaced custom requests and events.

• A new backend multiplexer:
  We have also added an experimental new backend multiplexer, which gets us closer to the ability to replay multiple traces/backend instances
  in the same session and window.

We have also many other important improvements:

• Integrated a reformed version of the Ruby recorder

• Support for our newer trace binary trace format "version 1", based on CBOR and Zstd seekable compression

• Generate packages for some of the mainstream Linux distributions: #56 :
  please look at the README for links/more info!

• codetracer-wasm-recorder

• Hotfix the locals array to resize itself dynamically, resolving an array out of bounds crash for our Stylus wasm recorder

• various bugfixes:

  • some fixes for ct host: the browser mode of codetracer and for our cloud integration
  • a bugfix for ct record: store sensible source folders if the context is not a git repo
  • various build fixes

• Various UI improvements:

  • Fixed certain tooltips and popups produced by the editor widget being clipped in the first lines of code
  • Fixed incorrect text highlighting persistance after selecting a file in the global search bar

• macOS support:

  • Fixed dead link preventing users from recording ruby correctly
  • CodeTracer no longer requires homebrew(homebrew is still required for ruby)
  • The CodeTracer team now officially supports all versions of macOS, since macOS 12 Monterey

We're actively working on multiple exciting features, which are not fully released yet. Stay tuned!

Available downloads:

Key signatures:

25.07.1

v25.07.1: Arbitrum Stylus & WASM Support

This release introduces initial support for tracing Arbitrum Stylus contracts and WASM binaries, along with significant stability and usability improvements.

🚀 Major New Features

• Arbitrum Stylus & WASM Tracing: CodeTracer can now record and replay Arbitrum Stylus contracts and Rust programs compiled to WebAssembly (WASM).
  • This is powered by our new WASM recorder, a fork of the [wazero](https://wazero.io/) runtime. See the repository here: codetracer-wasm-recorder.
  • Dive in with our new documentation:
    • Getting Started with Stylus
    • Getting Started with WASM

✨ Improvements & Fixes

• Improved Temporary Directory Handling: CodeTracer now respects standard OS environment variables (like TMPDIR on Linux) for temporary files instead of hardcoding /tmp. This fixes permission errors for multi-user environments on a single machine.
• Native macOS Menu: The app now uses the native macOS system menu for a more polished and integrated experience, replacing the previous HTML-based menu.
• Experimental Trace Format: The db-backend now supports a new, experimental binary tracing format for more compact and efficient trace files.
• Stability: Fixed several bugs related to process management to improve overall application stability.
• UI/UX: Various other user interface enhancements and small configuration schema improvements.

We're already hard at work on the next set of features. Stay tuned!

Downloads

CodeTracer 25.05.1

25.05.1 - 2025-05-05

The first release in a while, including our progress since March:

• Fixes:
  • Reopening closed editors bugfix
  • Ruby support: fixing the omniscience support,
    a rudimentary way to override the interpreter and
    point to a newer refactored version of the Ruby recorder
  • Using trace_paths.json as part of the language detection for db-based traces
  • Fix the db-backend support for multiple values for each tracepoint step
• Integration with the proprietary rr backend for native languages
  (currently requires a separate setup for the rr backend, and custom configuration pointing to it)

Warning

You might need to reset your codetracer config/trace directory, as there have been some schema changes. The local db supports some amount of auto-creating new columns, but the config setup doesn't yet support auto-updating, so if you experience any issues(and you DON'T have important traces already stored), for now you can delete $HOME/.config/codetracer and/or $HOME/.local/share/codetracer . If the situation is more specific, please feel free to open an issue or contact us on Discord!

We're actively working on support for several big features, which are not yet fully released or ready for usage: stay tuned!

CodeTracer 25.03.3

Weekly Release (31 March 2025)

Our second weekly release. It includes:

• A linking fix for our macOS build

This release doesn't include new features, but we're working on several bigger new features and on the Windows support: stay tuned for the next releases!

CodeTracer 25.03.2

🎉 Weekly Release (24 March 2025)

We're excited to kick off our new weekly release cycle! This update includes several key fixes and enhancements based on initial feedback after the initial release from a month ago:

🐞 Bug Fixes & Build Improvements

• Implemented fixes, automations, and enhancements to our build processes, addressing issue #25.

🚨 Enhanced Notifications & Error Messages

• Rolled out an initial iteration of improved notification and error-message UX for better clarity and user experience:
  

🧹 Refactoring & Cleanup

• Refactored and cleaned up the ct entrypoint source code for improved maintainability and clarity.

📚 Documentation Improvements

• Migrated the contributors guide to mdbook for easier navigation and improved readability.

✅ UI Testing Restored

• Restored end-to-end (e2e) UI tests using Playwright, adapting them to the publicly released DB backend.
• Initiated work to expand the UI test coverage further.

Thank you to all contributors for making these improvements possible! 🚀

CodeTracer 25.03.1

The initial release of CodeTracer with support for Noir debugging.

It features the initial designs of our Call Trace, Event Log, State
and History Explorer, Scratchpad and File Explorer panels.

It offers basic support for Noir tracepoints (no function evaluation)
and the lite display mode of OmniScience.