id = "recon-ng"
name = "Recon-ng"
homepage = "https://github.com/lanmaster53/recon-ng"
description = "Web Reconnaissance Framework"
executables = ["recon-ng"]

[dotfiles]

# Recon-ng creates ~/.recon-ng/workspaces/<workspace>/config.dat for each
# workspace and stores API keys in ~/.recon-ng/keys.db.
# https://github.com/lanmaster53/recon-ng/wiki/Features
# https://github.com/lanmaster53/recon-ng/wiki/Getting-Started
paths = ["~/.recon-ng/workspaces/*/config.dat"]
secret = ["~/.recon-ng/keys.db"]

[commands]
format = 1
label = "Start Recon-ng"
description = "Launch the Recon-ng framework in a workspace, optionally replaying a resource file and disabling network checks. Modules are then driven from its own prompt."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "src"
kind = "help"
url = "https://github.com/lanmaster53/recon-ng/blob/master/recon-ng"
revision = "master 2026-10-27"
evidence = '''
-w workspace   load/create a workspace
-r filename    load commands from a resource file
--no-version   disable version check
--no-analytics   disable analytics reporting
--no-marketplace   disable remote module management
--stealth   disable all passive requests (--no-*)
--accessible   Use accessible outputs when available
'''

[[commands.field]]
id = "workspace"
label = "Workspace"
description = "Loaded or created if missing."
type = "string"
option = ["-w"]
sources = ["src"]

[[commands.field]]
id = "script_file"
label = "Resource file"
type = "path"
path = { kind = "file", role = "input" }
option = ["-r"]
sources = ["src"]

[[commands.field]]
id = "no_version"
label = "Skip version check"
type = "boolean"
option = ["--no-version"]
sources = ["src"]

[[commands.field]]
id = "no_analytics"
label = "Disable analytics"
type = "boolean"
option = ["--no-analytics"]
sources = ["src"]

[[commands.field]]
id = "no_marketplace"
label = "Disable marketplace"
type = "boolean"
option = ["--no-marketplace"]
sources = ["src"]

[[commands.field]]
id = "stealth"
label = "Stealth (no passive requests)"
type = "boolean"
option = ["--stealth"]
sources = ["src"]

[[commands.field]]
id = "accessible"
label = "Accessible output"
type = "boolean"
option = ["--accessible"]
sources = ["src"]

[[commands.task]]
id = "workspace"
label = "Open a workspace"
fields = ["workspace"]
required = ["workspace"]

[[commands.task]]
id = "offline"
label = "Start without network checks"
fields = ["workspace", "no_version", "no_analytics", "no_marketplace"]
required = []
set = { no_version = [true], no_analytics = [true], no_marketplace = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["workspace", "script_file"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["no_version", "no_analytics", "no_marketplace", "stealth", "accessible"]