Skip to content

AGENTS.md

Latest commit

 

History

History
61 lines (34 loc) · 2.34 KB

AGENTS.md

File metadata and controls

61 lines (34 loc) · 2.34 KB

AGENTS Setup Guide

This repository requires specific environment configuration to build and run .NET 9.0 projects. All dependencies must be installed during the setup script phase, especially in restricted environments (e.g., OpenAI Codex).

Setup Steps (setup.sh)

  1. Update and upgrade the system:

    apt-get update && apt-get upgrade -y

  2. Install essential dependencies (wget, apt-transport-https, ca-certificates):

    apt-get install -y wget apt-transport-https ca-certificates

  3. Configure Microsoft package source and update package lists:

    wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

    dpkg -i packages-microsoft-prod.deb

    rm packages-microsoft-prod.deb

    apt-get update

  4. Install .NET SDK 9.0:

    apt-get install -y dotnet-sdk-9.0

  5. Verify installation:

    dotnet --version

  6. (Optional) Remove obsolete packages:

    apt-get autoremove -y

⚠️ Notes for Codex and Similar Cloud Environments

  • Internet access is only available during the setup script phase. All dependencies must be installed in this initial script.
  • A network proxy is always active: Standard environment variables like http_proxy, https_proxy, and the proxy certificate ($CODEX_PROXY_CERT) are automatically set. These should be respected by all package managers and CLI tools.
  • If you encounter connectivity issues:
    • Ensure your setup script is running during the setup/initialization phase (not in the regular terminal).
    • Check that all required dependencies are installed up front.
    • Make sure environment variables for the proxy/certificate are being used by your tools.

General Recommendations

  • Use the latest version of Visual Studio or Visual Studio Code for development.
  • Always install the correct SDK and runtime versions as required by this project.
  • The project can be built and run in Visual Studio Code on Windows, Linux, or macOS.

IMPORTANT:

If using a cloud development platform or automated environment, ensure all tools and dependencies are installed during the setup script phase. No additional internet access will be available after environment initialization. Plan accordingly.