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`)

Update and upgrade the system:

apt-get update && apt-get upgrade -y
Install essential dependencies (wget, apt-transport-https, ca-certificates):

apt-get install -y wget apt-transport-https ca-certificates
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
Install .NET SDK 9.0:

apt-get install -y dotnet-sdk-9.0
Verify installation:

dotnet --version
(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.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!