Add explicit git fetch and reset after checkout to guarantee
workflows get the most recent main branch commits, including
version bumps pushed by the bump-version workflow.
The issue: When using workflow_call, even with ref: main, GitHub
Actions may use a cached repository state from workflow run start.
This caused version consistency checks to fail because the checkout
didn't include the just-pushed version bump.
Solution: After checkout, explicitly fetch and reset to origin/main
to ensure we have the absolute latest code. Added logging to show
the current commit for debugging.
Fixes: https://github.com/trycua/cua/actions/runs/19482970320🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Ensure publish workflows check out the main branch to get the
latest bumped version after the bump-version workflow pushes changes.
Previously, workflows were checking out the SHA at trigger time,
which didn't include the version bump committed by bump-version job.
This fixes the "Verify version consistency" step failure where the
expected version didn't match the pyproject.toml version.
Related to: https://github.com/trycua/cua/actions/runs/19482814921🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Replace heredoc-based Python script with inline command to fix
exit code 2 error in the "Capture bumped agent version" step.
The heredoc syntax with indented EOF marker was causing issues
in GitHub Actions. Simplified to a single-line Python command.
Fixes: https://github.com/trycua/cua/actions/runs/19482457144🤖 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>
Add epilogue to help output that clarifies the recommended command structure
(grouped commands like 'cua auth' and 'cua sb'). While flat commands remain
available for backwards compatibility, the help now clearly guides users toward
the more organized grouped command style.
Changes:
- Add usage and epilogue text to cli.ts explaining grouped command structure
- Mark flat commands as hidden (though yargs doesn't fully respect this for top-level commands)
- Add type annotations to command builders to fix TypeScript errors
- Epilogue shows recommended patterns: 'cua auth <command>' and 'cua sb <command>'
- Include docs link for more information
The help output now clearly distinguishes between available commands and
recommended command patterns, reducing confusion while maintaining full
backwards compatibility.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add support for grouped auth command structure (cua auth login/env/logout)
while maintaining backwards compatibility with flat commands (cua login/env/logout).
Update all documentation to prefer the more explicit grouped style.
Changes:
- Refactor auth.ts to support both flat and grouped command structures
- Extract auth command handlers for reuse (loginHandler, envHandler, logoutHandler)
- Add "cua auth" command group with login/env/logout subcommands
- Update quickstart to use "cua auth login" instead of "cua login"
- Update CLI index.mdx and installation.mdx to use grouped style
- Update commands.mdx to show grouped style as primary with flat as alternative
- Update README.md to document both command styles
- Update error messages and examples to use grouped style
Both command styles work identically - users can choose based on preference.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Consolidate the separate "Cloud Sandbox (CLI)" and "Cloud Sandbox (Website)"
tabs into a single "Cloud Sandbox" tab that shows both methods. This reduces
duplication and makes it clearer that both approaches are available.
Changes:
- Merge Cloud Sandbox tabs in "Set Up Your Computer Environment" section
- Merge Cloud Sandbox tabs in "Using Computer" section for Python
- Merge Cloud Sandbox tabs in "Using Computer" section for TypeScript
- Update comments to indicate sandbox name can come from CLI or website
- Mark CLI as recommended method in setup instructions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Rename the VNC command from 'open' to 'vnc' for clarity and specificity.
Keep 'open' as an alias for backwards compatibility.
Changes:
- Update command definition to use 'vnc' as primary, 'open' as alias
- Update README.md to reflect new command name
- Update commands.mdx documentation with new command and alias
- Update quickstart.mdx to use 'cua sb vnc'
- Update command examples in tips section
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Update documentation and examples to showcase the 'cua sb' shorthand as
the primary grouped command style, since it's more concise than
'cua sandbox'.
Changes:
- CLI index docs: Use `cua sb` in examples
- Command reference: Show `cua sb` first, then `cua sandbox` as alternative
- Quickstart guide: All sandbox commands now use `cua sb`
- README: Reorder to show `cua sb` as primary grouped style
Auth commands remain flat: `cua login`, `cua env`, `cua logout`
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The option `--size` is much more intuitive than `--configuration` when
the values are small/medium/large.
Changes:
- CLI option renamed from `--configuration` to `--size`
- API still receives `configuration` parameter (internal mapping)
- Updated all documentation to use `--size`
- Updated examples in README, docs, and quickstart
Users now use:
- `cua create --os linux --size small --region north-america`
Instead of:
- `cua create --os linux --configuration small --region north-america`
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Support both flat (`cua list`) and grouped (`cua sandbox list` or `cua sb list`)
command styles for maximum flexibility.
Key changes:
- Extracted command handlers to be reusable
- Register each command in both flat and grouped structures
- Add `sb` as shorthand alias for `sandbox`
- Update documentation to show both styles
Users can now use:
- Flat: `cua list`, `cua create`, `cua start <name>`
- Grouped: `cua sandbox list`, `cua sandbox create`, `cua sandbox start <name>`
- Shorthand: `cua sb list`, `cua sb create`, `cua sb start <name>`
All three styles work identically!
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Replace example sandbox names from "my-vm-abc123" to "my-sandbox-abc123"
for consistency with the VM → Sandbox refactoring.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Remove environment override sections that referenced staging deployments
from both the README and documentation. Users should only interact with
production environments.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Update environment variables example to use 'cua list' instead of
'cua vm list' to align with the CLI refactoring.
Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
