Skip to content

What changed

Release notes straight from GitHub Releases, pre-releases included.

Atom feed

0.3.0-alpha.1

pre-release

This release turns Trace from a graph editor into a full investigation workbench: preserve and rate your evidence, find and merge duplicates, see time, and protect your work with history, backups, encryption and Tor. The interface also got a lot easier to navigate.

Highlights

  • Preserve evidence: capture a page as screenshot, PDF and MHTML with SHA-256 hashes, rate sources (Admiralty), and export a report as Markdown, HTML or PDF.
  • Never lose work: autosave, version history with diff and restore, rotating backups, and per-case encryption.
  • Stay private: route tools, page capture and API requests through Tor or any proxy; keep API keys in the system keychain.
  • Find things fast: a real command palette (⌘K), a Records table with bulk actions, filtered and saved searches.

New

Evidence and reporting
  • Capture page (desktop): full-page screenshot, PDF and MHTML saved in the case's evidence/ folder, each with a SHA-256. Verify re-hashes them later. Wayback Machine lookup and save from the same place.
  • Source ratings: optional Admiralty code (reliability A–F, credibility 1–6), shown wherever a source is cited.
  • Report: Markdown, HTML or PDF with findings, statuses, numbered sources, ratings and evidence hashes.
  • Export graph: GraphML (Gephi, yEd, Cytoscape) and STIX 2.1 (MISP, OpenCTI).
  • Importing a case .zip in the desktop app now restores its evidence files, not only the hashes.
Analysis
  • Merge duplicates: combine entities with a full preview; relationships, evidence, aliases and [[links]] follow; conflicting values are kept; recorded in merged_from.
  • Time periods and Timeline: relationships can have From/Until dates; a new Timeline view draws them as bars next to source dates.
  • Graph "as of" date: show the graph as it was on a given day.
  • Records: every entity as a sortable table or cards. Filter by name, tag, type and link state; see links, links without a source and best source rating. Bulk add/remove tags, merge or delete.
  • Search filters and saved searches per case.
Collecting
  • Find entities in text: paste an article or chat and get emails, links, domains, IPs, phone numbers, @handles and crypto wallets into the normal import review.
  • Scratchpad: quick notes saved inside the case, with "Find entities".
  • Case templates: person, domain, company and username investigations with a subject and a working checklist.
Protecting your work
  • Autosave (on by default) with a live Saving… / Saved indicator.
  • Version history (desktop): automatic versions after you stop editing, before merges, bulk deletes and restores; line-by-line diff; go back to any version (the current state is saved first).
  • Backups (desktop): rotating automatic .zip backups, manual backups, restore as a copy or replace the case.
  • Lock and encrypt a case (desktop): passphrase protection (scrypt + AES-256-GCM). The encrypted file is verified before the plain folder is removed. There is no recovery for a lost passphrase.
  • Network (desktop): Tor or SOCKS/HTTP proxy for tools, page capture and API requests, with a connection test and a log of outgoing requests. DNS-only tools (DNSRecon, dnstwist) are blocked while a proxy is on unless you allow them.
  • API keys (desktop): stored in the system keychain and used as {{key:NAME}} in API requests.
Interface
  • Command palette (⌘K) lists every action with shortcuts, recent commands and the case's entities, sources and notes.
  • Left rail with optional labels, groups and tooltips; Case brief keeps main actions on the toolbar and the rest under More.
  • Settings now has sections (General, Files & storage, Network & keys, About).
  • A short welcome tour on first launch, and ways to add data in the empty inspector.

Notes and limits

  • History, backups, encryption, page capture, proxy and keys are desktop only; the browser build keeps cases in browser storage.
  • While a case is unlocked it is an ordinary folder; encryption protects it at rest. See docs/SAFETY.md.
  • Tor routing was tested against an unreachable proxy (it fails closed) but not against a live Tor service.
  • On macOS the first save of an API key may show a Keychain prompt (the app is not signed with a developer certificate): choose Allow.
  • Builds are unsigned (macOS ad-hoc); your OS will warn on first launch.
  • Windows and Linux builds were produced on macOS and not run on those systems yet.

View on GitHub

0.2.0-alpha.1

pre-release

Highlights

  • Tools marketplace: install and run Sherlock, Maigret, Holehe, Ignorant, DNSRecon and dnstwist from inside TRACE.
  • Read-only MCP server: let AI agents explore your investigations as a graph. Bundled, off by default.
  • Import: tool output (SpiderFoot, CSV, indicator lists, TRACE JSON) and whole investigations (.zip, folder, project.md), always reviewed first and never overwriting existing data.
  • Graph: entity-type icons and evidence markers on relationships.
  • Updates: Check for Updates, a Changelog in Settings and a What's new dialog after upgrading.

Added

Graph and evidence (closes #1, #2)
  • Entity-type icons inside graph nodes, shown once a node is large enough to read, always on hover and selection.
  • New entity types: Computer, Laptop, Smartphone, Server, Network Interface. The IP address type has its own icon now.
  • Evidence class derived from the verification status, so existing projects need no migration: Observed fact (confirmed, supported), Hypothesis (unverified, candidate), Disproven (rejected).
  • Highlighted edges carry a midpoint dot: filled when the relationship cites at least one source, hollow when it is unsourced.
  • Hovering an edge shows its evidence class and sources with capture dates and URLs.
  • Source capture dates and the evidence class are shown in the relationship editor.
Tools marketplace
  • New Tools view in the left rail with a searchable catalog grouped by input type (Username, Email, Phone, Domain).
  • Tools: Sherlock and Maigret (username), Holehe (email), Ignorant (phone), DNSRecon (domain DNS records, name servers, mail hosts) and dnstwist (registered look-alike domains).
  • One-click install into an isolated Python virtual environment inside TRACE's data folder; uninstall removes it completely.
  • Portable Python: if no Python 3.9+ is found, TRACE downloads Python 3.12 from python-build-standalone, verifies a pinned SHA-256, and extracts it into its own folder. No admin rights, nothing installed system-wide.
  • Run on a case entity or a typed value, with live output and a Stop button that also ends child processes. Each run has a hard time limit.
  • Results open in the import review: matched to existing entities, links start as Candidate, everything is tagged with the tool name and keeps the original output line as provenance.
  • Safety: the renderer sends only a catalog id and a validated value; the command line is built in the main process, without a shell, in a temporary working directory. Inputs can never start with -.
MCP server (read-only)
  • Eight tools: list_projects, get_project_summary, search_entities, get_entity, get_entity_neighbors, get_relationship, get_evidence, find_paths.
  • Runs locally over stdio with no extra dependencies; bundled in the app and started with TRACE's own binary, so Node.js is not required.
  • On/off switch in Tools → MCP server (off by default), applied immediately without restarting the client, with ready-to-copy client configuration.
  • Security: identifiers are validated, project folders are resolved with realpath and must stay inside projects/, symlinked or oversized files are ignored, unknown arguments are rejected, and no write operation exists at all.
  • Evidence classes, provenance (manual or imported) and bounded outputs for reliable agent use.
Import
  • Import data: SpiderFoot CSV, generic CSV (type and value columns), plain indicator lists and a canonical TRACE JSON format.
  • Review step with duplicate detection: for each entity choose Create new, Use existing or Skip. Existing records are never modified.
  • Imported records are tagged imported, keep the tool's original record, timestamps and source URLs, and cite an import source that also stores everything that could not be mapped.
  • Import investigation from a .zip, a case folder, or its project.md. On macOS one dialog accepts all three; elsewhere there are separate archive and folder entries.
  • If a case with the same id already exists, the import is saved as " (imported)" instead of overwriting it. This also fixes .zip import, which used to merge into an existing case silently.
Updates and release info
  • Check for Updates against GitHub Releases with proper SemVer comparison, including alpha pre-releases (alpha.10 is newer than alpha.9).
  • Graceful handling of no network, API rate limits, missing releases and malformed responses; the interface never blocks.
  • Changelog section in Settings shows the release notes of the installed version, cached for offline use.
  • What's new dialog appears once after the app is updated to a newer version.
  • Build ID YYYYMMDDHHMMSS-<12-char git commit> (UTC) on the loading screen and in Settings, replacing the release hash. It is generated at compile time and is unknown when git is unavailable. It identifies a build; it is not a checksum.
Storage
  • Storage section in Settings: total size of TRACE's data with a breakdown (investigations, installed tools, portable Python, removed cases), and the size of every investigation.
  • Remove an investigation from Settings or the explorer. On desktop choose Remove from TRACE (files are kept in the workspace's removed/ folder and can be re-imported) or Remove from disk (folder moved to the system Trash; never permanently deleted).

Changed

  • Custom dropdown menus replace the operating system's native select lists everywhere, with keyboard navigation and type-ahead.
  • MCP configuration snippets are syntax-highlighted.
  • The inspector's Evidence and Notes sections have + buttons: cite a new or existing source on a relationship, and start a note about an entity. Notes in the inspector open on click.
  • The inspector reopens by itself when you pick an entity or relationship, even if you had hidden it.
  • Tab titles follow renames of entities, sources, notes and relationships.
  • All fields and buttons in the entity editor now share one size and style.
  • Pointer cursor on every clickable element, including graph nodes and edges.
  • The explorer's old "Tools" tab is now Bookmarks, to avoid two things called Tools.
  • The startup screen shown before the interface loads now matches the in-app one, so there is no flash of the old design.
  • Version is 0.2.0-alpha.1, with a single source in package.json.
  • Intel artifacts are named …-x86_64.*, as in earlier releases.

Fixed

  • Extra indentation of "Re-run Layout" in the graph context menu.
  • Two identical toggle buttons in the inspector header, and the framed ⌘K hint in the search field.
  • Desktop detection now relies on an explicit flag instead of the mere presence of the Electron API.

Under the hood

  • Shared read-only query layer (src/core) used by the MCP server, with a sandboxed workspace reader.
  • Adapter-based import pipeline (src/services/import) that is easy to extend.
  • New tests for version comparison and the update checker, MCP read-only behaviour and sandboxing, import adapters, tool output parsers (based on real captured output), disk usage and project removal, the Build ID and folder import. 129 tests pass.

Known limitations

  • Windows and Linux packages were built but not tested interactively.
  • 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.
  • Tools contact third-party sites directly from your computer; use them only where you are allowed to.
  • The MCP server works with the desktop app's workspace; the browser build's data is not reachable.
  • There is no auto-updater: updates open the release page.
  • Alpha software: expect rough edges.

Full changelog: https://github.com/dlxarl/Trace/compare/v0.1.0-alpha.2...v0.2.0-alpha.1

View on GitHub

0.1.0-alpha.2

pre-release
PlatformFile
macOS (Apple Silicon)Trace-0.1.0-alpha.2-mac-arm64.dmg / .zip
macOS (Intel)Trace-0.1.0-alpha.2-mac-x64.dmg / .zip
Windows x64Trace-0.1.0-alpha.2-win-x64.exe / .zip
Linux x64Trace-0.1.0-alpha.2-linux-x86_64.AppImage / Trace-0.1.0-alpha.2-linux-x64.tar.gz

View on GitHub

0.1.0-alpha.1

pre-release

Trace v0.1.0-alpha.1

Trace is a local-first OSINT investigation and knowledge management tool for organizing entities, documenting findings, and exploring relationships through an interactive graph.

What's included
  • Organize investigations into separate projects.
  • Create and manage entities and their relationships.
  • Keep investigation notes and supporting information in one place.
  • Explore connections through a visual graph.
  • Work with your investigation data locally.
Early access

This is the first public alpha release of Trace. The application is still under active development, so bugs, incomplete features, and breaking changes are expected.

Feedback and bug reports are welcome through [GitHub Issues].

View on GitHub