feat(cli): persist interactive preferences safely

Author: hamzabudeir

.gitignore

@@ -186,7 +186,10 @@ cython_debug/
 #   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #   and can be added to the global gitignore or merged into this file.  For a more nuclear
 #   option (not recommended) you can uncomment the following to ignore the entire idea folder.
-# .idea/
+.idea/
+
+# Local agent state and scratch artifacts
+.agents/
 
 # Abstra
 #   Abstra is an AI-powered process automation framework.

CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 Breaking changes within the 0.x line are called out explicitly.
 
+## [Unreleased]
+
+### Added
+
+- **Saved CLI preferences.** Interactive users can persist provider, model,
+  research-depth, language, and reasoning settings in
+  `~/.tradingagents/preferences.json`, reuse them on later runs, inspect them
+  with `config show`, update them with `config set`, or clear them with
+  `config reset`.
+
+### Fixed
+
+- Preserved the legacy root analysis options alongside the explicit `analyze`
+  command and applied the Windows no-console guard consistently to analysis and
+  preference commands.
+- Prevented incomplete or newer-version preference files from being silently
+  reused or overwritten, and kept provider changes from combining incompatible
+  saved models, endpoints, or reasoning settings.
+- Avoided the first-run save prompt in non-interactive sessions and stopped
+  cleanly when the saved-preferences prompt is cancelled.
+
 ## [0.3.1] — 2026-07-05
 
 Correctness and stability patch: data look-ahead, graph-router crash-safety,

README.md

@@ -169,6 +169,34 @@ python -m cli.main     # alternative: run directly from source
 ```
 You will see a screen where you can select your desired tickers, analysis date, LLM provider, research depth, and more.
 
+### Saved CLI preferences
+
+If you use the CLI interactively, you can save the settings that normally stay
+the same between runs:
+
+```bash
+tradingagents config set             # configure and save provider/model settings
+tradingagents config show            # display saved settings
+tradingagents analyze                 # reuse saved settings for a new analysis
+tradingagents analyze --configure    # run setup again and replace saved settings
+tradingagents config reset            # remove saved settings
+```
+
+Saved preferences are stored at `~/.tradingagents/preferences.json`. They cover
+the provider, models, research depth, output language, and provider-specific
+reasoning options. The ticker, analysis date, and analyst team remain per-run
+choices. Explicit `TRADINGAGENTS_*` environment variables take precedence over
+saved preferences, and API keys remain in the environment or `.env` file rather
+than in the preferences file.
+
+The legacy root form remains supported, so `tradingagents --checkpoint` and
+`tradingagents --no-checkpoint` are equivalent to the corresponding options on
+`tradingagents analyze`. If `TRADINGAGENTS_LLM_PROVIDER` changes the provider
+from the one saved in preferences, the CLI does not mix provider-specific
+models, endpoints, or reasoning settings: matching environment overrides are
+used, otherwise the new provider's defaults are selected. Custom-only providers
+require matching model environment variables or `--configure`.
+
 ### Markets and tickers
 
 TradingAgents works with any market Yahoo Finance covers, using the exchange-suffixed ticker. Company identity and the alpha benchmark resolve automatically per market.