Local-first · Relate embedded · v0.1

Think in graphs.
Keep them close.

Graph Craft Relate is a desktop workbench for connected data. Search a graph without writing a query, shape it on a live canvas, run the algorithms, and hand the same surface to an agent.

Linux · macOS · Windows · Arch/AUR · signed in-place updates

Local-first
Projects are folders you own
Cypher-native
Relate, embedded
84 tools
One shared canvas MCP
Reference Graph All · Nodes · Rels
◎ Commissioning ◇ Desk Study ◈ Evidence ▣ Field Study ✓ Decision ↗ Outcome ◇ Routes ⌁ Inventory

FIG. 01 The canvas is the interface. Everything else is a panel.

LOCAL-FIRSTCYPHER-NATIVEAGENT-READABLESIGNED UPDATESNO CLOUD REQUIRED

The workbench

A graph surface that behaves like a tool.

Search first, then work the graph: inspect, edit, analyze, and keep a view. No dashboards, no query console, no ceremony.

01

Search, not query

Type Person acted in Movie or a property value. The app compiles patterns, suggests only real schema steps, and brings matches onto the canvas.

02

Shape the scene

Drag, group, filter, and lay out. Stage node and edge edits, review schema changes, then sync. The save pill keeps work visible.

03

Analyze in place

Paths, waves, communities, PageRank, betweenness, cycles, HITS, geo radius. Results become overlays, groups, and saved perspectives.

04

Keep the view

Perspectives save selection, positions, layout, styles, groups, notes, and analysis. Reopen a graph exactly as you left it.

05

Bring your graph

Import from Neo4j/Aura with standard Bolt URIs or the HTTP Query API. Multi-label nodes keep every label; the common label no longer steals color.

06

Ship a real desktop app

Native bundles for Linux, macOS, and Windows, signed in-place updates, file associations, and projects that are just folders on disk.

Specimen

A graph you can hold.

The Movies Graph, with images, labels, and relationships. The same canvas runs on your desktop, not in a browser tab owned by someone else.

  • Node images and captions from any property
  • Multi-label nodes keep their specific categories
  • Perspectives restore the exact working view
Movies Graph
Graph Craft Relate canvas showing movie, genre, and person nodes with portrait images.
FIG. 02 Movies Graph · 9 nodes · 9 links · images from a `photo` property.

The loop

Ask. Shape. Prove. Share.

  1. 01

    Ask

    Focus a node or select a set. The agent reads the same selection, view, and analysis you do.

  2. 02

    Shape

    Stage edits and relationships, review the schema, sync once. Every change is visible before it lands.

  3. 03

    Prove

    Run an algorithm, inspect the result groups, and save the perspective as evidence.

  4. 04

    Share

    Export PNG/SVG, a perspective, or a `.rl` bundle. The graph stays portable.

Local-first

Your graph is a folder.
Not a tenancy.

Relate is embedded. A project lives where you put it: a directory with a store, files, and a manifest. Move it, back it up, or hand it to someone else.

No cloud requiredThe app runs without an account server or network.
No lock-inExport `.rl` bundles and perspectives; import them anywhere.
No silent updatesUpdates are signed and installed in place; you choose when to restart.
FILES~/GraphCraftRelate/Investigation
Investigation/
├── project.json        # label, created
├── files/              # source files
├── graph/              # Relate store
│   ├── manifest.json
│   ├── nodes/
│   └── wal/
└── scenes.json         # perspectives

Local · recoverable · yours

Install

Install it like a tool.
Not a subscription.

Private beta builds are published as signed desktop bundles. Pick your platform; the app updates itself in place on AppImage, macOS, and Windows. Package-manager installs update through the package manager.

Request a beta build Private beta · signed bundles · SHA256SUMS
LinuxAppImage · universal

Download the AppImage, make it executable, and run it. No install step; the app keeps its projects in folders you choose.

chmod +x Graph-Craft-Relate_*.AppImage
./Graph-Craft-Relate_*.AppImage

FUSE 2 is required by AppImage. If it is missing, install fuse2 (Arch), libfuse2 (Debian/Ubuntu), or run with --appimage-extract-and-run.

In-place auto-update is supported for AppImage. The .deb/.rpm packages update through your package manager.

Arch LinuxAUR · the native path

Arch is the reference environment. Use the AUR package when published, or run the AppImage.

yay -S graph-craft-relate-bin
# or: paru -S graph-craft-relate-bin

Building from source needs the Tauri/WebKit stack:

sudo pacman -S --needed base-devel webkit2gtk-4.1 gtk3 \
  libappindicator librsvg patchelf openssl

Arch notes: AppImage needs fuse2. Wayland works natively; on some GPUs, set WEBKIT_DISABLE_COMPOSITING_MODE=1 if the canvas is blank. On ARM/ALARM, build the aarch64 bundle from source.

Omarchy: the app detects Omarchy and offers Follow the Omarchy theme and accent in Settings. It reads the current theme's colors.toml; the option is hidden on other desktops.

Debian / Ubuntu.deb
sudo apt install ./graph-craft-relate_*_amd64.deb

Dependencies: libwebkit2gtk-4.1-0, libgtk-3-0, libayatana-appindicator3-1, librsvg2-2. Use the AppImage if your release is older than Ubuntu 22.04.

Fedora.rpm
sudo dnf install ./graph-craft-relate-*.x86_64.rpm

Dependencies: webkit2gtk4.1, gtk3, libappindicator-gtk3, librsvg2. Fedora Silverblue users should use the AppImage or a Distrobox container.

openSUSE.rpm
sudo zypper install ./graph-craft-relate-*.x86_64.rpm

Dependencies: webkit2gtk4.1, gtk3, libappindicator3-1, librsvg2.

macOS.dmg · Apple Silicon / Intel

Open the DMG, drag Graph Craft Relate to Applications, and launch it.

Beta builds may be unnotarized: right-click the app → Open the first time. Production builds are signed and notarized. Auto-update is in place.

WindowsNSIS / MSI

Run the .exe installer (or the MSI). The installer bootstraps WebView2 if it is missing.

Beta builds may show SmartScreen: More info → Run anyway. Production builds are code-signed. Auto-update is in place.

Windows on ARM64: use the x64 build under emulation; a native ARM64 bundle is not shipped yet.

NixOSAppImage · flake later

Run the AppImage through appimage-run:

nix-shell -p appimage-run
appimage-run ./Graph-Craft-Relate_*.AppImage

A native flake is planned; until then, use the AppImage or a Distrobox container. Do not mix the app's WebKit with a mismatched system runtime.

Alpine / muslnot native

WebKitGTK/Tauri does not ship a native musl bundle. Use a glibc Distrobox (Arch/Debian) or a Flatpak when available; the AppImage will not run natively on Alpine.

ARM64aarch64 · AppImage / deb / rpm

Use the aarch64 bundle. The Relate sidecar is pinned per target (relate-linux-arm64); the app refuses to start with a missing sidecar.

Arch ARM (ALARM) users can build from source with the same dependencies; the AUR package targets x86_64.

UPDATES

Signed, in place, on your terms.

The app checks a signed update feed on launch and every six hours. AppImage, macOS, and Windows install in place and ask before restarting. Debian/Fedora/openSUSE packages stay with your package manager.

# AppImage / macOS / Windows
Graph Craft Relate → update banner → Restart

# Arch
yay -Syu

# Debian / Ubuntu
sudo apt update && sudo apt upgrade

Agents

The same canvas,
for both of you.

The canvas MCP runs through the app's own command registry. An agent selects, focuses, lays out, styles, analyzes, and stages edits exactly like the human — with the same confirmations and read-only scope.

84 toolsProjects, perspectives, scene reads, draft-first writes, analysis state, exports, Neo4j import.
Common groundget_focus reads the human's selected node and its context.
Safe by default--scope read, exact confirmations, base_rev/dirty_board.
Read the agent notes
terminalagent setup
# install the agent skills from npm
npx graph-craft-relate-skills

# the canvas MCP is a stdio server
node packages/canvas-mcp/dist/cli.js \
  --app-id ai.graphcraft.relate

# read-only observers
node packages/canvas-mcp/dist/cli.js \
  --app-id ai.graphcraft.relate --scope read

84 tools · 6 skills · one shared selection

Private beta

Put a graph on your desk.

Relate is shipping to invited testers first. The source repository is private; the build channel is signed. Ask for access, or follow the install notes when you have a build.