Skip to content

Set up Cursor Cloud development environment #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
cowboycodr wants to merge 2 commits into from
Closed

Set up Cursor Cloud development environment #10

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
555b4f7
docs: add Cursor Cloud setup instructions in AGENTS.md
cursoragent Jun 16, 2026
b475612
docs: note Ghostty as preferred terminal for manual TUI testing
cursoragent Jun 16, 2026
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
32 changes: 32 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# AGENTS.md

## Cursor Cloud specific instructions

Glass is a single Rust crate (edition 2024) — a terminal Markdown editor (TUI) built with
Ratatui. There are no services, databases, or network ports; it's a self-contained binary.

### Toolchain caveats (non-obvious)
- Edition 2024 requires a recent stable Rust (≥ 1.85). The pre-baked image may ship an older
default toolchain; the environment is set up to use `stable` (currently 1.96).
- The `tree-sitter-markdown` dependency compiles C++ via `cc-rs`. On this image the default
`cc`/`c++` alternatives point at `clang`, and `clang` is invoked with
`--target=x86_64-unknown-linux-gnu`, which fails to locate the GNU libstdc++ headers
(`fatal error: 'cassert' file not found`). The environment fixes this by switching the
`cc`/`c++` alternatives to GCC (`update-alternatives --set c++ /usr/bin/g++`,
`--set cc /usr/bin/gcc`). If you ever hit a `cassert`/C++ stdlib build error, re-apply that,
or build with `CC=gcc CXX=g++ cargo build`.

### Lint / test / build / run
Authoritative checks mirror `.github/workflows/ci.yml`:
- Format/lint: `cargo fmt --all -- --check`
- Tests: `cargo test --locked` (inline `#[cfg(test)]` modules; no `tests/` dir)
- Build (dev): `cargo build`; release: `cargo build --release --locked`
- Run interactively (needs a TTY): `cargo run -- <path>` or `./target/release/glass <path>`
- Headless/automated rendering (no TTY): `./target/release/glass --render [--width N] [--height N] <path>`
also auto-renders when stdout is piped/redirected. Use this for non-interactive verification.

### Manual GUI testing
- Use the **Ghostty** terminal emulator for interactive/manual testing of the TUI (preferred).
It's installed and registered as `x-terminal-emulator`; launch with `ghostty &`.
- Ghostty runs over OpenGL via the GTK runtime; it works in the VM's software renderer. The
GTK/cgroup/empty-config warnings it prints at startup are harmless and don't affect the editor.