@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 +56 -11
- package/bin/postinstall.js +20 -5
- package/package.json +7 -7
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
|
|
8
|
-
|
|
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
|
[](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
|
-
- **
|
|
51
|
-
|
|
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
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
already use.
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
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
|
|
package/bin/postinstall.js
CHANGED
|
@@ -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
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
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.
|
|
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.
|
|
51
|
-
"@superbased/observer-linux-arm64": "1.
|
|
52
|
-
"@superbased/observer-darwin-x64": "1.
|
|
53
|
-
"@superbased/observer-darwin-arm64": "1.
|
|
54
|
-
"@superbased/observer-win32-x64": "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.
|
|
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"
|