how it works

what startrail is

Startrail is a hosted graph explorer for reasoning, built on top of the memex CLI.

memex lets you capture decisions, artifacts, and threads as nodes in a directed acyclic graph (DAG) stored as files in your repo.

Startrail makes those graphs hostable and shareable with a URL. No separate deploy command, no new tokens. Git is the transport. Push normally; Startrail reads the rest.

the core mechanic

1.
memex writes files
As you work, memex writes .memex/nodes/*.json into your repo, capturing every decision and artifact.
2.
you push to GitHub
Normal git workflow, including the memex nodes.
3.
Startrail reads from GitHub
Startrail fetches .memex/ directly from the GitHub API and renders an interactive graph in your browser.
4.
share the link
Make a repo public in your Startrail dashboard and share the URL that anyone can explore the graph. Or, just keep it private.

getting started

1.
install the memex CLI
Follow the instructions at github.com/maxrios/memex.
2.
run memex init
Initialize a graph in any git repo. Start capturing decisions with memex node create.
3.
push to GitHub
Commit .memex/ files alongside your source and push as normal.
4.
sign in to Startrail
Sign in with your GitHub account. Access is invite-only during early development.
5.
connect the repo
Add the repo from your dashboard and Startrail will read the graph automatically.
6.
share the link
Toggle the repo to public and copy the share URL from your dashboard.

← back