personal memory agent
docs(install): document sol observer install
Point install docs at the managed observer command so owners no longer have to follow the source-clone path by default.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+25
-34
+9
-17
INSTALL.md
+9
-17
INSTALL.md
···
98
98
99
99
## install an observer
100
100
101
-
solstone doesn't observe anything on its own — it needs an observer for the platform.
101
+
solstone needs a platform observer alongside the server.
102
102
103
103
```bash
104
-
uname -s
104
+
sol observer install
105
+
sol observer install laptop
106
+
sol observer install laptop --platform linux
107
+
sol observer install --platform tmux
108
+
sol observer install --dry-run
105
109
```
106
110
107
-
clone the observer into solstone's observers directory and follow its INSTALL.md:
108
-
109
-
```bash
110
-
cd "$(sol root)/observers"
111
-
```
111
+
with no name, `sol observer install` uses the machine hostname. pass a name when you want a stable stream name, pass `--platform` to choose linux or tmux explicitly, and use `--dry-run` to see the plan before anything is changed.
112
112
113
-
**linux:**
114
-
```bash
115
-
git clone https://github.com/solpbc/solstone-linux.git
116
-
```
117
-
then read `solstone-linux/INSTALL.md` and follow it.
113
+
on macOS, `sol observer install --platform macos` directs you to the signed app bundle at https://solstone.app/observers.
118
114
119
-
**macOS:**
120
-
```bash
121
-
git clone https://github.com/solpbc/solstone-macos.git
122
-
```
123
-
then read `solstone-macos/INSTALL.md` and follow it.
115
+
for manual build-from-source troubleshooting, use the per-observer repo docs: `solstone-linux/INSTALL.md`, `solstone-tmux/INSTALL.md`, or the macOS app instructions.
124
116
125
117
## updating after a code change
126
118
+13
-17
docs/INSTALL.md
+13
-17
docs/INSTALL.md
···
219
219
220
220
## Observers
221
221
222
-
Observers capture screen and audio and upload to the solstone server. Each platform has its own standalone observer. Packages are not yet on PyPI — install from source.
222
+
Observers run alongside each platform and send observations to the solstone server. The `sol observer install` command handles the normal local setup path.
223
223
224
-
### Linux Observer
224
+
### Install
225
225
226
226
```bash
227
-
git clone https://github.com/solpbc/solstone-linux.git
228
-
cd solstone-linux
229
-
pipx install --system-site-packages .
230
-
solstone-linux setup
231
-
solstone-linux install-service
227
+
sol observer install
228
+
sol observer install laptop
229
+
sol observer install laptop --platform linux
230
+
sol observer install laptop --platform tmux
231
+
sol observer install --dry-run
232
232
```
233
233
234
-
`--system-site-packages` is required for PyGObject/GStreamer access.
234
+
With no name, `sol observer install` uses the machine hostname. Pass a name for a stable stream name, pass `--platform` to choose linux or tmux explicitly, and use `--dry-run` to see the plan before anything changes.
235
235
236
-
**Note:** Activity detection (idle, lock, power save) requires GNOME desktop. Other desktops: capture works but activity-based segment boundaries won't trigger.
236
+
Linux installs from `https://github.com/solpbc/solstone-linux.git`; tmux installs from `https://github.com/solpbc/solstone-tmux.git`. If a system package is missing, the command reports the distro-specific install command and stops before changing observer state.
237
237
238
-
### tmux Observer
238
+
### macOS Observer
239
239
240
240
```bash
241
-
git clone https://github.com/solpbc/solstone-tmux.git
242
-
cd solstone-tmux
243
-
pipx install .
244
-
solstone-tmux setup
245
-
solstone-tmux install-service
241
+
sol observer install --platform macos
246
242
```
247
243
248
-
### macOS Observer
244
+
macOS is delivered as a signed app bundle. The command directs you to https://solstone.app/observers.
249
245
250
-
See [solstone-macos](https://github.com/solpbc/solstone-macos) — requires Xcode (full IDE, not just CLI tools).
246
+
For manual build-from-source troubleshooting, use each observer repo's `INSTALL.md`. The linux repo includes distro package details and desktop notes; the tmux repo covers its pure-python service path.
251
247
252
248
---
253
249