superbased-observer 1.37.0__py3-none-macosx_13_0_arm64.whl
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.
- observer/__init__.py +1 -0
- observer/__main__.py +46 -0
- observer/_bin/observer +4 -0
- superbased_observer-1.37.0.dist-info/METADATA +179 -0
- superbased_observer-1.37.0.dist-info/RECORD +8 -0
- superbased_observer-1.37.0.dist-info/WHEEL +5 -0
- superbased_observer-1.37.0.dist-info/entry_points.txt +3 -0
- superbased_observer-1.37.0.dist-info/licenses/LICENSE +20 -0
observer/__init__.py
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "1.37.0"
|
observer/__main__.py
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
"""Console-script entry point: locate the bundled observer binary and
|
|
2
|
+
exec it, forwarding argv (and on POSIX, signals via process replacement).
|
|
3
|
+
|
|
4
|
+
Mirrors the @superbased/observer Node shim. Each platform-tagged wheel
|
|
5
|
+
ships its own binary under observer/_bin/.
|
|
6
|
+
"""
|
|
7
|
+
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
import os
|
|
11
|
+
import sys
|
|
12
|
+
from pathlib import Path
|
|
13
|
+
from typing import NoReturn
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def _binary_path() -> Path:
|
|
17
|
+
name = "observer.exe" if sys.platform == "win32" else "observer"
|
|
18
|
+
return Path(__file__).resolve().parent / "_bin" / name
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def _report_missing(path: Path) -> NoReturn:
|
|
22
|
+
sys.stderr.write(
|
|
23
|
+
"superbased-observer: bundled binary not found at "
|
|
24
|
+
f"{path}\n"
|
|
25
|
+
"This usually means the installed wheel is for a different\n"
|
|
26
|
+
"platform than the one Python is running on. Re-install with:\n"
|
|
27
|
+
" pip install --force-reinstall superbased-observer\n"
|
|
28
|
+
"or report at https://github.com/superbasedapp/observer/issues\n"
|
|
29
|
+
)
|
|
30
|
+
raise SystemExit(1)
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
def main() -> NoReturn:
|
|
34
|
+
binary = _binary_path()
|
|
35
|
+
if not binary.is_file():
|
|
36
|
+
_report_missing(binary)
|
|
37
|
+
argv = [str(binary), *sys.argv[1:]]
|
|
38
|
+
if sys.platform == "win32":
|
|
39
|
+
import subprocess
|
|
40
|
+
|
|
41
|
+
raise SystemExit(subprocess.call(argv))
|
|
42
|
+
os.execv(str(binary), argv)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
if __name__ == "__main__":
|
|
46
|
+
main()
|
observer/_bin/observer
ADDED
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: superbased-observer
|
|
3
|
+
Version: 1.37.0
|
|
4
|
+
Summary: 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
|
+
Project-URL: Homepage, https://superbased.app/
|
|
6
|
+
Project-URL: Source, https://github.com/superbasedapp/observer
|
|
7
|
+
Project-URL: Documentation, https://github.com/superbasedapp/observer#readme
|
|
8
|
+
Project-URL: Issues, https://github.com/superbasedapp/observer/issues
|
|
9
|
+
Project-URL: Changelog, https://github.com/superbasedapp/observer/blob/main/CHANGELOG.md
|
|
10
|
+
Author-email: Santosh Kathira <contact@superbased.app>
|
|
11
|
+
License-Expression: Apache-2.0
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Keywords: ai,ai-coding-agent,anthropic,claude-code,claude-code-usage,codex,copilot,cost,cost-tracking,cursor,gemini-cli,llm-observability,local-first,mcp,observability,openai,prompt-caching,spend,token-usage,tokens
|
|
14
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
15
|
+
Classifier: Intended Audience :: Developers
|
|
16
|
+
Classifier: Intended Audience :: System Administrators
|
|
17
|
+
Classifier: Operating System :: MacOS
|
|
18
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
19
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
20
|
+
Classifier: Programming Language :: Python :: 3
|
|
21
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
25
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
26
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
27
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
28
|
+
Classifier: Topic :: Software Development
|
|
29
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
30
|
+
Classifier: Topic :: System :: Monitoring
|
|
31
|
+
Requires-Python: >=3.8
|
|
32
|
+
Description-Content-Type: text/markdown
|
|
33
|
+
|
|
34
|
+
# superbased-observer
|
|
35
|
+
|
|
36
|
+
<img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/mascot/obs-idle-light-512.png" alt="Obs, the SuperBased mascot: a small robot with a terminal prompt for a face and a cape" width="112" align="right">
|
|
37
|
+
|
|
38
|
+
<img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/brand/superbased-lockup-light.png" alt="SuperBased" height="32">
|
|
39
|
+
|
|
40
|
+
**Track what every AI coding agent costs. See the limit coming.** See what Claude Code, Codex,
|
|
41
|
+
Cursor and 37 more AI coding tools cost, per session and per model, from the tokens your provider
|
|
42
|
+
actually billed. Free, Apache-2.0, and it runs on your machine.
|
|
43
|
+
|
|
44
|
+
[](https://pypi.org/project/superbased-observer/)
|
|
45
|
+
[](https://pypi.org/project/superbased-observer/)
|
|
46
|
+
[](https://github.com/superbasedapp/observer/blob/main/LICENSE)
|
|
47
|
+
[](https://superbased.app/)
|
|
48
|
+
|
|
49
|
+

|
|
50
|
+
|
|
51
|
+
## Try it without installing
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
uvx --from superbased-observer observer usage
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Reads the session logs your coding agents already keep on disk, prints a 30-day cost table by tool
|
|
58
|
+
and model, and deletes its temporary database on exit. No config, no network. (The package is
|
|
59
|
+
`superbased-observer`; the command is `observer`.)
|
|
60
|
+
|
|
61
|
+
## Install
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
uv tool install superbased-observer # or: pipx install superbased-observer
|
|
65
|
+
observer --version
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Each wheel bundles its platform's prebuilt binary (manylinux2014 x86_64 and aarch64, macOS 13 or later on Intel
|
|
69
|
+
and Apple Silicon, win_amd64): no compile step, no download at install time, no Go toolchain. The
|
|
70
|
+
same binary ships on [npm](https://www.npmjs.com/package/@superbased/observer) and the
|
|
71
|
+
[VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=superbased.superbased-observer)
|
|
72
|
+
with the same version numbers; install from one channel only.
|
|
73
|
+
|
|
74
|
+
## Why SuperBased
|
|
75
|
+
|
|
76
|
+
**One local binary that tracks Claude Code token usage, Codex cost and Cursor spend side by side,
|
|
77
|
+
and helps you control them.**
|
|
78
|
+
|
|
79
|
+
- **Provider-exact cost, not estimates.** An optional local proxy records the tokens your provider
|
|
80
|
+
returned: net input, 5-minute vs 1-hour cache writes, reasoning tokens and long-context repricing.
|
|
81
|
+
- **Every coding agent in one place.** 50 adapters normalize Claude Code, Codex, Cursor, GitHub
|
|
82
|
+
Copilot, Gemini CLI, Cline, Aider, Kiro, Devin, OpenCode, Junie and more into one local database.
|
|
83
|
+
- **Local-first, no account.** No sign-in. Everything lives in one SQLite file under
|
|
84
|
+
`~/.observer/`, and your session content is never uploaded without your explicit consent.
|
|
85
|
+
- **Know the next bill before it lands.** Prompt-cache tracking with expiry warnings, a cost band
|
|
86
|
+
for your next message, and a 5-hour and weekly limit gauge for proxied sessions.
|
|
87
|
+
- **Guardrails on your own agents.** Built-in and custom rules for destructive commands, secrets
|
|
88
|
+
egress, MCP pinning and budgets. Observe mode by default; `observer guard simulate` first.
|
|
89
|
+
- **Your agents as terminals.** Launch agent CLIs from the dashboard, join a running session from a
|
|
90
|
+
paired device over your Tailscale tailnet, and hand a session from one tool to another.
|
|
91
|
+
|
|
92
|
+

|
|
93
|
+
|
|
94
|
+
## Get started
|
|
95
|
+
|
|
96
|
+
<img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/mascot/obs-celebrate-light-small.png" alt="" width="54" align="right">
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
observer start # proxy + watcher + dashboard; opens http://localhost:8081
|
|
100
|
+
observer scan # backfill history from the session logs already on disk
|
|
101
|
+
observer doctor # check the install
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
For provider-exact tokens, route your agent through the proxy: in the dashboard open Compression,
|
|
105
|
+
click your tool's status pill and choose **Route through the observer proxy** (it previews the
|
|
106
|
+
config change and writes only when you confirm), or run `observer claude` / `observer codex` for a
|
|
107
|
+
one-off proxied session. `observer init` additionally registers the opt-in MCP server.
|
|
108
|
+
|
|
109
|
+
Prefer a plain download? [superbased.app/download](https://superbased.app/download) has the
|
|
110
|
+
Windows setup program, macOS and Linux downloads and every version, with SHA-256 checksums.
|
|
111
|
+
|
|
112
|
+
**macOS needs version 13 Ventura or later.** Observer is built with Go 1.27, which no longer runs
|
|
113
|
+
on macOS 12 Monterey. On macOS 12, stay on v1.36.0 or upgrade macOS first. v1.36.0 was meant to
|
|
114
|
+
carry an advance notice of this and did not. Linux and Windows are not affected.
|
|
115
|
+
|
|
116
|
+
## What you get
|
|
117
|
+
|
|
118
|
+
- A local dashboard for sessions, cost, cache, security and live activity, filterable by tool and
|
|
119
|
+
project.
|
|
120
|
+
- Cost per session, model, project and tool, with cache read/write splits down to each API turn.
|
|
121
|
+
- An opt-in MCP server so your agents can query their own history across tools.
|
|
122
|
+
- Waste detection: stale re-reads, repeated commands and files several agents fight over.
|
|
123
|
+
- Dashboard terminals with multi-seat join and native resume.
|
|
124
|
+
- A CLI for everything: `observer usage`, `cost`, `predict`, `tail`, `statusline`.
|
|
125
|
+
|
|
126
|
+
<table>
|
|
127
|
+
<tr>
|
|
128
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/sessions.png" alt="Sessions page: one row per coding-agent session with tool, model, start time, elapsed time, actions and cost, plus tag totals" width="430"><br><sub><b>Sessions:</b> every session from every agent, with cost and tags.</sub></td>
|
|
129
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/cache.png" alt="Cache page: live prompt caches with time left before they expire, cache ratio, reads and writes, and provider coverage" width="430"><br><sub><b>Cache:</b> which prompt caches are warm and when they go cold.</sub></td>
|
|
130
|
+
</tr>
|
|
131
|
+
</table>
|
|
132
|
+
|
|
133
|
+

|
|
134
|
+
|
|
135
|
+
## Inside a session
|
|
136
|
+
|
|
137
|
+
Click any session to open its detail view. Four of its tabs:
|
|
138
|
+
|
|
139
|
+
<table>
|
|
140
|
+
<tr>
|
|
141
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/session-detail.png" alt="Session detail, Overview tab: total cost, actions, elapsed time and tokens, the action breakdown, token buckets by billing tier and the cost per model" width="430"><br><sub><b>Overview:</b> cost, tokens by billing tier and the models used.</sub></td>
|
|
142
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/session-messages.png" alt="Session detail, Messages tab: every message in the session with time, role, model, tool calls and cost" width="430"><br><sub><b>Messages:</b> each message with its model, tool calls and cost.</sub></td>
|
|
143
|
+
</tr>
|
|
144
|
+
<tr>
|
|
145
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/session-cost-and-limits-tab.png" alt="Session detail, Cost and limits tab: low, typical and high cost for the next message and the 5-hour and weekly limit" width="430"><br><sub><b>Cost & limits:</b> what the next message will cost and how much of your limit is left.</sub></td>
|
|
146
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/session-cache-tab.png" alt="Session detail, Cache tab: the session's live cache and when it expires, cache hits, writes, rewrites and the read to write ratio" width="430"><br><sub><b>Cache:</b> the session's live cache, hits, writes and rewrites.</sub></td>
|
|
147
|
+
</tr>
|
|
148
|
+
</table>
|
|
149
|
+
|
|
150
|
+
## Privacy
|
|
151
|
+
|
|
152
|
+
No account needed. Today the default install sends us no usage statistics, analytics or crash
|
|
153
|
+
reports, and your session content is never uploaded without your explicit consent. SuperBased stores
|
|
154
|
+
paths, commands and short excerpts, scrubs secrets before writing, and binds the proxy and dashboard
|
|
155
|
+
to `127.0.0.1` by default. The proxy forwards your own requests, unchanged, to the provider you
|
|
156
|
+
already use. By default SuperBased also makes a few small requests of its own that carry none of
|
|
157
|
+
your data, such as a daily download of the public model price table from superbased.app (turn it
|
|
158
|
+
off with `[pricing.feed] enabled = false`). See
|
|
159
|
+
[PRIVACY.md](https://github.com/superbasedapp/observer/blob/main/PRIVACY.md).
|
|
160
|
+
|
|
161
|
+
## Learn more
|
|
162
|
+
|
|
163
|
+
- [Documentation](https://superbased.app/docs) and [quickstart](https://superbased.app/docs/getting-started/quickstart)
|
|
164
|
+
- [Supported agents and per-tool setup](https://superbased.app/docs/track/overview)
|
|
165
|
+
- [How SuperBased compares](https://superbased.app/docs/compare/overview)
|
|
166
|
+
- [Source, issues and changelog](https://github.com/superbasedapp/observer)
|
|
167
|
+
|
|
168
|
+
## Troubleshooting
|
|
169
|
+
|
|
170
|
+
- **`externally-managed-environment` from pip:** your distro protects the system Python (PEP 668).
|
|
171
|
+
Use `uv tool install` or `pipx install`, which give the tool its own environment.
|
|
172
|
+
- **`observer: command not found`:** make sure the installer's `bin` directory (usually
|
|
173
|
+
`~/.local/bin`) is on `PATH`; `pip show -f superbased-observer` lists the exact path.
|
|
174
|
+
- **Port 8820 or 8081 already in use:** another `observer start` is running; stop it first.
|
|
175
|
+
|
|
176
|
+
## License
|
|
177
|
+
|
|
178
|
+
Apache 2.0. This package is a small Python launcher that runs the prebuilt binary bundled in the
|
|
179
|
+
wheel.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
observer/__init__.py,sha256=LXFK5DvtXudlR76CdMJciCFlLs8OYaBjGOvZ3fuqdnU,23
|
|
2
|
+
observer/__main__.py,sha256=AKI8o8RUpM6pjyBflaamsT4wdY22b8ZMaElww7z-zko,1326
|
|
3
|
+
observer/_bin/observer,sha256=ox0EQb3mAy7roFR_eM3bymojq78JYnhOBC0rUd1bxv0,112846848
|
|
4
|
+
superbased_observer-1.37.0.dist-info/METADATA,sha256=Bs9iyTYMhOTnm30WVyjCpkLr_RFYVp32K6p9BBLCAKg,11855
|
|
5
|
+
superbased_observer-1.37.0.dist-info/WHEEL,sha256=GNlTR_JWMtIYS2AZwJls-J5XErIi0Rb85gHUzvCghmc,102
|
|
6
|
+
superbased_observer-1.37.0.dist-info/entry_points.txt,sha256=OqAzYN8juNcWFLJh0Ht7_aldxTSrAvJWdXFA14eAuag,88
|
|
7
|
+
superbased_observer-1.37.0.dist-info/licenses/LICENSE,sha256=saHzyug7uLmo7N3OMLvLQvGgPOKqnlm93HmNPRqGAn4,811
|
|
8
|
+
superbased_observer-1.37.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
Copyright 2026 Gaja AI
|
|
6
|
+
|
|
7
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
8
|
+
you may not use this file except in compliance with the License.
|
|
9
|
+
You may obtain a copy of the License at
|
|
10
|
+
|
|
11
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
12
|
+
|
|
13
|
+
Unless required by applicable law or agreed to in writing, software
|
|
14
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
15
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
16
|
+
See the License for the specific language governing permissions and
|
|
17
|
+
limitations under the License.
|
|
18
|
+
|
|
19
|
+
The full text of the Apache License 2.0 is available at:
|
|
20
|
+
http://www.apache.org/licenses/LICENSE-2.0.txt
|