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 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,4 @@
1
+ [diffend] Oversized file quarantined before diffing.
2
+ name: observer/_bin/observer
3
+ size: 112846848 bytes
4
+ sha256: a31d0441bde6032eeba0547f78cddbca6a23abbf0962784e042d2b51dd5bc6fd
@@ -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
+ [![PyPI](https://img.shields.io/pypi/v/superbased-observer.svg)](https://pypi.org/project/superbased-observer/)
45
+ [![Python: 3.8+](https://img.shields.io/pypi/pyversions/superbased-observer.svg)](https://pypi.org/project/superbased-observer/)
46
+ [![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/superbasedapp/observer/blob/main/LICENSE)
47
+ [![Website](https://img.shields.io/badge/website-superbased.app-2EC4B6.svg)](https://superbased.app/)
48
+
49
+ ![Session detail in the SuperBased dashboard: total cost, a low, typical and high cost for the next message, the 5-hour and weekly limit, and the cost of switching to a cheaper model](https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/session-cost-and-limits.png)
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
+ ![Overview page of the SuperBased dashboard: 30-day spend, sessions, actions and proxy-accurate API turns, cache efficiency, cost over time by billing bucket and actions over time by coding tool](https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/overview-dashboard.png)
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
+ ![Terminals page: Claude Code, Codex, Antigravity CLI and Copilot CLI running side by side as live terminals in one dashboard](https://raw.githubusercontent.com/superbasedapp/observer/main/docs/assets/screenshots/terminals-workspace.png)
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 &amp; 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,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.33.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-macosx_13_0_arm64
5
+
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ observer = observer.__main__:main
3
+ superbased = observer.__main__:main
@@ -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