Skip to content

Set up Cursor Cloud dev environment - #7

Merged
schacon merged 2 commits into
mainfrom
cursor/setup-dev-environment-7e12
Aug 2, 2026
Merged

Set up Cursor Cloud dev environment#7
schacon merged 2 commits into
mainfrom
cursor/setup-dev-environment-7e12

Conversation

@schacon

@schacon schacon commented Aug 2, 2026

Copy link
Copy Markdown
Member

What

Sets up a development environment for the Pro Git book repository and documents it for future Cloud Agents.

This repo is the Pro Git book (AsciiDoc source). "Building" means converting progit.asc into HTML/EPUB/FB2/MOBI/PDF; there is no runtime backend or database. Two toolchains exist: the Ruby/Rake pipeline (what CI runs) and an optional Rust progit CLI in builder/ that also serves a local multi-page reader.

Changes

  • Add AGENTS.md with a ## Cursor Cloud specific instructions section covering the toolchains, build/test/lint commands, and non-obvious gotchas.

Environment setup

  • Installed Ruby 3.2 (apt) + Bundler; gems installed into ~/.bundle-gems via a global bundle path config.
  • Update script (runs on VM startup): bundle install.

Verification

  • bundle exec rake book:build (exact CI command) completes successfully (exit 0). It builds HTML/EPUB/FB2/PDF and runs the htmlproofer/epubcheck check step, whose external-link failures are intentionally rescued/ignored by the task.
  • Built the Rust progit binary (cargo build --release --manifest-path builder/Cargo.toml).
  • Ran the local reader progit serve --port 8080 and navigated the book in a browser (table of contents, prev/next links, sidebar TOC).

Non-obvious findings (documented in AGENTS.md)

  • Use book:build (not book:ci) for offline verification — book:ci does not ignore htmlproofer external-link failures.
  • book:build_mobi reports success but no longer emits progit.mobi (pre-existing asciidoctor-epub3 behavior).

progit_reader_navigation_demo.mp4

Pro Git reader homepage
Pro Git reader section page with sidebar TOC

Open in Web Open in Cursor 

Co-authored-by: Scott Chacon <schacon@gmail.com>
@schacon
schacon marked this pull request as ready for review August 2, 2026 07:53
@cursor

cursor Bot commented Aug 2, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

…ronment-7e12

# Conflicts:
#	AGENTS.md

Co-authored-by: Scott Chacon <schacon@gmail.com>
@schacon
schacon merged commit e18f0a4 into main Aug 2, 2026
1 check passed
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