Tools: running OSINT tools from TRACE#
Tools in the left rail opens a small marketplace of external OSINT tools that TRACE installs and runs locally. TRACE stays the workspace: tools collect, and their findings go through the import review before entering a case.
Desktop app only.
Python#
Tools need Python 3.9+. TRACE checks for it automatically and uses, in order:
- TRACE's own portable Python if it was installed before;
- the system Python (
python3/python, orpy -3on Windows).
If neither exists, installing a tool (or Install Python in the Tools header) downloads a portable Python 3.12.15 from python-build-standalone (release 20261021, about 25 MB). The archive's SHA-256 is pinned in electron/python.ts and checked before extraction — a mismatching download is rejected and deleted. It is extracted to <app data>/python/3.12.15/, needs no admin rights and changes nothing system-wide.
Catalog#
| Tool | Input | What it finds | Package |
|---|---|---|---|
| Sherlock | username | Accounts with that username on 400+ sites | sherlock-project |
| Maigret | username | Accounts on the top 500 sites, with profile details (name, location, IDs…) where exposed | maigret |
| Holehe | Services where the email is registered (password-recovery probes disabled, so the target is not notified) | holehe | |
| Ignorant | phone (+1 2025550123) | Services where the phone number is registered | ignorant |
| DNSRecon | domain | A / AAAA / NS / MX / CNAME records → host and IP entities; TXT and SOA kept as references | dnsrecon |
| dnstwist | domain | Registered look-alike / typosquatting domains (max 300 listed) | dnstwist |
Tools are grouped by input type (Username, Email, Phone, Domain) and the marketplace list has a search box. Domain inputs accept a URL and keep the hostname.
Not included, and why: theHarvester is not installable from PyPI (the theHarvester package there is a placeholder), Sublist3r and socialscan proved unreliable in testing (blocked or erroring sources), and h8mail needs paid API keys to be useful.
Install and remove#
Install creates <app data>/tools/<tool>/ (a Python virtual environment) and runs pip install <package> into it. Nothing is installed system-wide. Uninstall deletes that folder.
App data folder: ~/Library/Application Support/trace (macOS), %APPDATA%\trace (Windows), ~/.config/trace (Linux).
Run#
- Choose a case entity (an account/person for username tools, an email for Holehe). Its name fills the input; you can also type a value.
- Run. The output streams live; Stop kills the tool and its child processes. Each run has a hard time limit (5–15 minutes depending on the tool).
- Review & add to case opens the import review:
- the target is matched to the existing entity (never modified),
- username / email / phone tools: each hit becomes an
accountentity (<value> (<site>)) withplatform,urland any extracted profile fields as attributes; DNSRecon createsdomainandipentities; dnstwist creates candidatedomainentities, - links (
has_account,registered_on,resolves_to,uses_nameserver,mail_handled_by,has_subdomain,alias_of,lookalike_domain) start as Candidate, - everything is tagged
importedand with the tool name, keeps the raw output line as provenance, and cites an import source recording the run.
Security#
- The renderer can only send a catalog tool id and an input value. The command line is built in the main process from the catalog.
- Inputs are validated (usernames
[A-Za-z0-9._-], max 64; emails; domains; phone numbers as+code number), and can never start with-, so they cannot become command-line flags. - Processes are spawned without a shell, in a temporary working directory that is deleted afterwards, in their own process group so Stop/timeout also ends helper processes.
- Tools make network requests to third-party sites directly from your computer. Use them only where you are allowed to.
Adding a tool#
- Add a
ToolSpectosrc/services/tools/catalog.ts(PyPI package, console script, input kind and category) and its argv tobuildToolArgs. Check first that the package installs from PyPI and works unattended. - Teach
src/services/tools/parsers.tsto turn its stdout into anImportBatch. - Add a parser test with real captured output to
src/tests/tools.test.ts.
TRACE_REAL_TOOLS=1 npx vitest run src/tests/tools.real.test.ts performs a real install + run of Sherlock (network required).