Skip to main content
plugin

stackhawk-api — Claude Code plugin: what it does, how to install

stackhawk-api queries the StackHawk platform through CLI for security reporting and findings analysis. Helps track application risks and monitor changes between vulnerability scans.

MIT ★ 16 updated 2026-10-09

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin install stackhawk-api@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official
Open on GitHub

What stackhawk-api does

The plugin teaches Claude Code to query the StackHawk platform using the hawk CLI. It collapses multi-step lookups into a single hawk op command with built-in pagination. Output comes back as structured JSON. The agent examines security findings and flags apps that lack recent scans.

You need a StackHawk account and the hawk CLI installed alongside jq. Interactive setups store credentials in ~/.hawk/hawk.properties through hawk init --browser. Headless agents and CI runs fail without HAWK_API_KEY set as an environment variable.

What it helps with

  • summarize vulnerability alerts across all organization apps
  • inspect findings from the latest scan of a selected service
  • detect applications that have not been scanned for 30 days
  • compare scans to reveal new, resolved, or modified findings

Example prompts for the agent

  • What is my security posture across all apps?
  • Show me the findings from the last scan of my payment-api.
  • Which apps haven't been scanned in the last 30 days?

How to install stackhawk-api

Plugin marketplace

/plugin install stackhawk-api@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-official

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about stackhawk-api

How to install stackhawk-api in Claude Code?

First add the marketplace with /plugin marketplace add anthropics/claude-plugins-official, then install the plugin using /plugin install stackhawk-api@claude-plugins-official.

What does stackhawk-api do?

It queries the StackHawk platform API to report security postures, analyze vulnerabilities across apps, and track changes between scan runs directly in your chat.

What are the prerequisites for using stackhawk-api?

You need a StackHawk account, an API key, and local installations of jq and the hawk CLI. Authenticate interactive sessions with hawk init --browser or export the HAWK_API_KEY environment variable for CI and headless setups.

Source text

api · MIT
# StackHawk API Skill for Claude

Security posture reporting and findings analysis powered by the [StackHawk platform API](https://apidocs.stackhawk.com), embedded directly into your Claude agentic workflow.

## What This Does

This plugin teaches Claude how to query the StackHawk platform for security reporting. It authenticates, retrieves findings data across your applications and environments, and presents actionable security posture summaries — helping you understand where your risks are, what changed between scans, and which apps need attention.

```
Question → Authenticate → Query API via hawk op → Present Results → Suggest Next Actions
```

The skill uses the combined `hawk` CLI (`hawk op …`) — most operations collapse from a three-call drill-down pipeline into a single `hawk op` command with built-in auth, pagination, and JSON output.

## Prerequisites

- A [StackHawk account](https://app.stackhawk.com) (free tier available)
- A StackHawk API key — generate one at **Settings → API Keys**
- The `hawk` CLI installed and initialized via `hawk init --browser` (stores credentials in `~/.hawk/hawk.properties`)
- For any non-interactive session (CI, containers, headless agents): `HAWK_API_KEY` set as an environment variable
- `jq` installed (used for JSON processing in recipes)

## Installation

```bash
# Add the StackHawk marketplace
/plugin marketplace add stackhawk/agent-skills

# Install the StackHawk API skill
/plugin install stackhawk-api@stackhawk
```

## Usage

Once installed, Claude will use the StackHawk API skill when you ask questions like:

> "What's my security posture across all apps?"

> "Show me the findings from the last scan of my payment-api"

> "Which apps haven't been scanned in the last 30 days?"

> "What changed since the last scan of my auth-service?"

## Supported Queries

- **Org-wide security posture summaries** — aggregate findings and severity counts across all applications
- **Per-app findings deep dives** — drill from application → scan → alerts → individual findings
- **Stale app detection** — identify applications that haven't been scanned recently
- **Scan comparison** — surface what changed (new, resolved, or modified findings) between scans
- **Team and environment management** — view apps by team, environment, or environment type

## Security Note

Never hardcode your API key. For interactive local use, `hawk init` stores credentials locally. For any non-interactive session (CI, containers, headless agents), set `HAWK_API_KEY` as a secret — never inline key values in scripts or configs.

StackHawk issues this key. The `hawk op` CLI uses it to authenticate with the StackHawk platform API. The plugin does not send the key to documentation or CLI download URLs.

## Resources

- [hawk CLI docs](https://docs.stackhawk.com)
- [StackHawk API Docs](https://apidocs.stackhawk.com)
- [StackHawk Platform](https://app.stackhawk.com)
- [StackHawk Support](https://support.stackhawk.com)

## License

MIT © [StackHawk](https://www.stackhawk.com)

© StackHawk · MIT · stackhawk/agent-skills

Similar plugins

All plugins for Security →

From the same set3

Project sponsors

Companies that keep this analytics open