Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,3 +31,20 @@
## Configuration & Secrets
- Set `HYPERBROWSER_API_KEY` via environment variables or pass `api_key=` in client constructors.
- Never commit API keys or session data; use `.env` or local shell exports for development.

## Cursor Cloud specific instructions

### Dev commands

- `poetry install` — install all dependencies
- `poetry run ruff check .` — lint (pre-existing warnings are expected in the
current codebase)
- `poetry run ruff format .` — auto-format
- `poetry run pytest` — run tests (pytest is a dev dependency)

### Gotchas

- Poetry must be on `PATH`. The Cloud Agent VM installs it via
`pip3 install poetry`; the binary lands in `~/.local/bin`.
- The baseline codebase has ~10 pre-existing ruff lint warnings (unused imports,
bare `except`). These are not regressions.