Getting Started

Getting Started

Installation

From source (requires Go 1.23+)

go install github.com/HoraDomu/Atheon@latest

Pre-built binaries

Download from the Releases page for Linux, macOS, and Windows.

Your first scan

# Scan the current directory
atheon .

# Scan a specific directory
atheon /path/to/repo

# Scan a single file
atheon scan secrets.env

CLI reference

Command	Description
atheon .	Scan current directory
atheon scan <file>	Scan a single file
atheon env	Scan environment variables
atheon list categories	List available pattern categories
atheon list patterns	List all patterns
atheon list patterns --enabled	List only enabled patterns
atheon list patterns --disabled	List only disabled patterns

Output formats

# Default (human-readable)
atheon .

# JSON (pipe-friendly)
atheon . --format json

# Redact matched values
atheon . --redact

Ignoring paths

Create a .atheonignore file in your repo root — same syntax as .gitignore:

# ignore test fixtures
testdata/
*.golden

# ignore a specific file
internal/testkeys.go

Atheon also respects .gitignore automatically.

Pre-commit hook

To block commits containing findings:

# .git/hooks/pre-commit
#!/bin/sh
atheon . && exit 0