## Feature stages

| Feature stage | Stable | Production-ready | Support | Description |

| [Early Access](#early-access-features) | No | No | GitHub issues | For staging only. Not feature-complete or stable. Disabled by default. |

| [Beta](#beta) | No | Not fully | Docs, Discord, GitHub | Publicly available. In active development with minor bugs. Suitable for staging; optional for production. Not covered by SLA. |

| [GA](#general-availability-ga) | Yes | Yes | License-based | Stable and tested. Enabled by default. Fully documented. Support based on license. |

<!-- BEGIN: available-experimental-features -->

| Feature Flag | Name | Available in |

| `dev-containers` | Dev Containers Integration | main, mainline, stable |

| `securing-agents` | Securing AI Agents | main, mainline, stable |

<!-- BEGIN: beta-features -->

| Feature Flag | Name | Available in |

| `agentic-chat` | AI Coding Agents | main, mainline, stable |

| `coder-desktop` | Coder Desktop | main, mainline, stable |

| `workspace-prebuilds` | Prebuilt workspaces | main, mainline, stable |

echo "stable"

return

fi

# Try to get latest stable version, fallback to "stable" if it fails

version=$(curl -fsSLI -o /dev/null -w "%{url_effective}" https://github.com/coder/coder/releases/latest 2>/dev/null || echo "error")

if [[ "${version}" == "error" || -z "${version}" ]]; then

log "Warning: Failed to fetch latest stable version. Using 'stable' as placeholder."

echo "stable"

return

fi

version="${version#https://github.com/coder/coder/releases/tag/v}"

echo "v${version}"

}

echo "mainline"

return

fi

# Try to get the latest mainline version, fallback to "mainline" if it fails

local version

awk -F'"' '/"tag_name"/ {print $4}' |

tr -d v |

tr . ' ' |

sort -k1,1nr -k2,2nr -k3,3nr |

head -n1 |

tr ' ' . || echo "")

if [[ -z "${version}" ]]; then

log "Warning: Failed to fetch latest mainline version. Using 'mainline' as placeholder."

echo "mainline"

return

fi

echo "v${version}"

}

echo ""

return

fi

# Always return success with a placeholder directory

echo "${1}/${2}"

}

extract_version_experiment_info() {

local dir=$1

local version=$2

if [[ "${GH_AVAILABLE}" == "false" || -z "${dir}" ]]; then

# If GitHub isn't available, just set all features to the same version

extract_local_experiment_info | jq --arg version "${version}" '[.[] | . + {"versions": [$version]}]'

return

fi

# For simplicity and stability, let's just use the local experiments

# and mark them as available in the specified version.

# This avoids the complex Go module replacement that can be error-prone

local workdir=$1

local stable_version=$2

local mainline_version=$3

# Extract information from different versions

local local_info stable_info mainline_info

local_info=$(extract_local_experiment_info)

if [[ "${GH_AVAILABLE}" == "true" ]]; then

# Create sparse clones and extract info

local stable_dir mainline_dir

stable_dir=$(sparse_clone_codersdk "${workdir}" "stable" "${stable_version}")

if [[ -n "${stable_dir}" ]]; then

stable_info=$(extract_version_experiment_info "${stable_dir}" "stable")

else

# Fallback if sparse clone failed

stable_info=$(extract_local_experiment_info | jq '[.[] | . + {"versions": ["stable"]}]')

fi

mainline_dir=$(sparse_clone_codersdk "${workdir}" "mainline" "${mainline_version}")

if [[ -n "${mainline_dir}" ]]; then

mainline_info=$(extract_version_experiment_info "${mainline_dir}" "mainline")

else

# Fallback if sparse clone failed

mainline_info=$(extract_local_experiment_info | jq '[.[] | . + {"versions": ["mainline"]}]')

fi

# Cleanup

rm -rf "${workdir}"

else

# If GitHub isn't available, just mark everything as available in all versions

stable_info=$(extract_local_experiment_info | jq '[.[] | . + {"versions": ["stable"]}]')

mainline_info=$(extract_local_experiment_info | jq '[.[] | . + {"versions": ["mainline"]}]')

fi

# Add 'main' version to local info

local_info=$(echo "${local_info}" | jq '[.[] | . + {"versions": ["main"]}]')

# Combine all info

echo '[]' | jq \

--argjson local "${local_info}" \

# Generate the early access features table

generate_experiments_table() {

local experiment_info=$1

echo "| Feature Flag | Name | Available in |"

echo "|-------------|------|--------------|"

echo "${experiment_info}" | jq -r '.[] | select(.stage=="early access") | "| `\(.value)` | \(.description) | \(.versions | join(", ")) |"'

}

# Generate the beta features table

generate_beta_table() {

local experiment_info=$1

echo "| Feature Flag | Name | Available in |"

echo "|-------------|------|--------------|"

echo "${experiment_info}" | jq -r '.[] | select(.stage=="beta") | "| `\(.value)` | \(.description) | \(.versions | join(", ")) |"'

}

rm -f "${dest}.bak"

# Format the file with prettier