Release History¶
1.1.3 - 2026-03-18¶
Fixed¶
- Fixed an issue in
pcap enrichwhere multithreading was not being used in SOAR enrichment. The risk score enrichment is now faster for large captures.
1.1.0 - 2026-03-13¶
Added¶
- New
risklist createsub-command to build a custom risk list by merging one or more Recorded Future risk rules into a single deduplicated file. Supports CSV, JSON, and EDL output formats, optional minimum risk score filtering, and direct upload to Recorded Future Fusion. - New
ioc bulk-lookupsub-command for fast bulk enrichment of IOCs. Batches up to 1,000 indicators per API call and returns risk score and triggered risk rules for each indicator. Supports all IOC types: IP, domain, URL, hash, and vulnerability. pcap enrichJSON output now includes risk rule evidence details which details the specific evidence that caused the risk rule to trigger.
Changed¶
entity searchdefault limit increased to 100 results.list searchdefault limit increased to 1,000 results.pba searchdefault limit increased to 50 results.pba searchmaximum limit increased to 10,000 results.pcap enrichnow accepts risk scores as low as 1.
Fixed¶
- Fixed an issue in
ioc lookupwhere multithreading was not being used, causing bulk lookups to run sequentially. Lookups are now up to 20x faster when enriching multiple indicators. - Fixed an issue in
risklist fetchwhere the command would fail when parsing unusually large column values in CSV files. - Fixed an issue where
pcap enrichwould fail when parsing empty IOC links. - Fixed an issue in
listcommands where the error cause was not always printed correctly when an API error occurred.
1.0.0 - 2025-12-05¶
Added¶
- New
risklistcommand to download and check metadata for Recorded Future Risk Lists. - New
rulescommand to search for and download detection rules (YARA, Snort, Sigma). - CVSS v4 field support in
ioc searchandioc lookupcommands.
Fixed¶
list bulk-addandlist bulk-removenow deduplicate user-supplied entities.- Fixed an issue where entity names with spaces were not parsing correctly in
list bulk-addandlist bulk-remove. pba lookupnow correctly handles alerts when image retrieval fails.
Changed¶
pcap enrichJSON output now includes risk rule evidence details and all risk rules the IOC triggered.- Upgraded PSEngine to v2.4.0.
0.0.5 - 2025-11-12¶
Fixed¶
- Fixed an issue in
pcap enrichwhere the program would exit unexpectedly if no IPs or domains were found in the pcap file.
0.0.4 - 2025-11-07¶
Added¶
- Added support for filtering by alert status in the
ca searchcommand. - Added support for filtering by entity in the
pba searchcommand. - Added support for the
malware_reportcategory to allpbacommands. - Pretty output (
-p,--pretty) forioc lookupandioc searchnow includes the hash algorithm for hashes. - Pretty output (
-p,--pretty) forioc lookupandioc searchnow includes the lifecycle stage for vulnerabilities. - Added
-r/--risk-scoreoption topcap enrichto filter results by risk score. - Added
-t/--threat-huntoption topcap enrichto enable threat hunting.
Changed¶
- Optimized field selection for each verbosity level in
ioc lookup. - Extended
ioc searchto support verbosity levels 1 through 5 (default is 1). - Renamed the
pcap analyzesub-command topcap enrich. pcap enrichnow produces a refined JSON output, including a Wireshark-compatible filter query.- Upgraded PSEngine to v2.3.0.
Fixed¶
- Fixed an issue where
ca ruleswould truncate results at 10 alerting rules. - Fixed an error in
ioc lookupwhen an IOC had no evidence details.
Removed¶
- Removed interactive TUI output from
pba enrich; replaced with pretty output (--pretty,-p).
0.0.3 - 2025-09-02¶
Added¶
- New
ca updatesub-command to update one or more Classic Alerts. - New
pba updatesub-command to update one or more Playbook Alerts. pbacommands now supportgeopolitics_facilitycategory.- Python 3.13 compatibility.
tsharkversion check now enforces minimum version 4.4.5.
Fixed¶
pcap analyzeno longer crashes due to version mismatch.- Improved exception handling throughout the CLI.
Changed¶
ioc search ENTITY_TYPE IOCnow accepts whitespace separatated IOCs, instead of a comma-separated string.pba lookup ALERT_ID -poutput formatting improved.ca search --triggerednow supports time ranges.ca search -rnow accepts multiple rules by repeating-r(e.g.-r rule1 -r rule2), instead of a comma-separated string.- Upgraded PSEngine to v2.0.6.
0.0.2 - 2025-02-20¶
Added¶
- New
entitycommand to search and lookup entities - New
listcommand to manage Recorded Future Lists & Watch Lists - New
ioc rulessub-command to search and filter IOC rules - New
--debugoption for enhanced troubleshooting
Changed¶
- Sub-command
ioc lookupoption-vnow allows the user to pick a level of verbosity (from 1 to 5) - Sub-command
ioc lookupnow requires an entity type as an argument, for examplebanshee ioc lookup ip 8.8.8.8 - Sub-command
ca lookupnow returns a refined pretty alert - PSEngine upgraded to v2.0.2
0.0.1 - 2024-09-01¶
Added¶
- Beta release
🚀 Brought to you by the Cyber Security Engineers at Recorded