appledger 0.1.0__tar.gz

appledger-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+
+# AppLedger check output
+.appledger/
+
+# Local deploy settings (server, key, site)
+deploy/.env.local
+
+# Editors and OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db

appledger-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contenta Software
+
+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 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.

appledger-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.5
+Name: appledger
+Version: 0.1.0
+Summary: The ledger for the AI app explosion: honest security checks, in plain language, for apps your people build with AI.
+Project-URL: Homepage, https://appledger.net/
+Project-URL: Repository, https://github.com/contentasoftware/appledger
+Project-URL: Privacy, https://appledger.net/privacy.html
+Author: Contenta Software
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,codex,governance,mcp,opengrep,security,trivy,vibe-coding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4
+Requires-Dist: mcp<2,>=1.20
+Requires-Dist: packaging>=23
+Requires-Dist: pyyaml>=6
+Description-Content-Type: text/markdown
+
+# AppLedger honest check
+
+Honest security feedback, in plain language, for apps people build with AI tools such as Claude Code, Codex, Cursor and Lovable.
+
+AppLedger checks your app folder with independent scanners and explains what they find in everyday words: what is wrong, why it matters, and what to do. It also writes a fix request you can hand straight to the AI tool that built the app, then checks again.
+
+## What it checks
+
+| Scanner | Finds |
+|---|---|
+| [Trivy](https://trivy.dev) | Leaked passwords and keys, outdated libraries with known security problems, risky container setup |
+| [Opengrep](https://github.com/opengrep/opengrep) | Dangerous code patterns: SQL injection, command injection, unsafe data loading, debug mode left on |
+| SonarQube (optional, local mode) | Code quality and more security hotspots, if you already run a SonarQube server |
+
+Each run produces, in `<your-app>/.appledger/`:
+
+- `report.html`: a score, who may use the app right now (only you, your team, the whole company), and every problem in plain words
+- `fix-prompt.md`: a ready-made fix request for your coding agent
+- `findings.json`: the same findings for tools and dashboards
+
+## AI effort behind the app
+
+Every check also reports how many AI tokens went into the app and what they would cost at API list prices. It reads the coding agents' own logs on your computer (Claude Code in `~/.claude/projects`, Codex in `~/.codex/sessions`), counts sessions that ran in the app's folder, and prices each reply by model, including cache reads and writes. These logs never leave your computer. On a flat-rate plan (Claude Pro, Max or Team) you pay your plan price instead, so the figure shows the work's value at API rates.
+
+```
+python -m appledger path/to/your-app --ai-cost
+```
+
+Codex support follows Codex's documented log format and hasn't been tested against real Codex logs yet.
+
+## Two ways to run
+
+| Mode | What you install | Where your code goes |
+|---|---|---|
+| **Hosted** (default) | Only this package | Source files are zipped, sent over HTTPS to the AppLedger service, scanned and deleted right after |
+| **Local** (`--local` or `APPLEDGER_MODE=local`) | Also Trivy, Opengrep and the Opengrep rules | Nowhere: everything runs on your computer |
+
+## Use it
+
+```
+pip install appledger
+python -m appledger path/to/your-app
+```
+
+Add it to Claude Code as an MCP server:
+
+```
+claude mcp add appledger -- uvx --from appledger appledger-mcp
+```
+
+Then ask: "Is my app safe to share?" Or install the full plugin with the guided skill from `plugin/`.
+
+## Local mode setup
+
+1. Trivy: `winget install AquaSecurity.Trivy` (Windows) or `brew install trivy` (Mac)
+2. Opengrep: download from the [releases page](https://github.com/opengrep/opengrep/releases) and put it on your PATH
+3. Rules: `git clone --depth 1 https://github.com/opengrep/opengrep-rules.git ~/.appledger/opengrep-rules`
+4. Check: `python -m appledger --doctor`
+
+## Repository layout
+
+| Path | What |
+|---|---|
+| `src/appledger/scanner.py` | Scanners, plain-language translation, report and fix request |
+| `src/appledger/client.py` | Sends a project to the hosted service |
+| `src/appledger/service.py` | Server side: unpacks an upload safely and scans it |
+| `src/appledger/server.py` | Local MCP server used by the plugin |
+| `plugin/` | Claude Code / Codex plugin with the `check-my-app` skill |
+| `tests/mcp_smoke.py` | Calls every MCP tool like an agent would |
+
+## License
+
+MIT. The Opengrep community rules used by the scanner have their own license (Commons Clause); check it before using them in a paid service.

appledger-0.1.0/README.md

@@ -0,0 +1,73 @@
+# AppLedger honest check
+
+Honest security feedback, in plain language, for apps people build with AI tools such as Claude Code, Codex, Cursor and Lovable.
+
+AppLedger checks your app folder with independent scanners and explains what they find in everyday words: what is wrong, why it matters, and what to do. It also writes a fix request you can hand straight to the AI tool that built the app, then checks again.
+
+## What it checks
+
+| Scanner | Finds |
+|---|---|
+| [Trivy](https://trivy.dev) | Leaked passwords and keys, outdated libraries with known security problems, risky container setup |
+| [Opengrep](https://github.com/opengrep/opengrep) | Dangerous code patterns: SQL injection, command injection, unsafe data loading, debug mode left on |
+| SonarQube (optional, local mode) | Code quality and more security hotspots, if you already run a SonarQube server |
+
+Each run produces, in `<your-app>/.appledger/`:
+
+- `report.html`: a score, who may use the app right now (only you, your team, the whole company), and every problem in plain words
+- `fix-prompt.md`: a ready-made fix request for your coding agent
+- `findings.json`: the same findings for tools and dashboards
+
+## AI effort behind the app
+
+Every check also reports how many AI tokens went into the app and what they would cost at API list prices. It reads the coding agents' own logs on your computer (Claude Code in `~/.claude/projects`, Codex in `~/.codex/sessions`), counts sessions that ran in the app's folder, and prices each reply by model, including cache reads and writes. These logs never leave your computer. On a flat-rate plan (Claude Pro, Max or Team) you pay your plan price instead, so the figure shows the work's value at API rates.
+
+```
+python -m appledger path/to/your-app --ai-cost
+```
+
+Codex support follows Codex's documented log format and hasn't been tested against real Codex logs yet.
+
+## Two ways to run
+
+| Mode | What you install | Where your code goes |
+|---|---|---|
+| **Hosted** (default) | Only this package | Source files are zipped, sent over HTTPS to the AppLedger service, scanned and deleted right after |
+| **Local** (`--local` or `APPLEDGER_MODE=local`) | Also Trivy, Opengrep and the Opengrep rules | Nowhere: everything runs on your computer |
+
+## Use it
+
+```
+pip install appledger
+python -m appledger path/to/your-app
+```
+
+Add it to Claude Code as an MCP server:
+
+```
+claude mcp add appledger -- uvx --from appledger appledger-mcp
+```
+
+Then ask: "Is my app safe to share?" Or install the full plugin with the guided skill from `plugin/`.
+
+## Local mode setup
+
+1. Trivy: `winget install AquaSecurity.Trivy` (Windows) or `brew install trivy` (Mac)
+2. Opengrep: download from the [releases page](https://github.com/opengrep/opengrep/releases) and put it on your PATH
+3. Rules: `git clone --depth 1 https://github.com/opengrep/opengrep-rules.git ~/.appledger/opengrep-rules`
+4. Check: `python -m appledger --doctor`
+
+## Repository layout
+
+| Path | What |
+|---|---|
+| `src/appledger/scanner.py` | Scanners, plain-language translation, report and fix request |
+| `src/appledger/client.py` | Sends a project to the hosted service |
+| `src/appledger/service.py` | Server side: unpacks an upload safely and scans it |
+| `src/appledger/server.py` | Local MCP server used by the plugin |
+| `plugin/` | Claude Code / Codex plugin with the `check-my-app` skill |
+| `tests/mcp_smoke.py` | Calls every MCP tool like an agent would |
+
+## License
+
+MIT. The Opengrep community rules used by the scanner have their own license (Commons Clause); check it before using them in a paid service.

appledger-0.1.0/plugin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contenta Software
+
+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 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.

appledger-0.1.0/plugin/README.md

@@ -0,0 +1,26 @@
+# AppLedger honest check (plugin)
+
+Honest security checks, in plain language, for apps you build with AI in Claude Code or Codex.
+
+Ask your agent "Is my app safe to share?" and AppLedger checks your project with independent scanners: Trivy for leaked keys, outdated libraries and risky container setup, and Opengrep for dangerous code patterns such as SQL injection or command injection. Your agent then explains each problem in everyday words, offers to fix it, and checks again so you can see the score improve.
+
+Nothing to install besides the plugin: the scanners run on the AppLedger service.
+
+## Data handling
+
+**When you run a check, your project's source files are uploaded to the AppLedger scanning service** at `appledger.net` over HTTPS. Dependencies, build output, media and files over 1 MB are left out. The upload is scanned and deleted right after; we keep no copy of your code. We log only the time, a one-way hash of your IP address, the upload size, how long the check took and whether it succeeded.
+
+Results are written to a `.appledger/` folder inside your project, which is excluded from version control.
+
+Prefer to keep everything on your computer? Set `APPLEDGER_MODE=local` and install [Trivy](https://trivy.dev) and [Opengrep](https://github.com/opengrep/opengrep/releases) yourself.
+
+## Requirements
+
+- Python 3.10+ and [uv](https://docs.astral.sh/uv/) (the plugin starts its local MCP server with `uvx`)
+
+## What's included
+
+- `check-my-app` skill: runs the check, explains it, fixes problems with your permission and checks again
+- `appledger` MCP server with four tools: `check_app`, `get_fix_prompt`, `ai_cost` (AI tokens and cost behind the app, read from your local Claude Code and Codex logs, never uploaded), `scanner_status`
+
+More: https://appledger.net/

appledger-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "appledger"
+version = "0.1.0"
+description = "The ledger for the AI app explosion: honest security checks, in plain language, for apps your people build with AI."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [{ name = "Contenta Software" }]
+keywords = ["security", "mcp", "claude", "codex", "trivy", "opengrep", "vibe-coding", "governance"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Security",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "mcp>=1.20,<2",
+    "pyyaml>=6",
+    "packaging>=23",
+    "anyio>=4",
+]
+
+[project.urls]
+Homepage = "https://appledger.net/"
+Repository = "https://github.com/contentasoftware/appledger"
+Privacy = "https://appledger.net/privacy.html"
+
+[project.scripts]
+appledger = "appledger.scanner:main"
+appledger-mcp = "appledger.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/appledger"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/appledger", "README.md", "LICENSE", "pyproject.toml"]

appledger-0.1.0/src/appledger/__init__.py

@@ -0,0 +1,6 @@
+"""AppLedger honest check: security feedback in plain language for apps built with AI."""
+
+from .scanner import ScanError, check, doctor
+
+__version__ = "0.1.0"
+__all__ = ["ScanError", "check", "doctor", "__version__"]

appledger-0.1.0/src/appledger/__main__.py

@@ -0,0 +1,3 @@
+from .scanner import main
+
+main()

appledger-0.1.0/src/appledger/client.py

@@ -0,0 +1,78 @@
+"""Send a project to the hosted AppLedger scanning service and get the findings back.
+
+The project is zipped (without dependencies, build output, media or other large files),
+sent over HTTPS, scanned with Trivy and Opengrep, and deleted on the server right after.
+"""
+
+import io
+import json
+import os
+import uuid
+import urllib.error
+import urllib.request
+import zipfile
+from pathlib import Path
+
+from . import __version__
+from .scanner import ScanError, app_files
+
+API_URL = os.environ.get("APPLEDGER_API", "https://appledger.net/api/check.php")
+MAX_FILE_BYTES = 1_000_000
+MAX_ZIP_BYTES = 10_000_000
+SKIP_SUFFIXES = {
+    ".png", ".jpg", ".jpeg", ".gif", ".webp", ".ico", ".svg", ".mp4", ".mov", ".mp3", ".wav", ".pdf",
+    ".zip", ".gz", ".tgz", ".7z", ".rar", ".exe", ".dll", ".so", ".dylib", ".bin", ".class", ".jar",
+    ".pyc", ".db", ".sqlite", ".sqlite3", ".woff", ".woff2", ".ttf", ".otf", ".psd", ".xlsx", ".docx",
+}
+
+
+def build_zip(app_dir):
+    """Zip the files the scanners need. Returns (zip bytes, number of files, skipped files)."""
+    app_dir = Path(app_dir)
+    buf = io.BytesIO()
+    count, skipped = 0, []
+    with zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) as zf:
+        for path in sorted(app_files(app_dir)):
+            rel = path.relative_to(app_dir).as_posix()
+            if path.suffix.lower() in SKIP_SUFFIXES or path.is_symlink():
+                continue
+            if path.stat().st_size > MAX_FILE_BYTES:
+                skipped.append(rel)
+                continue
+            zf.write(path, rel)
+            count += 1
+    data = buf.getvalue()
+    if count == 0:
+        raise ScanError(f"No files to check in {app_dir}.")
+    if len(data) > MAX_ZIP_BYTES:
+        raise ScanError(f"The project is too big to send ({len(data) // 1_000_000} MB after compression, "
+                        f"limit {MAX_ZIP_BYTES // 1_000_000} MB). Check a smaller folder, or use local mode.")
+    return data, count, skipped
+
+
+def hosted_scan(app_dir):
+    """Returns (findings, scanner names) from the AppLedger service."""
+    data, count, skipped = build_zip(app_dir)
+    boundary = uuid.uuid4().hex
+    body = (f"--{boundary}\r\nContent-Disposition: form-data; name=\"project\"; filename=\"project.zip\"\r\n"
+            f"Content-Type: application/zip\r\n\r\n").encode() + data + f"\r\n--{boundary}--\r\n".encode()
+    req = urllib.request.Request(API_URL, data=body, method="POST", headers={
+        "Content-Type": f"multipart/form-data; boundary={boundary}",
+        "Accept": "application/json",
+        "User-Agent": f"appledger/{__version__}",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=180) as resp:
+            result = json.load(resp)
+    except urllib.error.HTTPError as e:
+        try:
+            message = json.load(e).get("error", "")
+        except (ValueError, AttributeError):
+            message = ""
+        raise ScanError(message or f"The AppLedger service answered with an error ({e.code}). Try again later.")
+    except (urllib.error.URLError, TimeoutError) as e:
+        raise ScanError(f"Couldn't reach the AppLedger service ({getattr(e, 'reason', e)}). "
+                        "Check your internet connection, or run in local mode.")
+    if not result.get("ok"):
+        raise ScanError(result.get("error", "The AppLedger service couldn't check this project."))
+    return result["findings"], result["scanners"]