Skip to content

docs: note sibling rl-harness symlink for experiment smoke runs - #3

Draft
Al-does wants to merge 1 commit into
mainfrom
cursor/document-sibling-symlink-gotcha-78df
Draft

docs: note sibling rl-harness symlink for experiment smoke runs#3
Al-does wants to merge 1 commit into
mainfrom
cursor/document-sibling-symlink-gotcha-78df

Conversation

@Al-does

@Al-does Al-does commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Summary

While setting up the Cloud Agent dev environment for this library, I hit one non-obvious gotcha and documented it in AGENTS.md under ## Cursor Cloud specific instructions.

The experiment repo (alex-rl-experiments) declares an editable dependency rl-harness = { path = "../rl-harness" }, but the cloud checkout of this library is RL-Harness (Linux is case-sensitive) and bootstrap_local.sh only auto-links RL Harness / rl-harness-src. So uv sync / smoke runs from the experiment repo fail until a sibling rl-harness -> RL-Harness symlink exists. This PR records the one-time sudo ln -sfn ... fix for future agents. The library's own uv sync --group dev needs no symlink.

Environment verification (no code change)

  • uv sync --group dev (library) — provisions Python 3.14 into .venv, installs ray/torch/etc.
  • uv run pytest -q -m "not slow"138 passed, 5 deselected.
  • uv sync --group dev (experiment repo, via sibling symlink) — editable rl-harness resolves.
  • uv run rl-harness experiments.mess3_belief_geometry_2026_07.reward_only.experiment --smoke — PPO trial trained 2 iterations on HMMEnv, terminated completed, episode_return_mean ≈ 41.55, run manifest written with full provenance.

Only AGENTS.md changes; no source code touched.

Open in Web Open in Cursor 

Co-authored-by: Alex Vardakostas <Al-does@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants