get started

what you share with the solstone app goes into your journal, on a computer you own. set up the journal first, then add the solstone app on each device you want to share from.

the solstone app

takes in what you choose to share from your devices.

your journal

keeps it organized and searchable on your mac, windows or linux computer.

install

choose the computer your journal will live on.

choose the device you're adding. it connects to the journal you already have.

on your mac

an Apple Silicon mac (M1 or newer) with macos 15 or later. Intel macs aren't supported.

create your journal first

install and open the journal app. choose where your journal lives, and lock in its mark: two shapes and two words that are your journal's own, so you can always tell which journal is yours. then choose open your journal to read it in your browser.

get the journal app
connect the solstone app

install and open the solstone app. in settings, choose journal to connect. for a journal on your mac, confirm the one it finds. follow the prompts to choose what you share.

get the solstone app

check it's ours. both mac apps are signed by sol pbc and notarized by Apple. the journal's signed release records are on trust.solstone.app.

prefer the terminal?

install both mac apps with one command:

curl -fsSL https://solstone.app/install.sh | sh -s -- --components all

for just one, replace all with journal or app. the installer verifies the download and puts the app in /Applications. updates stay inside each app.

installed the journal from the terminal before?

install the journal app, then open it. the journal app adopts an older journal only when it can verify the installation it is taking over. if anything is unclear, it stops and tells you what needs attention. your journal stays where it is. contact support if you need a hand.

journal on another computer?

in your journal, open network and choose pair a device. copy the pairing link. in the solstone app's journal settings, choose pair to a journal on another device, paste the link, and confirm it's your journal.

on your linux computer

journal: x86_64 (Intel or AMD) or arm64. desktop app: x86_64 only. not sure which you have? uname -m prints x86_64, or aarch64 on arm64. anything else isn't supported.

set up your journal

the installer verifies its downloads with minisign, so add it first if you don't have it: sudo apt install minisign, sudo dnf install minisign or sudo pacman -S minisign. not sure which? run the command below. if minisign is missing, the installer stops before changing anything and says how to add it.

run this command in your terminal. it installs your journal and starts it.
```
curl -fsSL https://solstone.app/install.sh | sh
```
then open your journal in your browser and follow setup.
add the desktop app

the solstone app takes in what you share from your desktop, and all of it goes into your journal. its setup guide includes the packages your system needs.

set up the linux app

check it's ours. the journal installer verifies every download with minisign before it installs anything, and the desktop app's setup guide has you check its signature yourself. the journal's signed release records are on trust.solstone.app.

on your windows computer

windows 10 (22H2) or 11 on x86_64 (Intel or AMD, shown as x64 in windows settings). no administrator access needed to install. the journal installer is about 1.1 GB. the local model needs a compatible GPU; without one, thinking needs your own model. transcription runs on your PC.

set up your journal

download and run the journal installer.

get the journal for windows

then open a new terminal window and run:
```
solstone journal setup
```
then open your journal in your browser and follow setup.
connect the solstone app

install the solstone app, then connect it to your journal and choose what you share.

get the windows app

check it's ours. the journal installer and the solstone app for windows are both signed by sol pbc, and windows shows sol pbc as the publisher. trust.solstone.app doesn't carry signed release records for windows.

on your iphone or ipad

ios or ipados 26 or later. free on the App Store, where it's listed as solstone mobile.

connect the app to a journal on your mac or linux computer. your journal stays on that computer.

get it on the App Store

check it's ours. the App Store lists sol pbc as the developer.

on your android phone

android 8.0 or later. free on Google Play.

connect the app to a journal on your mac or linux computer. your journal stays on that computer. with a journal on windows, see what pairs with it.

get it on Google Play no Google Play? get it from us →

check it's ours. Google Play lists sol pbc as the developer. getting it from us instead? check the download yourself.

from your terminal

for tmux on an Apple Silicon mac (M1 or newer), or on x86_64 (Intel or AMD) or arm64 linux, with a journal already set up.

solstone-tmux brings what you share from your terminal sessions into your journal. it can run alongside the desktop app.

set up solstone-tmux

check it's ours. its setup guide has you verify each download with minisign before you install it.

prefer to install with a coding agent?

paste this into Claude Code, Codex CLI, Gemini CLI, or similar.

install solstone from https://solstone.app/install

don't see your platform? tell us what you'd like supported.

what your device will ask

the solstone app only takes in the sources you turn on, and all of it goes into your journal. your device asks your permission the first time.

mac: the microphone for audio, and screen & system audio recording for your screen and the sound your mac plays. it also asks to find devices on your local network, so the solstone app can find your journal.
linux: your desktop asks which screen to share when you turn on your screen as a source.
windows: while our signing reputation builds, windows may warn that it couldn't verify the solstone app because it isn't commonly downloaded. the publisher it shows is sol pbc. after that, you choose what you share inside the solstone app.
iphone and ipad: the microphone and your location, each when you turn on the source that needs it; the camera, to scan your journal's pairing code; your local network, to reach your journal; and notifications, if you turn them on.
android: the microphone and your location, each when you turn on the source that needs it; the camera, to scan your journal's pairing code or when you turn it on as a source; and notifications the first time you start sharing.

you can pause any source, or turn it off, from the solstone app.

where does the thinking happen?

you choose during setup. your journal stays on your computer whichever you choose; what each choice sends, and to whom, is below.

on windows, the local model needs a compatible GPU, and confidential processing isn't available there.

local, the default

a model runs on your computer. setup checks that your machine can run it before anything downloads.

your own model

bring your own provider key (Claude, Gemini, or GPT), or use an OpenAI-compatible endpoint you run. your provider sees what your journal sends it for thinking, under its own terms, and you pay it directly. sol pbc is never in the path.

confidential processing

available to approved scouts. think off your device on confidential hardware sol pbc runs. no content is retained · no human reviews it · nothing is used to train. how it works

nothing is chosen for you silently. if no model is set, your journal tells you and waits.

connect your agent

the agents you already use can work from your journal. you choose which ones.

on the same computer

on linux, setting up your journal adds a solstone skill to Claude Code, Codex and Gemini CLI if they're installed. from then on, an agent in any project can search your journal, look up a person, or read a transcript. and any agent that speaks MCP can connect to your journal from the same computer. it gets read-only tools: search, read, and look up people and transcripts. it can't add, change, or delete anything.

on your wifi or VPN

turn it on in your journal's agents app. an agent pairs with a code from your journal, and it only works on the route it paired through.

from anywhere

turn on solstone.me, an address for your journal that sol pbc runs, for $5 a year. or use a tunnel of your own: you never have to pay us. one warning: some free tunnels decrypt your traffic in order to move it. whoever runs one of those can read what your agent reads, and can reuse your agent's key to reach your journal as though they were your agent. look for a tunnel that says it only passes the bytes through; if its documentation doesn't say, assume it ends the encryption. the solstone.me relay is convenience, never a privacy upgrade over a tunnel that only passes the bytes through.

your journal's agents app works with your own route or with solstone.me; solstone.me is the address, and the agents app is where you manage what connects.

pair a phone, if you like

your journal works from your computer alone, so you can skip this. to add your iphone, ipad or android phone, get the solstone app from its store, then pair it with your journal on your mac or linux computer: in your journal, open network and choose pair a device. with a journal on windows, see what pairs with it.

solstone on your phone →

day 1, and tomorrow morning

day 1

what you share goes into your journal as you go. open it in your browser to read your day. as your journal works through what came in, transcripts fill in, and with a model set in step 3, so do the people in them and your meetings.

tomorrow morning

a briefing for the day ahead is waiting in your journal, written from your own material by the model you chose. your agents can read it too.

updating your journal

update the journal on the computer that runs it. the solstone app and your journal update separately, so their version numbers can differ.

on mac: open the journal app and choose updates in its sidebar. the solstone app has its own updates pane in settings. manual journal update instructions.

on windows or linux: follow the journal upgrade guide for your installation.

after updating, reopen your journal and check the version in its status details.