---
title: "Codex"
description: "Install StackHawk agent skills in Codex for security scanning and vulnerability fixing."
url: https://docs.stackhawk.com/ai-security/agent-skills/codex/
---

# Codex

## Install

```
codex plugin marketplace add stackhawk/agent-skills-marketplace
codex plugin add wingman@stackhawk
```

`wingman` is the StackHawk umbrella plugin — one install pulls the full skill set (hawkscan, stackhawk-api, data-seed, optimize).

## Install the hawk CLI

The `hawk` CLI is a single self-contained binary — `hawkop` is now bundled in as `hawk op`, and no separate Java install is required.

**Tab: macOS**

```bash
brew tap stackhawk/cli && brew trust stackhawk/cli && brew install hawk
```

Or use the [pkg installer](https://docs.stackhawk.com/stackhawk-cli/#install-with-pkg-macos) or the [install script](https://docs.stackhawk.com/stackhawk-cli/#install-with-a-script).

**Tab: Linux**

Install `hawk` with the hawk CLI [install script](https://docs.stackhawk.com/stackhawk-cli/#install-with-a-script), then open a new terminal so it picks up your PATH:

```bash
curl -fsSL https://download.stackhawk.com/hawk/install.sh | sh
```

**Tab: Windows**

Download and run the `hawk.exe` MSI installer from the [downloads page](https://docs.stackhawk.com/downloads/hawkscan/) — self-contained, no Java required. Or, without administrator access, use the hawk CLI [install script](https://docs.stackhawk.com/stackhawk-cli/#install-with-a-script), then open a new terminal:

```powershell
irm https://download.stackhawk.com/hawk/install.ps1 | iex
```

CMD users: run the cmd.exe version of the install script instead, then open a new terminal:

```bat
curl -fsSL -o "%TEMP%\hawk-install.bat" https://download.stackhawk.com/hawk/install.bat && call "%TEMP%\hawk-install.bat"
```

Then authenticate:

```bash
hawk init --browser
```

`hawk init --browser` opens your browser to approve access, then provisions and saves your API key automatically — no copy/paste. (On Windows, run `hawk.exe init --browser`.) Prefer to manage keys yourself? Create one at [app.stackhawk.com](https://app.stackhawk.com) → **Settings → API Keys**.

## Verify

After installation, ask Codex: “What StackHawk skills do you have?”

## Usage

Ask Codex to scan your application:

```
Scan my app running on localhost:8080 for security vulnerabilities. Explain each step you take and each decision you make along the way.
```

Codex will configure HawkScan, run the scan, parse findings, and help you fix them.

## Tips

- The agent checks if your app is running and will prompt you to start it if needed
- For authenticated endpoints, describe your auth pattern and Codex will configure the scan
- Use `hawk validate config stackhawk.yml` to debug config issues
