@superbased/observer 1.37.1 → 1.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,8 +4,8 @@
4
4
 
5
5
  <img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/brand/superbased-lockup-light.png" alt="SuperBased" height="32">
6
6
 
7
- **Track what every AI coding agent costs. See the limit coming.** See what Claude Code, Codex,
8
- Cursor and 37 more AI coding tools cost, per session and per model, from the tokens your provider
7
+ **Track what every AI coding agent costs. See the limit coming.** See what 50 AI coding tools cost,
8
+ Claude Code, Codex and Cursor included, per session and per model, from the tokens your provider
9
9
  actually billed. Free, Apache-2.0, and it runs on your machine.
10
10
 
11
11
  [![npm](https://img.shields.io/npm/v/@superbased/observer.svg)](https://www.npmjs.com/package/@superbased/observer)
@@ -47,8 +47,9 @@ and helps you control them.**
47
47
  returned: net input, 5-minute vs 1-hour cache writes, reasoning tokens and long-context repricing.
48
48
  - **Every coding agent in one place.** 50 adapters normalize Claude Code, Codex, Cursor, GitHub
49
49
  Copilot, Gemini CLI, Cline, Aider, Kiro, Devin, OpenCode, Junie and more into one local database.
50
- - **Local-first, no account.** No sign-in. Everything lives in one SQLite file under
51
- `~/.observer/`, and your session content is never uploaded without your explicit consent.
50
+ - **Runs on your computer.** Everything lives in one SQLite file under `~/.observer/`. Sign in
51
+ for a personal dashboard you can open anywhere; your sessions leave your computer only when you
52
+ connect, after you approve it.
52
53
  - **Know the next bill before it lands.** Prompt-cache tracking with expiry warnings, a cost band
53
54
  for your next message, and a 5-hour and weekly limit gauge for proxied sessions.
54
55
  - **Guardrails on your own agents.** Built-in and custom rules for destructive commands, secrets
@@ -68,6 +69,37 @@ observer scan # backfill history from the session logs already on disk
68
69
  observer doctor # check the install
69
70
  ```
70
71
 
72
+ ## Sign in (recommended)
73
+
74
+ ```bash
75
+ observer connect # your personal dashboard
76
+ observer connect acme # or the team with the short name acme
77
+ ```
78
+
79
+ One command signs you in and connects this machine. Your browser opens a page on
80
+ cloud.superbased.app that shows the machine and what will be shared; nothing is sent until you
81
+ click **Connect**. A personal dashboard gets **Summary only** (usage totals, not your prompts or
82
+ file paths). A team gets **Full detail** (prompts, responses and file paths, readable by the
83
+ team's admins). **Not now** keeps you signed in with nothing sent, and `observer disconnect`
84
+ stops sending at any time. You can also click **Sign in** in the local dashboard's top bar.
85
+ On a machine with no browser, `observer connect --no-browser` prints a code to enter at
86
+ cloud.superbased.app/connect.
87
+
88
+ Starting from scratch on a new machine? One command installs Observer, runs it as a background
89
+ service and connects:
90
+
91
+ ```bash
92
+ curl -fsSL https://superbased.app/connect.sh | sh # macOS and Linux
93
+ curl -fsSL https://superbased.app/connect.sh | sh -s -- acme # straight into a team
94
+ ```
95
+
96
+ ```powershell
97
+ irm https://superbased.app/connect.ps1 | iex # Windows
98
+ ```
99
+
100
+ Everything else in this README works without an account. See
101
+ [Start here](https://superbased.app/docs/getting-started/start-here).
102
+
71
103
  For provider-exact tokens, route your agent through the proxy: in the dashboard open Compression,
72
104
  click your tool's status pill and choose **Route through the observer proxy** (it previews the
73
105
  config change and writes only when you confirm), or run `observer claude` / `observer codex` for a
@@ -117,13 +149,26 @@ Click any session to open its detail view. Four of its tabs:
117
149
  ## Privacy
118
150
 
119
151
  No account needed. Today the default install sends us no usage statistics, analytics or crash
120
- reports, and your session content is never uploaded without your explicit consent. SuperBased stores
121
- paths, commands and short excerpts, scrubs secrets before writing, and binds the proxy and dashboard
122
- to `127.0.0.1` by default. The proxy forwards your own requests, unchanged, to the provider you
123
- already use. By default SuperBased also makes a few small requests of its own that carry none of
124
- your data, such as a daily download of the public model price table from superbased.app (turn it
125
- off with `[pricing.feed] enabled = false`). See
126
- [PRIVACY.md](https://github.com/superbasedapp/observer/blob/main/PRIVACY.md).
152
+ reports, and your sessions leave your computer only when you connect. SuperBased stores paths,
153
+ commands and short excerpts, scrubs secrets before writing, and binds the proxy and dashboard to
154
+ `127.0.0.1` by default. The proxy forwards your own requests, unchanged, to the provider you
155
+ already use. See [PRIVACY.md](https://github.com/superbasedapp/observer/blob/main/PRIVACY.md).
156
+
157
+ ### What Observer contacts by default
158
+
159
+ <!-- Hand-written from tests/invariant/egress_lanes_test.go and cmd/observer/privacy.go
160
+ (2026-11-17). Regenerate from `observer privacy --markdown` once that output exists. -->
161
+
162
+ | What | Host | When | What it sends | Turn it off |
163
+ |---|---|---|---|---|
164
+ | Model price list | superbased.app | when Observer starts, then daily | nothing about you: a plain download of a signed public file | `[pricing.feed] enabled = false` |
165
+ | Package lists for the install check | superbased.app | every 6 hours | nothing about your projects: the same signed public files for everyone | `[security.deps] index_download = false` |
166
+ | Connection warm-up | chatgpt.com, api.openai.com | once when the proxy starts | a bare HEAD request, no body and none of your data | `[proxy] prewarm_targets = []` |
167
+
168
+ Everything else needs you to turn it on: your AI tool's own requests pass through the proxy only
169
+ when you route that tool through it, and your sessions go to cloud.superbased.app only after you
170
+ run `observer connect` and approve the machine. The vulnerability databases download only after
171
+ you accept them once. `observer privacy` lists every outbound request this build can make.
127
172
 
128
173
  ## Learn more
129
174
 
@@ -1,6 +1,10 @@
1
1
  #!/usr/bin/env node
2
2
  // @superbased/observer postinstall: PRINT-ONLY (T-753).
3
3
  //
4
+ // On every OS it prints one next-step line (Getting started v2): run
5
+ // `observer start`, which opens the dashboard, where signing in is the
6
+ // recommended next step. It never starts anything itself.
7
+ //
4
8
  // `npm install -g` over an older version swaps the platform package's
5
9
  // directory underneath a running Observer daemon: the old process keeps
6
10
  // running the deleted binary until it is restarted (the rc.3 roll found
@@ -137,11 +141,22 @@ function emit(text) {
137
141
  process.stderr.write(text);
138
142
  }
139
143
 
144
+ // NEXT_STEP is the one line every fresh install prints, on every OS.
145
+ const NEXT_STEP = 'Installed. Next: observer start (opens your dashboard, where you sign in)\n';
146
+
147
+ // main prints the stale-daemon note when an updated install left a running
148
+ // daemon on the previous binary (Linux only: it reads /proc), and otherwise
149
+ // the next-step line.
140
150
  function main() {
141
- if (process.platform !== 'linux') return;
142
- const root = process.env.OBSERVER_POSTINSTALL_PROC_ROOT || '/proc';
143
- const pids = staleDaemons(root, installedBinary());
144
- if (pids.length > 0) emit(note(pids, root));
151
+ if (process.platform === 'linux') {
152
+ const root = process.env.OBSERVER_POSTINSTALL_PROC_ROOT || '/proc';
153
+ const pids = staleDaemons(root, installedBinary());
154
+ if (pids.length > 0) {
155
+ emit(note(pids, root));
156
+ return;
157
+ }
158
+ }
159
+ emit(NEXT_STEP);
145
160
  }
146
161
 
147
162
  if (require.main === module) {
@@ -153,4 +168,4 @@ if (require.main === module) {
153
168
  process.exit(0);
154
169
  }
155
170
 
156
- module.exports = { staleDaemons, note, retiredDir, installedBinary, underServiceUnit };
171
+ module.exports = { staleDaemons, note, retiredDir, installedBinary, underServiceUnit, NEXT_STEP };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@superbased/observer",
3
- "version": "1.37.1",
3
+ "version": "1.39.0",
4
4
  "description": "Local-first AI coding agent observability: Claude Code token usage, Codex cost and Cursor spend across 50 adapters, provider-exact via a local proxy. No account needed.",
5
5
  "keywords": [
6
6
  "ai",
@@ -47,11 +47,11 @@
47
47
  "LICENSE"
48
48
  ],
49
49
  "optionalDependencies": {
50
- "@superbased/observer-linux-x64": "1.37.1",
51
- "@superbased/observer-linux-arm64": "1.37.1",
52
- "@superbased/observer-darwin-x64": "1.37.1",
53
- "@superbased/observer-darwin-arm64": "1.37.1",
54
- "@superbased/observer-win32-x64": "1.37.1"
50
+ "@superbased/observer-linux-x64": "1.39.0",
51
+ "@superbased/observer-linux-arm64": "1.39.0",
52
+ "@superbased/observer-darwin-x64": "1.39.0",
53
+ "@superbased/observer-darwin-arm64": "1.39.0",
54
+ "@superbased/observer-win32-x64": "1.39.0"
55
55
  },
56
56
  "scripts": {
57
57
  "test": "node bin/observer.js --version",
@@ -62,7 +62,7 @@
62
62
  "id": "v1.37.0-macos13-codesec",
63
63
  "severity": "notice",
64
64
  "title": "v1.37.0 needs macOS 13 or later, and code security is now on",
65
- "body": "This release needs macOS 13 Ventura or later. On macOS 12, stay on v1.36.0. Code security is now on by default in the developer and full editions, so an agent commit or push can ask you first. Run observer guard status to see it.",
65
+ "body": "This release needs macOS 13 Ventura or later. On macOS 12, stay on v1.36.0. Code security is now on by default in the developer and full editions, so an agent commit or push can ask you first. See it on the Security page.",
66
66
  "url": "https://github.com/superbasedapp/observer/releases/tag/v1.37.0",
67
67
  "expires_at": "2026-12-30T00:00:00Z",
68
68
  "source": "release"