0.3.0 – Windows support, shell mode, config & history

Highlights:

Windows support (PowerShell / CMD detection)
New shell execution mode with fallback to LLM
Unified config directory ~/.cliagent
Persistent command history (readline / pyreadline3 on Windows)
Improved error detection & natural language fallback
Cross-platform clear screen
Refactored providers layout & system context reporting
Details:

Added modules: agent.config, agent.core_agent, agent.utils, interface.shell_interface, input_handler package
Conditional dependency: pyreadline3 on Windows
Removed legacy flat scripts (agent.py, utils.py, input_handler.py)
Breaking:

CLI internals and module paths changed; upgrade requires reinstall.
Install / Upgrade:

uv tool install --force "git+https://github.com/anfedoro/cli-agent.git@v0.3.0"

Quick start/use:

cli-agent [-h] [--verbose] [--provider {openai,gemini,lmstudio}] [--model MODEL] [--no-reasoning] [--mode {chat,shell}] [--trace]
               [--no-restore]

LLM Terminal Agent

options:
  -h, --help            show this help message and exit
  --verbose, -v         Show detailed token usage information
  --provider {openai,gemini,lmstudio}, -p {openai,gemini,lmstudio}
                        LLM provider to use (default: openai)
  --model MODEL, -m MODEL
                        Model to use for the selected provider
  --no-reasoning        Disable reasoning process for faster responses (LM Studio)
  --mode {chat,shell}   Run mode: chat (conversation) or shell (command mode) (default: shell)
  --trace, -t           Enable trace mode (show LLM execution details, only in shell mode)
  --no-restore          Don't restore initial directory on exit (shell mode only)

License: MIT