Skip to content
Projects

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.

How these counts are measured

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 & Apps

README.md

Original

Trace — Local-First OSINT Investigation & Link Analysis

Trace Logo

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.


trace-4x

Screenshot 2026-11-07 at 19 38 31

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.md working 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.

License

MIT