dlxarl/Trace
dlxarl/Trace has 113 GitHub stars and 13 forks. GitHot measured +3 stars in 24 hours and +79 in 7 days. Last checked 2026-11-17 18:59 UTC. Last push 2026-11-14.
Measured star growth
- in 24h
- +3
- in 7 days
- +79
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Local-First OSINT & Intelligence Investigation Platform
Web & AppsREADME.md
OriginalTrace — Local-First OSINT Investigation & Link Analysis
Trace is a desktop workbench for OSINT analysts, researchers and investigators. Map entities and relationships on a force-directed graph, attach evidence, and keep everything as plain Markdown files on your own machine.
Features
Graph
- Force-directed layout (ForceAtlas2-style with Barnes–Hut): strongly connected entities form clusters around hubs, loose components stay near the main network, nodes never overlap. Handles thousands of nodes. Hierarchical, radial and grid layouts are also available.
- Stable layouts: adding entities only places the new nodes next to their neighbours; existing positions are kept. Node positions can be saved per case.
- Readable at any scale: small muted nodes coloured by entity type, thin low-contrast edges, labels revealed by importance as you zoom in, and a dimmed background when something is selected.
- Verification is visible: confirmed and supported links are solid; unverified, candidate and rejected links are dashed or dotted and fainter.
- Working tools: multi-select, shortest path between two nodes, collapse leaf entities into collections, size nodes by connections, filter by entity type and verification status, find-in-graph.
- Connect mode: hold C (or ⌥) and drag from one node to another to create a relationship.
- Notes on the graph:
[[Entity name]]mentions in notes appear as dotted links. - Entity palette: drag an entity type onto the canvas to create it in place.
Transforms
Run lookups against an entity from the inspector or its context menu and get new entities and relationships back. Built-in machines cover domain footprinting, IP threat and infrastructure, and identity deep-dive. Output goes to the console under the graph.
Relationship discovery
Discover scans a case for non-obvious links: shared surnames, phones and emails, corporate email domains, IPs and hosts, employers and locations, tax IDs, passports, Telegram handles, vehicle plates, and names mentioned in other entities' attributes. Suggestions are added as unverified candidates for you to review and confirm, one by one or in bulk.
Evidence and sources
- Sources (webpages, documents, registries, leaks, interviews…) are cited by relationships as evidence.
- Tools tab: bookmark OSINT sites and JSON APIs, with a preset pack (VirusTotal, Shodan, Censys, WHOIS, Wayback and others).
- API console: send GET/POST/PUT/PATCH/DELETE requests with custom headers and body. In the desktop app requests run in the main process, so CORS does not apply. Attach a response to an entity as a source, a note, or an attribute.
Workspace
- Explorer: entities grouped by type and sortable by connections, plus links, sources, notes and tools, all filterable.
- Inspector: properties, relationships, evidence, notes and transforms for the selected entity or relationship; case composition when nothing is selected.
- Case brief: the
project.mdworking document with case statistics and the most connected entities. - Full-text search: local SQLite FTS5 (WebAssembly) over names, aliases, attributes, tags, relationships and Markdown bodies.
- Tabs and panels: preview and pinned tabs, resizable panels, command palette, status bar.
Local-first
No accounts, no cloud sync, no telemetry. Each case is a folder of Markdown files that diff well and work with git:
~/Documents/trace/projects/<project-id>/
├── project.md # scope, status, briefing
├── entities/*.md # one file per entity (YAML frontmatter + notes)
├── relationships/*.md # direction, status, confidence, evidence
├── sources/*.md # evidence and provenance
├── notes/*.md # analyst notes (GitHub Flavored Markdown)
└── graph-layout.json # saved node positions
The folder can be changed in Settings. Cases can be exported to and imported from a .zip. The web build stores data in the browser instead.
Download
Get the latest build from the v0.1.0-alpha.2 release: macOS (Apple Silicon and Intel), Windows x64 and Linux x64.
Builds are not code-signed (macOS uses an ad-hoc signature), so your OS will warn on first launch. On macOS, right-click the app and choose Open.
Development
Requirements: Node.js 18+ (20+ recommended) and npm.
git clone https://github.com/dlxarl/Trace.git
cd Trace
npm install
| Command | What it does |
|---|---|
npm run dev |
Run in the browser |
npm run dev:electron |
Run as an Electron app |
npm test |
Run the tests (Vitest) |
npm run lint |
Lint with oxlint |
npm run build |
Type-check and build the web bundle |
Packaging
Output goes to release/.
| Command | Produces |
|---|---|
npm run package:mac |
.dmg and .zip for arm64 and x64 |
npm run package:win |
NSIS installer and .zip (x64) |
npm run package:linux |
.AppImage and .tar.gz (x64) |
npm run package:all |
All of the above |
npm run package:dir |
Unpacked macOS .app for quick testing |
Each Electron build gets a fresh SHA-256 build identifier, shown in Settings and on the loading screen. The web build has none.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
| Cmd/Ctrl + K | Command palette |
| Cmd/Ctrl + G | Graph |
| Cmd/Ctrl + O | Case brief |
| Cmd/Ctrl + F | Full-text search |
| Cmd/Ctrl + [ / ] | Toggle explorer / inspector |
| Cmd/Ctrl + , | Settings |
| / | Focus find-in-graph |
| F / L / N | Fit view / re-run layout / new entity (graph focused) |
| C | Connect mode |
| ? | Shortcut sheet |
| Esc | Close dialog, menu or clear search |
Project structure
electron/ Main and preload processes (filesystem, HTTP, window)
src/
├── components/
│ ├── common/ Dialog, status badge, entity icons, Markdown editor
│ ├── layout/ Tab bar, explorer, inspector, status bar
│ └── modals/ Settings, shortcuts, command palette, entity/relationship dialogs
├── features/
│ ├── graph/ Graph view, force layout, theme, palette, transform console
│ ├── entities/ relationships/ sources/ notes/ Editors
│ ├── projects/ Case brief
│ └── search/ Full-text search
├── services/
│ ├── storage/ Electron (disk) and browser adapters
│ ├── transforms/ Transform registry and HTTP client
│ ├── discovery/ Relationship discovery heuristics
│ ├── markdownParser.ts Frontmatter parser and serializer
│ └── sqliteIndex.ts SQLite FTS5 indexer
├── tests/ Vitest suites
└── types/ Domain types and schemas
build/ App icons and packaging hooks
Security and privacy
- Data stays on your filesystem as readable Markdown.
- No telemetry, analytics or cloud services. The app only makes network requests you trigger (transforms and the API console).
- Works fully offline for everything else.