atomic-red-team README

The project's README from github.com/redcanaryco/atomic-red-team. As one markdown file: README.md.

Atomic Red Team

GitHub Action Status Atomics GitHub Action Status

Atomic Red Team™ is a library of tests mapped to the MITRE ATT&CK® framework. Security teams can use Atomic Red Team to quickly, portably, and reproducibly test their environments.

Get started

You can execute atomic tests directly from the command line, no installation required. See the Getting started page of our wiki.

For a more robust testing experience, consider using an execution framework like Invoke-Atomic.

Learn more

The Atomic Red Team documentation is available as a wiki.

For information about the philosophy and development of Atomic Red Team, visit our website at https://atomicredteam.io.

To stay up to date on all things Atomic Red Team, sign up for the Atomic Newsletter: https://redcanary.com/atomic-newsletter/

Contribute to Atomic Red Team

Atomic Red Team is open source and community developed. If you're interested in becoming a contributor, check out these resources:

Open in GitHub Codespaces

atomic-red-team (redcanaryco/atomic-red-team)

Searching Database…

What is this?Atomic Red Team is a library of small, portable security tests, each mapped to a specific MITRE ATT&CK technique, that security teams run to check whether their defenses actually detect real attacker behavior.
Is this an exploit toolkit or test definitions for defenders?It is not a hacking toolkit - it's a curated set of 'atomic' test procedures that blue/red teams run on purpose to simulate specific ATT&CK techniques and validate monitoring and detection coverage.
How do I run an atomic test?You can execute an atomic test straight from the command line with no setup at all - the wiki's Getting started page walks through the exact syntax for a given technique.
Do I need Invoke-Atomic to run the tests?No, it's optional. Invoke-Atomic is a separate execution framework recommended only if you want a more robust testing experience (batch runs, dependency checks, cleanup, etc.).
Who is this meant for?Security teams (red teams and blue/detection teams) who need to repeatedly and reliably simulate known ATT&CK techniques to validate their monitoring and alerting.
Which operating systems do the tests target?The project explicitly calls out Linux-specific atomics (with a Codespaces-based contribution path), alongside the broader cross-platform test library.
How are the tests organized?Each atomic test is tied to a specific MITRE ATT&CK technique ID, so you can look up a technique and find a matching, ready-to-run test procedure for it.
Is there a quick way to try it without setting anything up locally?Yes, the repo supports contributing to and running Linux atomics directly from GitHub Codespaces, no local environment needed.
Size
603.3 MB
Stars
12.7K
Updated
CommitSep 05
Age
9y
Commits · 90 Days