From 43292e96190de05061bf400f8dd072b849d702bc Mon Sep 17 00:00:00 2001
From: A <258483684+la14-1@users.noreply.github.com>
Date: Tue, 10 Feb 2026 12:22:39 -0800
Subject: [PATCH] feat: Add Codex CLI support for Northflank (#211)

Agent: gap-filler-3

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 manifest.json       |  2 +-
 northflank/codex.sh | 46 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 northflank/codex.sh

diff --git a/manifest.json b/manifest.json
index 458fcd69..9e04a8ef 100644
--- a/manifest.json
+++ b/manifest.json
@@ -977,7 +977,7 @@
     "northflank/nanoclaw": "missing",
     "northflank/aider": "implemented",
     "northflank/goose": "missing",
-    "northflank/codex": "missing",
+    "northflank/codex": "implemented",
     "northflank/interpreter": "missing",
     "northflank/gemini": "missing",
     "northflank/amazonq": "missing",
diff --git a/northflank/codex.sh b/northflank/codex.sh
new file mode 100644
index 00000000..36118e7c
--- /dev/null
+++ b/northflank/codex.sh
@@ -0,0 +1,46 @@
+#!/bin/bash
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
+if [[ -n "${SCRIPT_DIR}" && -f "${SCRIPT_DIR}/lib/common.sh" ]]; then
+    source "${SCRIPT_DIR}/lib/common.sh"
+else
+    eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/northflank/lib/common.sh)"
+fi
+
+log_info "Codex CLI on Northflank"
+echo ""
+
+ensure_northflank_cli
+ensure_northflank_token
+
+NORTHFLANK_SERVICE_NAME=$(get_server_name)
+NORTHFLANK_PROJECT_NAME=$(get_project_name)
+
+create_server "${NORTHFLANK_SERVICE_NAME}"
+wait_for_cloud_init
+
+log_warn "Installing Codex CLI..."
+run_server "npm install -g @openai/codex"
+
+echo ""
+if [[ -n "${OPENROUTER_API_KEY:-}" ]]; then
+    log_info "Using OpenRouter API key from environment"
+else
+    OPENROUTER_API_KEY=$(get_openrouter_api_key_oauth 5180)
+fi
+
+log_warn "Setting up environment variables..."
+inject_env_vars_northflank \
+    "OPENROUTER_API_KEY=${OPENROUTER_API_KEY}" \
+    "OPENAI_API_KEY=${OPENROUTER_API_KEY}" \
+    "OPENAI_BASE_URL=https://openrouter.ai/api/v1"
+
+echo ""
+log_info "Northflank setup completed successfully!"
+echo ""
+
+log_warn "Starting Codex..."
+sleep 1
+clear
+interactive_session "source ~/.bashrc && codex"