Skip to content
Back to search

receipts

A research desk that only quotes what it fetched. No model, no API key.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shattradingle--receipts/badge.svg)](/listings/shattradingle--receipts)

HTML

<a href="/listings/shattradingle--receipts"><img src="/api/listings/shattradingle--receipts/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Python 3.10 or newer. Standard library only, no key, no account.

# no install, straight from git
$ uvx --from git+https://github.com/shattradingle/receipts receipts research "why do AI coding agents waste context window" --sources hn,news --depth 1
receipts · why do AI coding agents waste context window
2026-11-21T15:25:16Z · 20 quotes · 12 pages ok / 0 blocked · 2 queries · 6.1s

THEMES
  agents (8)
  coding (7)
  context (7)
  code (6)
  codex (3)
  terminal (3)

QUOTES
  "A GitHub bot on SelfBench: every pull request that changes your docs gets agents running your tasks with the old docs and with the new ones."
  — github.com · 2026-05-20 · via “why do AI coding agents waste context window”
…

# or a normal install, then the desk
$ git clone https://github.com/shattradingle/receipts && cd receipts
$ python3 -m venv .venv && . .venv/bin/activate && pip install .
$ receipts demo
receipts demo → http://127.0.0.1:8788/

The board is also JSON (`--json`), and `--out DIR` writes `board.json`, `board.md` and a self-contained `board.html`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 185 lines
  1. ![receipts](docs/banner.svg)
  2. # receipts
  3. **A research desk that cannot hallucinate: quotes with URLs, dates and receipts.**
  4. [Quick start](#quick-start) · [Commands](#commands) · [MCP](#mcp) · [How it works](docs/architecture.md) · [Limits](#limits) · [Changelog](CHANGELOG.md)
  5. [![ci](https://github.com/shattradingle/receipts/actions/workflows/ci.yml/badge.svg)](https://github.com/shattradingle/receipts/actions/workflows/ci.yml)
  6. [![release](https://img.shields.io/github/v/release/shattradingle/receipts?display_name=tag)](https://github.com/shattradingle/receipts/releases)
  7. [![licence: MIT](https://img.shields.io/badge/licence-MIT-8a1f11.svg)](LICENSE)
  8. [![python 3.10–3.13](https://img.shields.io/badge/python-3.10--3.13-161616.svg)](pyproject.toml)
  9. <sub>Part of the keyless stack — public data for agents, with receipts. No API key anywhere.</sub>
  10. **[Open the live demo](https://shattradingle.github.io/receipts/)** (a real board, no server, no network).
  11. Ask it a question and it searches six free sources, fetches the pages, and hands back a board of sentences that were already written there. There is no model in the loop, so there is nothing to hallucinate. Every quote keeps its source URL, its date and the query that found it.
  12. <sub>Six keyless adapters. 121 tests, all offline. Zero runtime dependencies.</sub>
  13. ## Quick start
  14. Python 3.10 or newer. Standard library only, no key, no account.
  15. ```console
  16. # no install, straight from git
  17. $ uvx --from git+https://github.com/shattradingle/receipts receipts research "why do AI coding agents waste context window" --sources hn,news --depth 1
  18. receipts · why do AI coding agents waste context window
  19. 2026-11-21T15:25:16Z · 20 quotes · 12 pages ok / 0 blocked · 2 queries · 6.1s
  20. THEMES
  21. agents (8)
  22. coding (7)
  23. context (7)
  24. code (6)
  25. codex (3)
  26. terminal (3)
  27. QUOTES
  28. "A GitHub bot on SelfBench: every pull request that changes your docs gets agents running your tasks with the old docs and with the new ones."
  29. — github.com · 2026-05-20 · via “why do AI coding agents waste context window”
  30. …
  31. # or a normal install, then the desk
  32. $ git clone https://github.com/shattradingle/receipts && cd receipts
  33. $ python3 -m venv .venv && . .venv/bin/activate && pip install .
  34. $ receipts demo
  35. receipts demo → http://127.0.0.1:8788/
  36. ```
  37. The board is also JSON (`--json`), and `--out DIR` writes `board.json`, `board.md` and a self-contained `board.html`.
  38. ## See it work
  39. The desk, with a real baked board, no network:
  40. ```console
  41. $ receipts demo
  42. receipts demo → http://127.0.0.1:8788/
  43. Ctrl-C to stop.
  44. ```
  45. If port 8788 is taken, add `--port 8790`.
  46. ![The receipts desk showing 33 quotes, 16 sources, one blocked Forbes page and the themes column](docs/screenshots/desk-light.png)
  47. The demo board is a real run from 2026-11-21: 33 quotes, 15 pages ok, one blocked page, 15 queries, 8.2 seconds, five source kinds. The blocked Forbes page is in Coverage with its 403. Nothing on that board was written for it. The layout stacks below 900px ([mobile view](docs/screenshots/desk-mobile.png)), and `?theme=dark` or `?theme=light` overrides the system theme.
  48. To make the same kind of static file, with no server at all (take the id from `receipts list`):
  49. ```console
  50. $ receipts export <run_id> --html --out board.html
  51. ```
  52. ## Who this is for
  53. | you are | start here |
  54. | --- | --- |
  55. | you have an agent and want evidence it can read | [MCP](#mcp); two tools, one of them runs a board |
  56. | you want a CLI and a JSON file | [Commands](#commands) and `--json` |
  57. | you want to see it before installing | `receipts demo` or the [screenshot](docs/screenshots/desk-light.png) |
  58. ## Commands
  59. | command | what it does |
  60. | --- | --- |
  61. | `receipts serve` | the desk at `http://127.0.0.1:8787` |
  62. | `receipts demo` | a baked board at `http://127.0.0.1:8788`, no network |
  63. | `receipts research "question"` | run the pipeline; `--sources`, `--depth 1\|2\|3`, `--max-pages`, `--json`, `--out DIR` |
  64. | `receipts board <run_id>` | print a stored board; `--json` |
  65. | `receipts list` | recent runs, newest first |
  66. | `receipts export <run_id> --md\|--html --out FILE` | write a board |
  67. | `receipts mcp` | stdio MCP server |
  68. | `receipts --version` | `receipts 1.0.0` |
  69. Exit codes: `0` ok, `1` nothing found, `2` nothing could be fetched, `64` usage.
  70. State lives at `${XDG_STATE_HOME:-~/.local/state}/receipts/receipts.db`, or under `$RECEIPTS_HOME`. `pip install .` is the whole install.
  71. ## MCP
  72. Point a client at the stdio server:
  73. ```json
  74. {
  75. "mcpServers": {
  76. "receipts": {
  77. "command": "receipts",
  78. "args": ["mcp"]
  79. }
  80. }
  81. }
  82. ```
  83. | tool | arguments | returns |
  84. | --- | --- | --- |
  85. | `receipts_research` | `question`, optional `sources`, optional `depth` | the board as JSON, plus a compact text block |
  86. | `receipts_export` | `run_id`, optional `fmt` (`md`, `html`, `json`) | the path of the written file |
  87. Importing the package makes no network request. `receipts mcp` writes JSON-RPC lines to stdout and nothing else.
  88. ## How it works
  89. ```
  90. expand → search (6 sources) → dedupe → select pages → fetch
  91. → extract main text → quote 20–45 words → theme → SQLite + board
  92. ```
  93. The parts that matter:
  94. - **Verbatim quotes.** Sentences are sliced from the extracted page text. No splicing, no paraphrase. A sentence over 45 words is cut at a word boundary and marked with an ellipsis; a sentence under 20 is skipped.
  95. - **Deterministic board.** For the same fetched pages, same source ids, quote ids, order, scores and themes. No randomness in the pipeline.
  96. - **Failures are output.** A 403, a timeout, a page with no text: each one becomes a status row and a failure entry. A block is never treated as an absence.
  97. - **No model, no key.** Six keyless adapters, `urllib.request`, `html.parser`, `sqlite3`, `http.server`. `tests/test_no_network.py` enforces the host allowlist and the missing dependency list.
  98. - **The desk is three files.** No build step, no CDN, no font request, no image other than the wordmark drawn in CSS.
  99. The full pipeline, source decisions and measured live outcomes are in [docs/architecture.md](docs/architecture.md).
  100. ## What is different
  101. | feature | receipts | a deep-research agent | why it matters |
  102. | --- | --- | --- | --- |
  103. | output | quotes with URL, date and query | a written answer | you can check every sentence against its source |
  104. | model | none | an LLM | no key, no bill, no drift between runs |
  105. | failure handling | every block listed with a reason | often a shorter answer | a missing source looks like a missing source |
  106. | speed | 6 to 30 seconds for a board | minutes | useful while narrowing a question |
  107. | synthesis | none, by design | better | it is worse when you want one readable answer |
  108. ## Limits
  109. Measured on 2026-11-21 from one Linux machine through a logging proxy. These are the things that break, not a roadmap.
  110. | source | live result on 2026-11-21 (final demo run) | in the demo |
  111. | --- | --- | --- |
  112. | web | Bing answered 200. Every organic link is a `/ck/a?u=a1…` redirect, which the adapter decodes; it produced **4 pages, 11 quotes**. Relevance is still the weakest of the five: the same query on an earlier run gave generic results, and Mojeek returned 403. | yes |
  113. | news | **3 pages (2 ok, 1 blocked), 6 quotes**. The blocked Forbes page is in Coverage with its 403. Google News links are JavaScript redirects, so the Bing News RSS fallback supplies the publisher URLs. | yes |
  114. | hn | **3 pages, 4 quotes**. | yes |
  115. | wiki | **3 pages, 4 quotes**. It drifts on a very specific question (Omarchy, Chemotherapy, GLM). | yes |
  116. | arxiv | **3 abstracts, 8 quotes**. PDFs are not read. | yes |
  117. | reddit | Not in the baked board: a 12-sub fan-out hits the archive's throttle, and the build shell's research rail forbids raw archive calls. The adapter is fixture-tested and best effort. | no |
  118. More limits:
  119. - **No JavaScript rendering.** Pages that need a browser are `thin` or `empty`. That is common with news sites and single-page apps.
  120. - **Web search is the weak source.** The HTML parser is fine; the results from this IP were not. A blocked or useless web source is recorded, not retried forever.
  121. - **Reddit is best effort.** arctic-shift allows a keyword query only when scoped to a subreddit, so one search is 12 scoped requests and some will be blocked. Expect `blocked` rows on a busy day.
  122. - **Quotes are 20 to 45 words.** A page of brilliant six-word sentences contributes nothing. That is the price of a rule you can check.
  123. - **No relevance model.** Page selection ranks by question-term hits and sources round-robin; it does not understand the question. An off-topic page can still be fetched. It is listed as a source, not hidden.
  124. - **The demo is five sources, not six.** It uses `web,news,hn,wiki,arxiv` at depth 2: every source that answered from a normal connection produced at least four quotes. Reddit is the sixth adapter and is not in the baked board, because the archive throttles a 12-sub fan-out; the adapter is fixture-tested and listed as best effort above.
  125. - **Not a synthesis tool.** If you want an answer written for you, this is the wrong tool. It gives you the material to write one.
  126. - **The web changes.** Determinism is over the fetched pages. The same question tomorrow can return a different board.
  127. - **Local state only.** No account, no sync, no cloud. `RECEIPTS_HOME` moves the database and exports.
  128. ## Part of the keyless stack
  129. Public data for agents, with receipts. No API key anywhere:
  130. - **[reddit-rail](https://github.com/shattradingle/reddit-rail)** — Reddit research for your agent: search threads and read whole comment trees.
  131. - **[osint-rail](https://github.com/shattradingle/osint-rail)** — one seed in, a sourced dossier out, every claim with its URL.
  132. - **[receipts](https://github.com/shattradingle/receipts)** — a research desk that only quotes what it fetched.
  133. ## Changelog
  134. See [CHANGELOG.md](CHANGELOG.md). MIT licence.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.