solstone home

get started with solstone.

solstone is a personal memory platform. the solstone app takes in what you share with it, and all of it goes into your journal, the memory, on a device you own. open source, made by sol pbc.

your device the solstone app screen + audio, taken in along with you macos · linux · tmux your journal ~/journal the memory everything the solstone app takes in, kept, organized, and searchable here transcription · vision · search · dashboard your journal is always private, only yours
your devices linux the solstone app: screen + audio solstone-linux macos the solstone app: screen + audio solstone-macos tmux the solstone app: terminal sessions solstone-tmux windows the solstone app: screen + audio solstone-windows mobile in beta your journal ~/journal the memory everything the solstone app takes in, kept, organized, and searchable here transcription · vision · search · dashboard your journal is always private, only yours

your journal is just files

open it and it's dated folders of plain markdown, json, and your own raw audio and screen frames (if you opt to preserve them after processing). you can cat it, grep it, put it in git, and back it up like any other folder. no proprietary format, no schema only we can read, nothing locked inside a database. the only database is a search index, and it's disposable: delete it and it rebuilds itself from the files. the files are the memory. everything else is derived. that's what "owned by you" has to mean to be real.

early days. solstone is open source and hands-on. you'll spend time in the terminal, you'll find rough edges, and we'll fix them together as we go.

three ways to think

local — the default.

on a capable machine, the solstone app bundles local models set up in the background during install. capable means roughly 6–8 GB of GPU memory, or an Apple Silicon mac with 16 GB, and setup checks for you before anything downloads.

your own AI engine.

bring your own token (Claude, Gemini, or OpenAI), or point the solstone app at any OpenAI-compatible endpoint you run. sol pbc is never in the path.

confidential processing — available to approved scouts.

available to approved scouts. confidential processing extends your compute on confidential hardware sol pbc runs that keeps nothing: no content retained, no human review, nothing used to train. transcription can run there too; one setting turns that off any time, and transcription returns to your device. your journal stays on your device. how it works →

whichever you choose: your journal always lives on your device, and nothing is chosen for you silently. if no engine is set, the solstone app tells you and waits.

install with a coding agent

paste this prompt into claude code, codex cli, gemini cli, or similar. ~15 minutes start to finish.

github → what's new → 
install solstone from https://solstone.app/install

install yourself

setting up a new mac? the solstone app and the journal are two separate apps, and most people want both. both require Apple Silicon; Intel macs aren't supported.

download the solstone app download the journal

both signed by sol pbc, notarized by Apple, each updating over its own signed channel.

the solstone app takes in what you share with it here; the journal, its own app, is where it all gets kept, named and marked as yours on first run. already have a journal on another machine? the solstone app alone connects to it. choosing among the three ways to think, above, happens once you're set up, on your terms.

building from source? (developer path)

the journal ships as one self-contained tree. it needs no interpreter and no package manager of its own. the two commands are solstone and journal. the tree is not published yet. until the first release lands on updates.solstone.app, follow INSTALL.md.

# until the first release lands on updates.solstone.app, follow INSTALL.md.
# once published:
sh install.sh
journal setup
full INSTALL.md →

then open http://localhost:5015. the first-run wizard walks you through setting your identity and choosing among the three ways to think, above. your journal stays on this machine whichever you choose.

the journal ships as one self-contained tree. it needs no interpreter and no package manager of its own. the two commands are solstone and journal. one tree covers the journal on this machine and talking to a journal that already lives elsewhere. the tree is not published yet. until the first release lands on updates.solstone.app, follow INSTALL.md. once it is published: sh install.sh then journal setup.

# until the first release lands on updates.solstone.app, follow INSTALL.md.
# once published:
sh install.sh
journal setup
full INSTALL.md →

then open http://localhost:5015. the first-run wizard walks you through setting your identity and choosing among the three ways to think, above. your journal stays on this machine whichever you choose. to run the solstone app on your linux desktop, see solstone.app/download.

where your journal lives. your journal lives on linux machines (Intel/AMD or ARM) and on Apple Silicon macs running macOS 14 or later. anywhere else, you can still read and search a journal kept on another machine, but that machine can't host one of its own. you get told that plainly instead of a half-working install. if owners turn up on a machine we don't cover, we add it.

on windows? install solstone for windows at solstone.app/download. it pairs with the journal on your mac or linux machine. (the journal doesn't run on windows yet.)

already have solstone installed?

install solstone on more of your devices at solstone.app/download.

want to help shape what comes next?

solstone is being built in the open. scouts get early features first and a direct line to tell us what they're seeing. confidential processing is available to approved scouts.

join the scouts →