whatisgithub

What is field-notes?

sparkly-quasar/field-notes — explained in plain English

Analysis updated 2026-05-18

2RustAudience · generalComplexity · 3/5Setup · easy

In one sentence

A private, fully offline journal app for tracking substance use safely, with dose warnings, a local AI support chat, and no cloud or accounts.

Mindmap

mindmap
  root((Field Notes))
    What it does
      Offline journal
      Session timeline
      Combination warnings
      Substance reference
    Tech stack
      Tauri 2
      Svelte TypeScript
      Rust
      SQLite
    Use cases
      Log a session
      Check drug combos
      Talk to local companion
      Sync to Obsidian
    Audience
      Harm reduction users
      Privacy focused people
    Safety
      Crisis resources
      Fixed rule alerts
      Not medical advice

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a private, encrypted log of substance use over time.

USE CASE 2

Check planned combinations against known dangerous interactions before taking anything.

USE CASE 3

Talk to a local AI companion during a session without any data leaving your device.

USE CASE 4

Export journal entries into an Obsidian vault for long term note keeping.

What is it built with?

RustTauriSvelteTypeScriptSQLiteSQLCipher

How does it compare?

sparkly-quasar/field-notes132ikl/game1lystore/pay-dcp
Stars222
LanguageRustRustRust
Last pushed2020-12-30
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Download a prebuilt installer for your OS, Windows and macOS builds are not yet signed or notarized.

The README does not state a license, so terms of use and redistribution are unclear.

So what is it?

Field Notes is a private, offline journal and safety companion built for people who track psychedelic and other substance experiences. It runs entirely on your own computer: no accounts, no cloud storage, and no network requests, so nothing you write is ever scanned or sent anywhere. The whole journal can be locked behind a password using encryption, and the entire app can be backed up or restored as a single file. The core of the app is a timeline. You can write plain diary entries, or log a session in detail, including what was taken, how much, and how you felt as time passed. Before combining substances, you can check them against a built in reference of known dangerous combinations, and every dose you log is automatically checked against the others. A bundled reference covers hundreds of substances with dose ranges, duration, and other details, sourced from the public domain DoseWiki project, so you can read it fully offline. During an active session, there is a calm support chat, powered by a local AI model that never leaves your machine. You can pick how it responds, for example just listening or keeping you grounded, and you can turn it off completely if you prefer. If the chat detects signs of a crisis, or a dangerous combination is logged, the app surfaces real emergency and peer support contacts, driven by fixed rules rather than the AI itself. Other features include importing a past experience from plain text and having the local model turn it into a structured entry for you to review, searchable offline access to the substance reference, and two way sync with an Obsidian vault so entries can be exported as readable Markdown notes and brought back in. Optional phone access lets you use the journal, checker, reference, and chat away from your desktop, kept private by design. The project is built with Tauri 2 and Svelte in TypeScript for the desktop shell, with a local SQLite database and optional SQLCipher encryption at rest. It works on Windows, macOS, and Linux. The authors are explicit that this is a harm reduction and journaling tool, not medical advice, and that the interaction checker only flags some well documented combinations.

Copy-paste prompts

Prompt 1
Explain how Field Notes keeps my journal data private and offline.
Prompt 2
Walk me through installing Field Notes on macOS and unlocking it after first launch.
Prompt 3
How does Field Notes decide when to show a crisis resource alert?
Prompt 4
Show me how the Obsidian sync in Field Notes works in both directions.

Frequently asked questions

What is field-notes?

A private, fully offline journal app for tracking substance use safely, with dose warnings, a local AI support chat, and no cloud or accounts.

What language is field-notes written in?

Mainly Rust. The stack also includes Rust, Tauri, Svelte.

What license does field-notes use?

The README does not state a license, so terms of use and redistribution are unclear.

How hard is field-notes to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is field-notes for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.