v0.2.4

Release v0.2.4 - Cross-Platform Compatibility Fix

This release fixes critical bugs that prevented the CLI from working on multiple platforms.

🐛 Bug Fixes

Fixed: CLI Crashes on Startup (#4, #5)

Problem: Users encountered TypeError: Secondary flag is not valid for non-boolean flag when running any command, making the CLI completely unusable.

Cause: Typer 0.9+ changed behavior where short flags (like -m, -t, -s) on non-boolean options cause validation errors.

Solution: Updated all CLI options to use long-form flags for non-boolean parameters. Boolean flags like --verbose/-v continue to support short forms.

Fixed: Windows Compatibility (#3)

Problem: Users on Windows received ModuleNotFoundError: No module named 'termios' preventing installation.

Cause: The tty and termios modules are Unix-only and don't exist on Windows.

Solution: Made imports conditional based on platform and added getpass fallback for password input on Windows.

🖥️ Platform Support

The CLI now works on all major platforms:

Platform	Status
macOS	✅ Supported
Linux	✅ Supported
WSL2	✅ Supported
Windows	✅ Supported

📝 CLI Option Changes

Non-boolean options now use long-form flags only:

# Before (no longer works)
perplexity ask "question" -m large -t physics
perplexity export-chat 123 -f json -o file.json

# After (use this)
perplexity ask "question" --model large --topic physics
perplexity export-chat 123 --format json --output file.json

Boolean flags still support short forms:

perplexity ask "question" -v          # --verbose
perplexity rag "query" -v --explain   # --verbose

⬆️ Upgrade Instructions

# Using pip
pip install --upgrade pplx-cli

# Using pipx
pipx upgrade pplx-cli

# Verify installation
perplexity --version
# Should show: Perplexity CLI version 0.2.4

🙏 Thanks

Thanks to @Roderick111, @hossam-houssien, and @ThatGuyIvory for reporting these issues!

---

Full Changelog: v0.2.3...v0.2.4