Reference / Trace App CLI

CLI Roadmap

Native CLI availability, compatible app builds and the boundary between source support and releases.

Available tools

Use Command reference to find the appropriate command family, then check the native trace-cli from your installed Trace app:

trace-cli --version
trace-cli --help
trace-cli chat --help

Use the actual installed executable path if it is not on PATH. Install Trace and sign in to the main app first for AI and cloud Workspaces commands; expired sessions need desktop refresh/sign-in. Local ERC, DRC and exports do not technically need authentication.

The native tree includes chat modes, saved-file checks, exporters and Workspaces commands. A feature in source or the service is not automatically present in a released installer. See Product availability and CLI version notes.

Compatibility previews

Native trace-cli workspaces requires compatible app and service support. Add, Pull, Switch, Move, conflict-aware Restore and PR operations must have their owning native handlers; they are not guaranteed in every downloaded installer. Start with the native read/review workflow.

The native CLI is not documented as an MCP server and offers no BYOK setup command. Do not add guessed flags or revive older developer setup instructions.

Future improvements

Clearer command help, reproducible automation, conversion review and recovery are important areas for improvement. This page does not commit to new command names, a release version or delivery dates. A proposal becomes an available workflow only after the owning client and service support it and its release is verified.

Report a missing workflow or documentation mismatch through Feedback. Include your executable/version and the relevant help output, without credentials or private design content.