Previously, users had to explicitly read the CUA_API_KEY environment variable
and pass it to the Computer/CloudProvider constructor. This change makes the
API key parameter optional and automatically reads from the CUA_API_KEY
environment variable if not provided.
Changes:
- CloudProvider.__init__: Made api_key parameter optional, reads from CUA_API_KEY env var
- Computer.__init__: Added fallback to CUA_API_KEY env var for api_key parameter
- Updated documentation examples to show simplified usage without explicit api_key
- Updated cloud_api_examples.py to demonstrate the new simpler pattern
This provides a cleaner API while maintaining backward compatibility with
explicit api_key parameter passing.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
hud-python is an external package that isn't published to PyPI yet,
which was blocking installation of cua-agent[all]. This change:
- Removes hud-python==0.4.52 from the [all] extra dependencies
- Keeps the separate [hud] extra for users who have access to hud-python
- Allows pip install cua-agent[all] to work without dependency errors
The hud functionality remains available as an opt-in extra via:
pip install cua-agent[hud]
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add introducing-cua-cli.md blog post following the Windows/macOS announcement style
- Update CLI sandbox command to use sandbox.cua.ai domain instead of containers.cloud.trycua.com
- Update all documentation references to use new sandbox.cua.ai domain
- Maintain consistency with Python SDK which already uses sandbox.cua.ai
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Register grouped commands (auth, sandbox/sb) first so they appear at top of help
- Hide flat commands from help using describe: false while maintaining functionality
- Fix remaining --configuration references in docs (should be --size)
- Improves help clarity by showing recommended command structure prominently
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhance help text throughout the CLI to make commands more discoverable
and their purposes clearer. Better descriptions help users understand
what each command does without consulting documentation.
Changes:
- Update main command descriptions:
- 'cua auth': "Authenticate with CUA (login, logout, or export credentials)"
- 'cua sb': "Create and manage cloud sandboxes (Linux, Windows, or macOS)"
- Improve auth subcommand descriptions:
- login: "Authenticate via browser or API key and save credentials locally"
- env: "Export your API key to a .env file in the current directory"
- logout: "Clear stored API credentials from this machine"
- Enhance sandbox subcommand descriptions:
- list: "List all your sandboxes with status and connection details"
- create: "Provision a new cloud sandbox in your chosen OS, size, and region"
- delete: "Permanently delete a sandbox and all its data"
- start: "Start a stopped sandbox"
- stop: "Stop a running sandbox (data is preserved)"
- restart: "Restart a sandbox (reboot the system)"
- vnc: "Open remote desktop (VNC) connection in your browser"
- Expand epilogue to show command hierarchy with examples
- Replace generic descriptions with action-oriented, specific language
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
