Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

1.3 KB
Raw Blame
---
title: "beacon rules list"
description: "List active Beacon threat-detection rules"
---

## Command overview

`beacon rules list` prints the active threat-detection rules used by [`beacon scan`](/cli/scan).

```bash title="Command syntax"
beacon rules list [flags]
```

The output includes each rule id, severity, maturity status, and source. The source shows whether Beacon loaded the rule from the local store or the built-in baseline, and the closing line counts the rules from each.

The built-in baseline stays active alongside the store. A store rule replaces a baseline rule only when it has the same id, so installing your own rules adds to the baseline rather than switching it off.

## Examples

List active user-mode rules:

```bash title="List active rules"
beacon rules list
```

List active system-mode rules:

```bash title="List system-mode rules"
sudo beacon rules list --system
```

## Flags

| Flag | Description |
|------|-------------|
| `--user` | Use per-user endpoint paths. Enabled by default |
| `--system` | Use system endpoint paths |

## Related

<Columns cols={2}>
  <Card title="beacon rules add" icon="plus" href="/cli/rules-add">
    Install local rule files into the store.
  </Card>
  <Card title="beacon scan" icon="magnifying-glass" href="/cli/scan">
    Run active rules over local telemetry.
  </Card>
</Columns>