Add AGENTS.md with Cursor Cloud dev environment instructions - #1921
Merged
Conversation
Co-authored-by: rmcrackan <rmcrackan@gmail.com>
github-actions
Bot
added
the
exempt
…t network The first slow AudibleUtilities.Tests run was blocked on a desktop keyring password prompt for Libation's OS secret-store master key. Document that gotcha and remove the incorrect network-timeout theory. Co-authored-by: rmcrackan <rmcrackan@gmail.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sets up and documents the development environment for Libation so Cloud Agents can build, test, and run the app. Adds an
AGENTS.mdwith a## Cursor Cloud specific instructionssection capturing durable, non-obvious setup/run notes.No application code is modified — this only adds documentation. Dependency installation (
.NET 10 SDK) is handled by the VM snapshot + startup update script (dotnet tool restore+dotnet restore Source/Libation.slnx).Verification
dotnet build Source/LibationAvalonia/LibationAvalonia.csprojdotnet build Source/LibationCli/LibationCli.csprojdotnet test --project Source/_Tests/<each>Notes captured in AGENTS.md
LibationAvalonia,LibationCli); WinForms/OS-specific projects won't build.dotnet test --project <csproj>for single projects.AudibleUtilities.Tests(and first token-encrypting GUI/CLI use) can block for minutes on a desktop password prompt — looks like a hung suite. A human must set the keyring password once via the Desktop pane; afterward runs are fast. (Initially misdiagnosed as a network timeout; corrected after the keyring was set up mid-session.)DISPLAY=:1; GUI and CLI share config/DB at~/.local/share/Libation/.