๐พ Open Computer Use โ Open-Source Alternative to Codex Computer Use
Swift accessibilityai-agentai-agentsclaude-codecodexcodex-computer-usecomputer-usecomputer-use-agentcross-platformcuadesktop-automationgemini-cligui-automationmacosmcpmodel-context-protocolopen-computer-useopen-computer-use-mcpopenai-codexopencode
#!/usr/bin/env bash
set -euo pipefail
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
configuration="debug"
arch_mode="native"
codesign_mode="${OPEN_COMPUTER_USE_CODESIGN_MODE:-auto}"
codesign_identity="${OPEN_COMPUTER_USE_CODESIGN_IDENTITY:-}"
codesign_keychain="${OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN:-}"
usage() {
cat <<'EOF'
Usage: ./scripts/build-open-computer-use-app.sh [debug|release] [--configuration debug|release] [--arch native|arm64|x86_64|universal]
Examples:
./scripts/build-open-computer-use-app.sh debug
./scripts/build-open-computer-use-app.sh --configuration release --arch universal
Environment:
OPEN_COMPUTER_USE_APP_OUTPUT_DIR=/path/to/isolated/output
OPEN_COMPUTER_USE_CODESIGN_MODE=auto|identity|adhoc|none
OPEN_COMPUTER_USE_CODESIGN_IDENTITY="Developer ID Application: Example, Inc. (TEAMID)"
OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN=/path/to/signing.keychain-db
EOF
}
while [[ $# -gt 0 ]]; do
case "$1" in
debug|release)
configuration="$1"
shift
;;
--configuration)
configuration="${2:-}"
if [[ -z "${configuration}" ]]; then
echo "--configuration requires a value" >&2
exit 1
fi
shift 2
;;
--arch)
arch_mode="${2:-}"
if [[ -z "${arch_mode}" ]]; then
echo "--arch requires a value" >&2
exit 1
fi
shift 2
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown argument: $1" >&2
usage >&2
exit 1
;;
esac
done
if [[ "${configuration}" != "debug" && "${configuration}" != "release" ]]; then
echo "Unsupported configuration: ${configuration}" >&2
exit 1
fi
if [[ "${arch_mode}" != "native" && "${arch_mode}" != "arm64" && "${arch_mode}" != "x86_64" && "${arch_mode}" != "universal" ]]; then
echo "Unsupported arch mode: ${arch_mode}" >&2
exit 1
fi
if [[ "${codesign_mode}" != "auto" && "${codesign_mode}" != "identity" && "${codesign_mode}" != "adhoc" && "${codesign_mode}" != "none" ]]; then
echo "Unsupported OPEN_COMPUTER_USE_CODESIGN_MODE: ${codesign_mode}" >&2
exit 1
fi
read_package_version() {
python3 - "${repo_root}/plugins/open-computer-use/.codex-plugin/plugin.json" <<'PY'
import json
import sys
with open(sys.argv[1], "r", encoding="utf-8") as fh:
manifest = json.load(fh)
print(manifest["version"])
PY
}
build_binary() {
local triple="${1:-}"
local scratch_path="${2:-}"
local -a args=(-c "${configuration}")
if [[ -n "${triple}" ]]; then
args+=(--triple "${triple}")
fi
if [[ -n "${scratch_path}" ]]; then
args+=(--scratch-path "${scratch_path}")
fi
local binary_dir
binary_dir="$(swift build "${args[@]}" --show-bin-path)"
swift build "${args[@]}" --product OpenComputerUse >&2
printf '%s/OpenComputerUse\n' "${binary_dir}"
}
find_codesign_identity() {
local prefix="${1:-}"
local -a args=(find-identity -v -p codesigning)
if [[ -n "${codesign_keychain}" ]]; then
args+=("${codesign_keychain}")
fi
security "${args[@]}" 2>/dev/null \
| sed -n "s/.*\"\\(${prefix}: .*\\)\"/\1/p" \
| head -n 1
}
list_user_keychains() {
security list-keychains -d user \
| sed -n 's/^[[:space:]]*"\(.*\)"$/\1/p'
}
run_with_codesign_keychain() {
local keychain_path="${1:-}"
shift
if [[ -z "${keychain_path}" ]]; then
"$@"
return
fi
local -a existing_keychains=()
while IFS= read -r keychain; do
if [[ -n "${keychain}" ]]; then
existing_keychains+=("${keychain}")
fi
done < <(list_user_keychains)
local -a desired_keychains=("${keychain_path}")
local existing=""
for existing in "${existing_keychains[@]}"; do
if [[ "${existing}" != "${keychain_path}" ]]; then
desired_keychains+=("${existing}")
fi
done
security list-keychains -d user -s "${desired_keychains[@]}" >/dev/null
local status=0
"$@" || status=$?
if [[ ${#existing_keychains[@]} -gt 0 ]]; then
security list-keychains -d user -s "${existing_keychains[@]}" >/dev/null
else
security list-keychains -d user -s >/dev/null
fi
return "${status}"
}
resolve_codesign_identity() {
case "${codesign_mode}" in
none)
return 1
;;
adhoc)
printf '%s\n' "-"
return 0
;;
identity)
if [[ -z "${codesign_identity}" ]]; then
echo "OPEN_COMPUTER_USE_CODESIGN_IDENTITY is required when OPEN_COMPUTER_USE_CODESIGN_MODE=identity" >&2
exit 1
fi
printf '%s\n' "${codesign_identity}"
return 0
;;
auto)
if [[ -n "${codesign_identity}" ]]; then
printf '%s\n' "${codesign_identity}"
return 0
fi
local discovered_identity
discovered_identity="$(find_codesign_identity "Developer ID Application")"
if [[ -n "${discovered_identity}" ]]; then
printf '%s\n' "${discovered_identity}"
return 0
fi
discovered_identity="$(find_codesign_identity "Apple Development")"
if [[ -n "${discovered_identity}" ]]; then
printf '%s\n' "${discovered_identity}"
return 0
fi
printf '%s\n' "-"
return 0
;;
esac
}
codesign_app_bundle() {
local app_path="${1:-}"
local identity=""
if ! identity="$(resolve_codesign_identity)"; then
echo "Skipping codesign for ${app_path} (OPEN_COMPUTER_USE_CODESIGN_MODE=none)" >&2
return
fi
local -a args=(--force --sign "${identity}")
if [[ -n "${codesign_keychain}" && "${identity}" != "-" ]]; then
args+=(--keychain "${codesign_keychain}")
fi
if [[ "${identity}" != "-" ]]; then
args+=(--options runtime,library)
fi
if [[ -n "${OPEN_COMPUTER_USE_PROVISIONING_PROFILE:-}" ]]; then
if [[ "${identity}" == "-" ]]; then
echo 'Keychain provisioning requires an Apple signing identity.' >&2
exit 1
fi
profile_entitlements="${icon_work_dir}/keychain-entitlements.plist"
python3 "${repo_root}/scripts/prepare-macos-keychain-profile.py" "${OPEN_COMPUTER_USE_PROVISIONING_PROFILE}" "${bundle_identifier}" "${profile_entitlements}"
cp "${OPEN_COMPUTER_USE_PROVISIONING_PROFILE}" "${contents_dir}/embedded.provisionprofile"
args+=(--entitlements "${profile_entitlements}")
fi
run_with_codesign_keychain "${codesign_keychain}" \
codesign "${args[@]}" "${app_path}" >/dev/null
if [[ "${identity}" == "-" ]]; then
echo "Signed ${app_path} with ad-hoc identity; macOS TCC may still treat separately built copies as different app identities until a stable Apple signing identity is configured." >&2
else
echo "Signed ${app_path} with ${identity}" >&2
fi
}
cd "${repo_root}"
package_version="$(read_package_version)"
bundle_version="${OPEN_COMPUTER_USE_BUNDLE_VERSION:-$(git -C "${repo_root}" rev-list --count HEAD 2>/dev/null || echo 1)}"
release_app_bundle_name="Open Computer Use.app"
development_app_bundle_name="Open Computer Use (Dev).app"
legacy_app_bundle_name="OpenComputerUse.app"
bundle_icon_name="OpenComputerUse.icns"
icon_master_png="${repo_root}/assets/app-icons/open-computer-use-1024.png"
iconset_build_script="${repo_root}/scripts/build-apple-iconset.sh"
cursor_reference_source="${repo_root}/docs/references/codex-computer-use-reverse-engineering/assets/extracted-2026-04-19/official-software-cursor-window-252.png"
bundle_display_name="Open Computer Use"
bundle_identifier="com.ifuryst.opencomputeruse"
app_variant="release"
app_bundle_name="${release_app_bundle_name}"
if [[ "${configuration}" != "release" ]]; then
bundle_display_name="Open Computer Use (Dev)"
bundle_identifier="com.ifuryst.opencomputeruse.dev"
app_variant="dev"
app_bundle_name="${development_app_bundle_name}"
fi
app_output_dir="${OPEN_COMPUTER_USE_APP_OUTPUT_DIR:-${repo_root}/dist}"
app_root="${app_output_dir}/${app_bundle_name}"
release_app_root="${app_output_dir}/${release_app_bundle_name}"
development_app_root="${app_output_dir}/${development_app_bundle_name}"
legacy_app_root="${app_output_dir}/${legacy_app_bundle_name}"
contents_dir="${app_root}/Contents"
macos_dir="${contents_dir}/MacOS"
resources_dir="${contents_dir}/Resources"
rm -rf "${app_root}" "${legacy_app_root}"
if [[ "${app_variant}" == "release" ]]; then
rm -rf "${development_app_root}"
else
rm -rf "${release_app_root}"
fi
mkdir -p "${macos_dir}" "${resources_dir}"
case "${arch_mode}" in
native)
cp "$(build_binary "" "")" "${macos_dir}/OpenComputerUse"
;;
arm64)
cp "$(build_binary "arm64-apple-macosx14.0" ".build/arm64-${configuration}")" "${macos_dir}/OpenComputerUse"
;;
x86_64)
cp "$(build_binary "x86_64-apple-macosx14.0" ".build/x86_64-${configuration}")" "${macos_dir}/OpenComputerUse"
;;
universal)
arm_binary="$(build_binary "arm64-apple-macosx14.0" ".build/arm64-${configuration}")"
x86_binary="$(build_binary "x86_64-apple-macosx14.0" ".build/x86_64-${configuration}")"
lipo -create -output "${macos_dir}/OpenComputerUse" "${arm_binary}" "${x86_binary}"
;;
esac
chmod +x "${macos_dir}/OpenComputerUse"
if [[ ! -f "${icon_master_png}" ]]; then
echo "Missing icon master PNG: ${icon_master_png}" >&2
exit 1
fi
if [[ ! -f "${iconset_build_script}" ]]; then
echo "Missing iconset build script: ${iconset_build_script}" >&2
exit 1
fi
if [[ ! -f "${cursor_reference_source}" ]]; then
echo "Missing cursor reference PNG: ${cursor_reference_source}" >&2
exit 1
fi
icon_work_dir="$(mktemp -d "${TMPDIR:-/tmp}/open-computer-use-icon.XXXXXX")"
cleanup() {
if [[ -n "${icon_work_dir:-}" ]]; then
rm -rf "${icon_work_dir}"
fi
}
trap cleanup EXIT
iconset_dir="${icon_work_dir}/OpenComputerUse.iconset"
mkdir -p "${iconset_dir}"
"${iconset_build_script}" "${icon_master_png}" "${iconset_dir}"
iconutil -c icns "${iconset_dir}" -o "${resources_dir}/${bundle_icon_name}"
cp "${cursor_reference_source}" "${resources_dir}/official-software-cursor-window-252.png"
cp "${repo_root}/THIRD_PARTY_NOTICES.md" "${resources_dir}/THIRD_PARTY_NOTICES.md"
bundle_build_identifier="$(uuidgen)"
cat > "${contents_dir}/Info.plist" <<PLIST
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>OpenComputerUse</string>
<key>CFBundleIconFile</key>
<string>${bundle_icon_name}</string>
<key>CFBundleIdentifier</key>
<string>${bundle_identifier}</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>${bundle_display_name}</string>
<key>CFBundleDisplayName</key>
<string>${bundle_display_name}</string>
<key>OpenComputerUseBuildIdentifier</key>
<string>${bundle_build_identifier}</string>
<key>OpenComputerUseAppVariant</key>
<string>${app_variant}</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>${package_version}</string>
<key>CFBundleVersion</key>
<string>${bundle_version}</string>
<key>LSMinimumSystemVersion</key>
<string>14.0</string>
<key>LSUIElement</key>
<true/>
<key>NSHighResolutionCapable</key>
<true/>
<key>NSPrincipalClass</key>
<string>NSApplication</string>
</dict>
</plist>
PLIST
locked_use_requested="${OPEN_COMPUTER_USE_INCLUDE_LOCKED_USE:-auto}"
locked_use_identity="$(resolve_codesign_identity || true)"
if [[ "$locked_use_requested" == auto ]]; then
locked_use_requested=0
if [[ "$configuration" == release && -n "$locked_use_identity" && "$locked_use_identity" != - ]]; then
locked_use_requested=1
fi
fi
if [[ "$locked_use_requested" == 1 ]]; then
if [[ -z "$locked_use_identity" || "$locked_use_identity" == - ]]; then
echo 'Locked Use requires an Apple signing identity; refusing an incomplete release.' >&2
exit 1
fi
scripts/build-locked-use-components.sh --configuration "$configuration" --arch "$arch_mode" --identity "$locked_use_identity"
locked_use_components="${repo_root}/.build/locked-use/components"
guardian_component="OCU Guardian (Dev).app"
if [[ "${app_variant}" == release ]]; then
locked_use_components="${repo_root}/.build/locked-use/components-release"
guardian_component="OCU Guardian.app"
fi
if [[ "$arch_mode" != native ]]; then locked_use_components="$locked_use_components-$arch_mode"; fi
mkdir -p "${resources_dir}/LockedUse"
for component in OCULockService OCULockInstaller OCULockAuth.bundle; do
ditto "${locked_use_components}/${component}" "${resources_dir}/LockedUse/${component}"
done
ditto "${locked_use_components}/${guardian_component}" "${resources_dir}/LockedUse/OCU Guardian.app"
fi
plutil -lint "${contents_dir}/Info.plist" >/dev/null
codesign_app_bundle "${app_root}"
if [[ "$locked_use_requested" == 1 ]]; then
scripts/verify-locked-use-bundle.sh "$app_root"
fi
echo "Built ${app_root} (${arch_mode}, ${configuration})"