loading
Loading content
loading
Utilities
Get a file from your Trickest file storage.
overview
Get Trickest Files reads files out of your Trickest file storage and drops them into a running workflow as real outputs. You name the files you want, and the node downloads each one so later stages can read it like any other input. It is the read side of the file-storage pair that lets you stash artifacts in one workflow and pull them into another.
Lookups happen by file name. Exact names retrieve exactly those files, and partial-name matching widens the search so a single name like subdomains.txt collects every stored file whose name contains it, such as trickest.com-subdomains.txt and trickest.io-subdomains.txt. Authentication uses your Trickest token, passed inline or read from a token file.
On Trickest this is a Utilities node that writes a folder and a file. Because storage is shared across runs, it is the seam for carrying state between workflows: persist a wordlist, a scope list, or a prior run's results once, then fetch them on demand wherever they are needed.
use cases
Store a list of live hosts or resolved subdomains from one run, then fetch it by name in a later workflow so the second run builds on the first without recomputing the surface.
Keep a curated wordlist or in-scope target list in file storage and retrieve it at the start of a workflow, so every run reads the same maintained source instead of an inline copy.
Enable partial-name matching to grab every stored file that ends in a common suffix, gathering per-target outputs like trickest.com-subdomains.txt across many hosts into one folder in a single node.
Set a dependency so the fetch only runs after the producing node has written its output to storage, keeping a download from racing ahead of the upload it relies on.
reference
| Name | Type | Flag | Description |
|---|---|---|---|
| file-names | STRING | --file-names | Names of the files to get, separated by commas. |
| token | STRING | --token | Trickest authentication token. |
| token-file | FILE | --token-file | File holding your Trickest authentication token, used in place of an inline token. |
| partial-name-match | BOOLEAN | --partial-name-match | Get all files whose name contains the given value, so subdomains.txt matches trickest.com-subdomains.txt. |
| dependency | FILE | --dependency | Force a node to run before this one, for example to wait for an upload to finish before downloading. |
| fail-on-error | BOOLEAN | --fail-on-error | Fail on errors such as an invalid token. Without it, an error writes an empty output file instead. |
Showing key inputs. Get Trickest Files exposes 6 inputs in total.
example
# fetch every stored file whose name contains subdomains.txttrickest-files --file-names subdomains.txt --partial-name-match --fail-on-error --token-file /root/.trickest/token[trickest-files] reading token from /root/.trickest/token[trickest-files] querying file storage for: subdomains.txt[trickest-files] partial-name-match enabled[trickest-files] matched 3 file(s) example.com-subdomains.txt 128 lines example.net-subdomains.txt 94 lines example.org-subdomains.txt 61 lines[trickest-files] wrote 3 file(s) to output/guidance
Reach for Get Trickest Files when a workflow needs a file that already lives in Trickest storage, whether a prior run wrote it or you maintain it by hand. To upload files into storage use Put Trickest Files, and to compare a fresh input against a stored copy use Diff Trickest Files.
The write side of the pair. Uploads files into storage so a later run can fetch them here.
Compares an input file against a stored file instead of just retrieving it, for change detection.
Downloads the output of a whole workflow run rather than named files from file storage.
faq
related
Import, export, and link workflow data with Airtable.
Decode Android APK files into smali sources and resources.
Check a file's values against conditions and exit with a matching code.
Extract all hosted zones from AWS Route53.
Output file lines by batch size, given START_LINE and END_LINE.
Extract a batch range from a file's lines or a folder's files, with parallel processing.
A file name feeds Get Trickest Files, which pulls a stored host list from file storage and passes it to httpx for live probing before the results land as an output.
Facts on this page come from the live Trickest tool library.