tony-cli 0.3.0__tar.gz

tony_cli-0.3.0/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Fawwaz Abayomi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+The ABC Favorit and ABC Favorit Mono font files under src/tony_cli/assets/fonts
+are commercial typefaces by Dinamo and are NOT covered by this license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tony_cli-0.3.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: tony-cli
+Version: 0.3.0
+Summary: Explains a git diff to whoever now owns it — annotated changes, blast radius, and steppable runtime walkthroughs.
+Author: Fawwaz Abayomi
+License: MIT License
+        
+        Copyright (c) 2026 Fawwaz Abayomi
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        The ABC Favorit and ABC Favorit Mono font files under src/tony_cli/assets/fonts
+        are commercial typefaces by Dinamo and are NOT covered by this license.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/fawwaz46/tony
+Project-URL: Issues, https://github.com/fawwaz46/tony/issues
+Keywords: git,diff,code-review,ai,claude
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.40
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: cryptography>=42
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# tony
+
+**Your AI wrote the code. tony explains what now exists.**
+
+tony is a CLI that turns a git diff into a review page for the person who now
+owns the code — often someone who didn't type a line of it. Not a linter, not a
+code-review gate: it builds your mental model of the change, fast.
+
+Every review page has three tabs:
+
+1. **File changes** — the diff per file, with plain-language annotations sitting
+   inline above the lines they explain. Modified code gets Prev / New / Changes
+   panes; line numbers are computed from the diff, never trusted to the model.
+2. **Blast radius** — files the change reaches that are *not* in the diff, each
+   consumer classified breaks / behavior-change / compatible, shown at the
+   affected lines.
+3. **How it works** — steppable runtime walkthroughs. One concrete scenario
+   ("you run `export --resume` after a crash") traced step by step, showing the
+   real source lines read from your disk, a small state table, and one plain
+   sentence per step.
+
+## Install
+
+```sh
+curl -fsSL https://tony-cli.com/install.sh | sh
+```
+
+or, if you already use uv or pipx:
+
+```sh
+uv tool install tony-cli     # or: pipx install tony-cli
+```
+
+Either way you get a `tony` command on your PATH.
+
+## Use
+
+```sh
+cd your-repo
+tony main...my-branch        # review a branch against main
+tony                         # review the default branch...HEAD
+```
+
+The page is written to `.tony/` inside the repo (gitignored automatically) and
+opens in your browser. It's one self-contained HTML file — fonts, styles, and
+data inlined — so it works offline and forever.
+
+tony needs an Anthropic API key (`ANTHROPIC_API_KEY`, or `~/.tony/.env`). The
+first run tells you exactly where to get one and where to put it. tony reviews
+**committed** work: it shows code straight from disk, so the working tree must
+match the revision under review.
+
+Useful flags: `--replay` rebuilds the page from the last run without calling
+the API, `--json` prints the raw review, `-v` logs every file the model
+actually read, `--stale` overrides the clean-tree check.
+
+## Share a review
+
+```sh
+tony login                   # once — GitHub device flow
+tony main...my-branch        # publishing is the default
+tony: https://tony-cli.com/r/8f3ka92m
+```
+
+**Who can read a published review:** anyone signed in who has the link. Review
+ids are random, so the link is what grants access — treat it like a password.
+`tony unpublish <id>` removes a review at any time.
+
+**What the site can read:** everything in the review. The payload is uploaded
+over TLS and encrypted at rest under a key the server holds, so a leak of the
+stored blobs yields nothing — but we can open a review, and so can any lawful
+demand made to us. Do not publish from a repository you could not share with
+us. An earlier design encrypted on your machine and kept the key in the link's
+fragment; that was dropped deliberately when reading moved behind an account
+and a history of past reviews became part of the product, since both need the
+server to be able to open a review.
+
+Local review needs no account and never leaves the machine: `tony --local`.
+
+## Update
+
+```sh
+tony update
+```
+
+Uses whichever of uv, pipx, or pip installed tony, and resolves from PyPI
+explicitly so a machine pointed at an internal mirror cannot decide what
+`tony-cli` is. `tony --version` says what you have; `tony --help` lists every
+command.
+
+## Uninstall
+
+```sh
+tony uninstall
+```
+
+Removing the package by itself would leave the parts worth removing: your
+`ANTHROPIC_API_KEY` and site login in `~/.tony`, and a `.tony/` directory of
+past reviews inside every repository you ran tony in — those hold source code.
+`tony uninstall` revokes the site token, lists everything it found and waits
+for you to type `yes`, deletes it, then removes the package with whichever of
+uv, pipx, or pip installed it.
+
+It searches your home directory for stray review directories; `--no-scan`
+limits it to the current repository, and `--yes` skips the prompt. Reviews you
+published to the site are separate — take those down with `tony unpublish <id>`
+before uninstalling, or they stay up.
+
+## Development
+
+```sh
+pip install -e ".[dev]"      # the CLI, with pytest
+python -m pytest             # the deterministic layer's tests
+cd web && npm install
+npm run build:viewer         # rebuild the renderer bundle the CLI embeds
+npm run dev                  # the site; /dev renders src/fixtures/review.json
+```
+
+There is exactly one renderer — `web/src/renderer/render.ts` — used by both
+the local page and the hosted site. The Python side decides all layout facts
+(line numbers, spans, added/changed tags) in `src/tony_cli/layout.py` and ships
+them in the payload; the renderer never re-derives them. `DESIGN.md` is the
+visual contract.
+
+The site deploys to Vercel and needs `DATABASE_URL` (Neon Postgres),
+`BLOB_READ_WRITE_TOKEN` (Vercel Blob), and `GITHUB_CLIENT_ID` (an OAuth app
+with device flow enabled).

tony_cli-0.3.0/README.md

@@ -0,0 +1,127 @@
+# tony
+
+**Your AI wrote the code. tony explains what now exists.**
+
+tony is a CLI that turns a git diff into a review page for the person who now
+owns the code — often someone who didn't type a line of it. Not a linter, not a
+code-review gate: it builds your mental model of the change, fast.
+
+Every review page has three tabs:
+
+1. **File changes** — the diff per file, with plain-language annotations sitting
+   inline above the lines they explain. Modified code gets Prev / New / Changes
+   panes; line numbers are computed from the diff, never trusted to the model.
+2. **Blast radius** — files the change reaches that are *not* in the diff, each
+   consumer classified breaks / behavior-change / compatible, shown at the
+   affected lines.
+3. **How it works** — steppable runtime walkthroughs. One concrete scenario
+   ("you run `export --resume` after a crash") traced step by step, showing the
+   real source lines read from your disk, a small state table, and one plain
+   sentence per step.
+
+## Install
+
+```sh
+curl -fsSL https://tony-cli.com/install.sh | sh
+```
+
+or, if you already use uv or pipx:
+
+```sh
+uv tool install tony-cli     # or: pipx install tony-cli
+```
+
+Either way you get a `tony` command on your PATH.
+
+## Use
+
+```sh
+cd your-repo
+tony main...my-branch        # review a branch against main
+tony                         # review the default branch...HEAD
+```
+
+The page is written to `.tony/` inside the repo (gitignored automatically) and
+opens in your browser. It's one self-contained HTML file — fonts, styles, and
+data inlined — so it works offline and forever.
+
+tony needs an Anthropic API key (`ANTHROPIC_API_KEY`, or `~/.tony/.env`). The
+first run tells you exactly where to get one and where to put it. tony reviews
+**committed** work: it shows code straight from disk, so the working tree must
+match the revision under review.
+
+Useful flags: `--replay` rebuilds the page from the last run without calling
+the API, `--json` prints the raw review, `-v` logs every file the model
+actually read, `--stale` overrides the clean-tree check.
+
+## Share a review
+
+```sh
+tony login                   # once — GitHub device flow
+tony main...my-branch        # publishing is the default
+tony: https://tony-cli.com/r/8f3ka92m
+```
+
+**Who can read a published review:** anyone signed in who has the link. Review
+ids are random, so the link is what grants access — treat it like a password.
+`tony unpublish <id>` removes a review at any time.
+
+**What the site can read:** everything in the review. The payload is uploaded
+over TLS and encrypted at rest under a key the server holds, so a leak of the
+stored blobs yields nothing — but we can open a review, and so can any lawful
+demand made to us. Do not publish from a repository you could not share with
+us. An earlier design encrypted on your machine and kept the key in the link's
+fragment; that was dropped deliberately when reading moved behind an account
+and a history of past reviews became part of the product, since both need the
+server to be able to open a review.
+
+Local review needs no account and never leaves the machine: `tony --local`.
+
+## Update
+
+```sh
+tony update
+```
+
+Uses whichever of uv, pipx, or pip installed tony, and resolves from PyPI
+explicitly so a machine pointed at an internal mirror cannot decide what
+`tony-cli` is. `tony --version` says what you have; `tony --help` lists every
+command.
+
+## Uninstall
+
+```sh
+tony uninstall
+```
+
+Removing the package by itself would leave the parts worth removing: your
+`ANTHROPIC_API_KEY` and site login in `~/.tony`, and a `.tony/` directory of
+past reviews inside every repository you ran tony in — those hold source code.
+`tony uninstall` revokes the site token, lists everything it found and waits
+for you to type `yes`, deletes it, then removes the package with whichever of
+uv, pipx, or pip installed it.
+
+It searches your home directory for stray review directories; `--no-scan`
+limits it to the current repository, and `--yes` skips the prompt. Reviews you
+published to the site are separate — take those down with `tony unpublish <id>`
+before uninstalling, or they stay up.
+
+## Development
+
+```sh
+pip install -e ".[dev]"      # the CLI, with pytest
+python -m pytest             # the deterministic layer's tests
+cd web && npm install
+npm run build:viewer         # rebuild the renderer bundle the CLI embeds
+npm run dev                  # the site; /dev renders src/fixtures/review.json
+```
+
+There is exactly one renderer — `web/src/renderer/render.ts` — used by both
+the local page and the hosted site. The Python side decides all layout facts
+(line numbers, spans, added/changed tags) in `src/tony_cli/layout.py` and ships
+them in the payload; the renderer never re-derives them. `DESIGN.md` is the
+visual contract.
+
+The site deploys to Vercel and needs `DATABASE_URL` (Neon Postgres),
+`BLOB_READ_WRITE_TOKEN` (Vercel Blob), and `GITHUB_CLIENT_ID` (an OAuth app
+with device flow enabled).

tony_cli-0.3.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "tony-cli"
+version = "0.3.0"
+description = "Explains a git diff to whoever now owns it — annotated changes, blast radius, and steppable runtime walkthroughs."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [{ name = "Fawwaz Abayomi" }]
+keywords = ["git", "diff", "code-review", "ai", "claude"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "anthropic>=0.40",
+    "python-dotenv>=1.0",
+    "httpx>=0.27",
+    "cryptography>=42",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.urls]
+Homepage = "https://github.com/fawwaz46/tony"
+Issues = "https://github.com/fawwaz46/tony/issues"
+
+[project.scripts]
+tony = "tony_cli.agent:main"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["tony_cli*"]
+
+[tool.setuptools.package-data]
+tony_cli = ["assets/fonts/*.woff2", "assets/viewer.js", "assets/viewer.css"]
+
+[tool.pytest.ini_options]
+testpaths = ["src/tests"]

tony_cli-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+