Compatibility and support
txtop 1.x uses semantic versioning for the installed command-line application, its documented configuration, and documented non-experimental commands.
Stable in 1.x
- Documented config keys will not be removed or change meaning in a minor or patch release. New optional keys and values may be added.
- Documented commands and flags will remain available throughout 1.x. A replacement will be introduced before an old spelling is removed in a future major release.
- Existing databases are upgraded automatically with transactional migrations. Database schemas are internal and are not a supported direct-query API.
- Linux, macOS, and Windows builds support the TUI and collector on x86-64 and
ARM64. The Live process tree is Linux-only because it reads
/proc.
Database migrations are forward-only. Before downgrading txtop, back up or move the platform data directory and let the older version create a compatible database.
Experimental or best effort
These surfaces can change in a minor release when an upstream integration changes, but changes will be called out in the changelog:
- Codex and Claude Code live-limit requests
- local Codex, Claude Code, and Gemini CLI log parsing
- OTLP receiver flags and source mappings
- OpenRouter Broadcast mapping
- Ollama proxy behavior and price estimation
- hidden
service,otel,proxy, and debug-oriented commands
Failures remain isolated and visible where practical. See unofficial integrations for the user-facing support boundary.
Only fields listed in the configuration reference are part of the documented config contract. Internal application fields and demo-only settings can change within 1.x.
Rust library API
txtop is distributed and supported as a single binary. The Rust modules exposed
by the package exist to structure the application and support its tests; they
are not a stable library API and may change within 1.x. Consumers should invoke
the txtop command rather than depend on the crate as a library.
Minimum Rust version
Installing from crates.io requires Rust 1.88 or newer. CI checks the package with Rust 1.88 as well as the current stable toolchain.