get started
what you share with the solstone app goes into your journal, on a computer you own. you can start with either one: set up your journal, or add the solstone app and connect the two later.
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.
-
install both apps
open the download and drag the solstone app and the journal app into Applications.
-
open either app
one setup sequence takes you through both.
-
make your journal yours
choose its folder, choose its permanent mark, and review where thinking happens. you can change the thinking choice or leave it for later.
-
choose what to share
turn on your microphone and screen one at a time, or choose "not now". what you share goes into your journal.
-
open your journal
once the solstone app connects, open your journal in your browser.
-
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.
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 and desktop app: x86_64 (intel or amd) or arm64. 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 releases with minisign and downloads a pinned copy if you don't have it. your journal also needs your system's OpenMP runtime:
sudo apt install libgomp1,sudo dnf install libgomporsudo pacman -S gcc-libs. if it's missing, the installer shows you 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
the installer opens setup in your browser. if it cannot, use the link it prints. on a computer without a desktop, it also prints how to open setup from another computer.
-
add the desktop app
the solstone app takes in what you share from your desktop, and all of it goes into your journal. run the same command and choose desktop, or run this one:
curl -fsSL https://solstone.app/install.sh | sh -s -- --components desktop
then open solstone from your app menu. with your journal on this computer, its journal tab finds it and one press connects. with a journal on another computer, open network in that journal, choose pair a device to make a pairing link, and paste it in the tab, or open the link and choose open in the solstone app. if solstone doesn't open from your app menu, the linux app guide lists the packages it needs, and it also covers pairing from a terminal.
check it's ours. the installer checks release signatures with minisign and matches packages and archives to their signed checksums. the package repositories are signed with our OpenPGP key (BD77BD200A710D13EDF1D2555BF7582BF7EBA751), and its armored key file carries a minisign signature from our release key. the journal's signed release records are on trust.solstone.app.
prefer apt, dnf or zypper?
add the signed repository for your distribution. the solstone package installs both your journal (solstone-journal) and the desktop app (solstone-linux). for just one, install solstone-journal or solstone-linux instead.
on debian or ubuntu:
sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSLo /etc/apt/keyrings/solstone-archive-keyring.gpg https://updates.solstone.app/linux/keys/solstone-archive-keyring.gpg sudo chmod a+r /etc/apt/keyrings/solstone-archive-keyring.gpg printf 'Types: deb\nURIs: https://updates.solstone.app/linux/apt\nSuites: release\nComponents: main\nArchitectures: %s\nSigned-By: /etc/apt/keyrings/solstone-archive-keyring.gpg\n' "$(dpkg --print-architecture)" | sudo tee /etc/apt/sources.list.d/solstone.sources >/dev/null sudo apt update && sudo apt install solstone
on fedora or RHEL:
sudo rpmkeys --import https://updates.solstone.app/linux/keys/solstone-archive-keyring.asc printf '[solstone]\nname=solstone\nbaseurl=https://updates.solstone.app/linux/rpm/release/$basearch\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://updates.solstone.app/linux/keys/solstone-archive-keyring.asc\n' | sudo tee /etc/yum.repos.d/solstone.repo >/dev/null sudo dnf install solstone
on openSUSE:
sudo rpm --import https://updates.solstone.app/linux/keys/solstone-archive-keyring.asc printf '[solstone]\nname=solstone\nenabled=1\nautorefresh=1\nbaseurl=https://updates.solstone.app/linux/rpm/release/$basearch\ntype=rpm-md\ngpgcheck=1\nrepo_gpgcheck=1\npkg_gpgcheck=1\ngpgkey=https://updates.solstone.app/linux/keys/solstone-archive-keyring.asc\n' | sudo tee /etc/zypp/repos.d/solstone.repo >/dev/null sudo zypper refresh solstone && sudo zypper install solstone
system packages put the programs in /usr/bin and leave your account's services to you. after installing, set up your journal and start the desktop app from your own account:
solstone journal setup && solstone-linux install-service
if you installed only one package, run only its half of that command. your package manager updates what you installed whenever you upgrade your system.
on your windows computer
the journal runs on windows 10 (22H2) or 11 on x86_64 (intel or amd, shown as x64 in windows settings), or on windows 11 on arm64 (shown as ARM-based in windows settings). no administrator access needed to install.
-
set up your journal
download and run the journal installer. then open journal from the Start menu. follow the steps in its window to choose your journal's mark and where thinking happens. you can set up thinking later.
-
choose what you share
in the journal window, choose continue in the solstone app. if you need the app, the window shows you where to get it. install it, then return to the journal window and continue.
get the windows app below, open its installer, then follow the steps in the solstone app.
microphone, system audio and screen start off on a new install. turn on each one you want to share with your journal, check that it works, or choose not now. you can finish with all three off.
when you continue from the journal window, its pairing link is already filled in. if you install the app later, it finds your journal on this computer and one press connects. with a journal on another computer, open pair a device there and use its pairing link in the solstone app, then compare the marks.
the windows app is built for x64 PCs; windows 11 on arm64 runs x64 apps through its built-in emulation, but the app hasn't been tested on arm64 yet.
-
open your journal
after connecting, choose open your journal in the solstone app. your browser opens on your journal's home page.
in the solstone app's settings, choose journal, then open journal.
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. the journal's signed release records are on trust.solstone.app.
on your iphone or ipad
ios or ipados 26 or later. free on the App Store, where it's listed as solstone.app.
connect the app to a journal on your mac, windows or linux computer. your journal stays on that computer.
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, windows or linux computer. your journal stays on that computer.
check it's ours. Google Play lists sol pbc as the developer. getting it from us instead? check the download yourself.
from your terminal
part of the solstone app on mac and linux, for a computer with tmux on it and a journal already set up.
turn on terminal in the solstone app's settings and it takes in your tmux sessions, and all of it goes into your journal. on a linux computer with no desktop, the app runs with terminal alone. there, pair it with your journal, then run solstone-linux terminal on.
already have solstone for tmux? on a mac, or if you set it up by hand from its guide, add the solstone app and turn on terminal; it asks before moving it in. otherwise, on linux, run solstone update --lane release and it asks before moving it into the solstone app. no solstone command on that computer? run curl -fsSL https://solstone.app/install.sh | sh -s -- --upgrade --components tmux instead.
prefer to install with a coding agent?
paste this into Claude Code, Codex CLI, Gemini CLI, or similar.
install solstone using https://solstone.app/llms.txt and https://solstone.app/.well-known/skills/default/SKILL.md
don't see your platform? tell us what you'd like supported.
what your device will ask
- 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. the app asks for your precise location; you can choose approximate when it asks, or later in settings. your screen goes into your journal only while you broadcast it: you start it from the app, iphone shows its own screen-broadcast sheet, and you stop it there or from the red bar at the top of your screen.
- 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.
with audio on, the voices of people around you can go into your journal too, so let them know first. solstone and recording laws
you can pause any source, or turn it off, from the solstone app.
where does the thinking happen?
setup offers local thinking first when your computer can run it, with its download size. keep it, change it, or decide later. your journal stays on your computer whichever you choose; what each choice sends, and to whom, is below.
local, the default
a model downloads and runs on your computer, which needs enough graphics memory for it. if your computer can't run it, setup says so and you choose another way.
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
think off your device on confidential hardware sol pbc runs, for $96 a year or $9.99 a month. no content is retained · no human reviews it · nothing is used to train. how it works
connect your agent
the agents you already use can work from your journal. you choose which ones.
on the same computer
any agent that speaks MCP can connect to your journal from the same computer. through this connection, your agent can search and read your journal and keep notes of its own there. it can't add, change, or delete anything else.
- open your journal, then open agents. on a mac or on windows, choose open your journal in the journal app. on linux,
solstone journal open /app/agentsgoes straight there. - choose connect an agent, then on this computer, then make a pairing code. the code works once and expires after 10 minutes.
- add your journal to your agent with the line the agents app shows for it. on every computer, that line points your agent at
http://127.0.0.1:7659/mcp. - your browser opens your journal's page. choose what the agent may see, enter the code, and connect.
on a mac or on windows, with Claude Code, the line is:
claude mcp add --transport http journal "http://127.0.0.1:7659/mcp"
then type /mcp in Claude Code, choose journal, and authenticate.
on linux, setting up your journal adds a solstone skill only where Claude Code, Codex or Gemini CLI is already set up. after setting up another agent, run solstone skills install to add it there too. solstone skills list shows it. with the skill, an agent in any project can search your journal, look up a person, or read a transcript.
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.
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.
the full reference for connecting an agent or building on your journal →
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, windows or linux computer: in your journal, open network and choose pair a device.
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
the daily briefing for day 1 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: open journal from the Start menu and manage updates there.
on linux: from journal 2.0.82, an install from install.sh checks once a day for a new version and installs it in the background (a new install turns this on, an existing one asks you once in your journal), and it never restarts your journal: the new version starts the next time your journal does. to update right away, run solstone update; to turn the daily check off, run solstone update --automatic off. if you installed from the package repository, upgrade with apt, dnf or zypper, then run solstone journal service restart. journal upgrade guide.
after updating, reopen your journal and check the version in its status details.
early days. on a mac, on windows and on your phone, solstone installs like any app. on linux, setup takes a step in the terminal. expect a few rough edges, and tell us when you find one.