explaingit

openai/codex-security

Analysis updated 2026-08-13

9,745TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A CLI and TypeScript SDK from OpenAI that scans code for security vulnerabilities using an AI model, then helps validate and fix them.

Mindmap

mindmap
  root((Codex Security))
    What it does
      AI powered vulnerability scanner
      CLI and TypeScript SDK
      Finds validates and fixes issues
    Scan modes
      Standard scan
      Deep scan
      Multiple AI providers
    Workflow
      Scan history
      Compare two scans
      Verbose diagnostics
    Deployment
      npm package
      Docker bulk scans
      CI integration

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan a codebase from the command line to find and validate security vulnerabilities.

USE CASE 2

Run repeated deep scans in CI or Docker to catch new vulnerabilities as code changes.

USE CASE 3

Compare two scans to see which security findings are new, fixed, or still open.

USE CASE 4

Use the TypeScript SDK to trigger security scans programmatically from another tool.

What is it built with?

TypeScriptNode.jsDockerPython

How does it compare?

openai/codex-securitywxt-dev/wxtjoyceql/magic-resume
Stars9,7459,8009,824
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires access approval to Codex Security plus an API key or ChatGPT sign-in.

In plain English

Codex Security is a command line tool and TypeScript library from OpenAI for scanning your codebase, finding security vulnerabilities, confirming they are real, and helping fix them. It is published as the npm package @openai/codex-security and needs Node.js 22 or newer, Python 3.10 or newer, and access granted to the Codex Security product before it will run. Once installed you sign in and run a scan command against a folder, and it uses an AI model to look through the code for problems. You can pick which AI model and how much effort it spends, and choose different scan modes, including a deep scan mode that keeps digging with multiple parallel workers until it stops finding anything new or hits a time limit you set, up to 96 hours. It is not locked to OpenAI's own models either. You can point it at other providers like OpenRouter, Fireworks, or Amazon Bedrock by setting the right API key and choosing a model from that provider. Beyond a single scan, it keeps a history of findings so you can list open issues in a repository over time, and it can compare two scans to show what is new, what has been fixed, and what is still open. There is a verbose diagnostics mode for debugging scans, though the README notes that this verbose output can contain sensitive data and should be reviewed before sharing. For teams that want to run scans automatically rather than by hand, there is a TypeScript SDK for scripting scans directly, plus an official Docker container and Docker Compose setup for running bulk, repeatable scans across many repositories pinned to specific code versions, with support for sharing extra security documentation and custom prompts across those scans.

Copy-paste prompts

Prompt 1
Help me install and run @openai/codex-security to scan my repository for vulnerabilities.
Prompt 2
Show me how to configure codex-security to use OpenRouter instead of OpenAI as the model provider.
Prompt 3
Explain how to set up a deep scan with codex-security using multiple workers and a time limit.
Prompt 4
Walk me through comparing two codex-security scans to see what vulnerabilities were fixed.

Frequently asked questions

What is codex-security?

A CLI and TypeScript SDK from OpenAI that scans code for security vulnerabilities using an AI model, then helps validate and fix them.

What language is codex-security written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

How hard is codex-security to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-security for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.