- Fix basics.mdx: change browser: Browser to browser_session: BrowserSession
- Fix basics.mdx: use async functions and proper ActionResult return type
- Add Warning about parameter name matching in basics.mdx
- Add Warning and Common Pitfalls section in add.mdx with clear examples
- Update AGENTS.md embedded docs to match
The agent injects special parameters by name matching, not by type.
Using incorrect parameter names (e.g., browser instead of browser_session)
causes tools to fail silently, which was a common user confusion.
Co-authored-by: mailmertunsal <mailmertunsal@gmail.com>
**Description:**
This PR updates the Sandbox Quickstart example to make it fully runnable
when
copied into a standalone script.
**Changes:**
- Added `import asyncio`
- Wrapped the async sandbox entrypoint in:
```python
if __name__ == "__main__":
asyncio.run(production_task())
```
- Prevents the “coroutine was never awaited” runtime error.
**Issue:**
No related issue (minor documentation fix).
**Dependencies:**
None.
<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Fixed the async Sandbox Quickstart example so it runs as a standalone
script without errors. Added import asyncio and a __main__ guard that
calls asyncio.run(production_task()), preventing the “coroutine was
never awaited” runtime error.
<sup>Written for commit 7fd4a38a2b.
Summary will update automatically on new commits.</sup>
<!-- End of auto-generated description by cubic. -->
- Add cloud MCP server as recommended option with HTTP-based setup
- Include setup instructions for Claude Code, Claude Desktop, Cursor, and Windsurf
- Document cloud-specific features (browser_task, profiles, monitoring)
- Reorganize local self-hosted MCP as alternative option
- Fix bash command syntax with quoted 'browser-use[cli]' for zsh compatibility
- Add troubleshooting for PATH issues and CLI extras requirement
- Include full path examples for macOS/Linux uvx location
Saurav Panda