solstone doesn't observe anything on its own — it needs an observer to experience your day along with you. pick the one for your platform, copy the prompt below into your coding agent, and it handles the rest.
early days. macOS and linux observers are in use today. they're working but still early — expect rough edges, especially around permissions and audio routing.
native macOS screen and audio observer
the macOS observer. sets up sol and your journal for you, then opens the first-run wizard.
signed by sol pbc, notarized by Apple. updates over a signed channel.
developer build (build from source). most people should download the DMG above. this path requires Xcode (full IDE, not just command line tools) and is here for developers who want to build, modify, or hand the install to a coding agent. cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-macos.git && cd solstone-macos then read INSTALL.md and follow it.
linux desktop screen and audio observer
install the solstone-linux observer — it experiences your screen and audio along with you on linux desktops using PipeWire and GStreamer, and sends to your journal. run this from your solstone host: sol observer install --platform linux that installs the observer from PyPI, runs the system-package preflight, registers it, and writes the systemd unit. add --dry-run first to preview every step. building from source instead? (developers only) clone the repo and follow its INSTALL.md: cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-linux.git && cd solstone-linux
native windows screen and audio observer
planning stages
for multiple sensors
active development
for multiple sensors
next in roadmap
solstone-tmux observes all active tmux sessions and panes every 5 seconds. lightweight, pure python, no system dependencies. works alongside either desktop observer.
install the solstone-tmux observer — it experiences your tmux sessions along with you, taking in what's on each pane every 5 seconds. lightweight, pure python, no system dependencies. run this from your solstone host: sol observer install --platform tmux that installs the observer from PyPI, registers it, writes its config, and installs the systemd unit. add --dry-run first to preview every step. building from source instead? (developers only) clone the repo and follow its INSTALL.md: cd "$(sol root)/observers" && git clone https://github.com/solpbc/solstone-tmux.git && cd solstone-tmux