Skip to content
Back to search

mahonia

A hiking and backpacking gear-list / pack-weight tracker.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ryankiley/mahonia with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ryankiley/mahonia'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ryankiley--mahonia/badge.svg)](/listings/ryankiley--mahonia)

HTML

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

Install

i

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 · 179 lines
  1. # Mahonia
  2. A gear-list and pack-weight tracker for hikers. Make a packing list, see what it weighs,
  3. share it.
  4. Lists need no sign-up: one is yours the moment you start typing, held by a private
  5. unguessable link. The **gear vault** is the one part that asks for an account, because
  6. "the gear I own" has to follow you across devices rather than living in one browser.
  7. ## What it does
  8. - **Weigh a pack.** Base, worn and consumable totals, with the worn split (three pairs of
  9. socks, one on your feet) and a carried figure. Weights are optional — a list with none
  10. keeps its totals quiet.
  11. - **A curated gear catalog** behind the autocomplete, cited and correctable, with every
  12. value overridable per row.
  13. - **Per-row units.** Type `32.5 oz` on a gram list and that row keeps ounces while the
  14. total stays in grams.
  15. - **Calories** on consumables, totalled for the list.
  16. - **Trip dates**, as calendar dates — no time, no timezone, so a trip doesn't shift when
  17. you fly.
  18. - **Share two ways:** a read-only link, and an edit link for co-planning. The edit link
  19. can be replaced if it gets out.
  20. - **Packing mode** — the same list as a checklist, for the night before.
  21. - **A gear vault** that fills itself as you build, so your kit is one pick away next time.
  22. - **Import** from LighterPack (share link or CSV) or a JSON backup; **export** as CSV,
  23. JSON or Markdown.
  24. - **Recovery points**: the server keeps the last few versions of every list, so a loss
  25. past undo can still be put back.
  26. ## Run locally
  27. Requires **Node 26** (the pinned version — see `.nvmrc`).
  28. ```bash
  29. npm install
  30. npm run seed # load the gear catalog into a local database
  31. npm run dev # http://localhost:3000
  32. ```
  33. With no environment variables set, the app runs fully on your machine against a local
  34. [PGlite](https://github.com/electric-sql/pglite) database. Copy `.env.example` to `.env` to
  35. point at a real Postgres ([Neon](https://neon.tech)) and Redis ([Upstash](https://upstash.com))
  36. for a production deploy.
  37. Anything that would leave the machine degrades to the console instead of being skipped, so
  38. a fresh checkout is a working app rather than a broken one:
  39. | Unset variable | What happens locally |
  40. | --- | --- |
  41. | `RESEND_API_KEY` | Sign-in links print to the server console instead of being emailed. |
  42. | `GITHUB_FEEDBACK_TOKEN` / `_REPO` | "Send feedback" (in the editor's actions menu) prints to the console and reports back that it wasn't filed. |
  43. Both fail **loudly in production** rather than quietly accepting input that goes nowhere.
  44. ## Stack
  45. [Nuxt 4](https://nuxt.com) · Vue 3 · TypeScript · [Drizzle ORM](https://orm.drizzle.team) ·
  46. deployed on [Vercel](https://vercel.com).
  47. ## MCP connector
  48. The app serves a remote MCP server at `/mcp`, so an AI assistant can be handed
  49. `https://mahonia.app/mcp` as a connector with nothing to install. Six tools, kept few on
  50. purpose so a connector shows a short permission list. Four need no sign-in: `get_list`
  51. reads a shared list as data or Markdown, `search_catalog` searches the cited gear catalog
  52. or returns one product's variants, `create_list` makes a list, and `edit_list`, holding an
  53. edit link, makes every change to an existing one in a single call: the list's title, dates
  54. and trail, its folders, new rows (into a folder, or nested under a group), changes to the
  55. rows already there (fields, folder, place, group, and the catalog link, relinked in
  56. place), and removals. Rows nest one level deep, as the site's groups do: `get_list` shows
  57. a group as a row with items, `create_list` takes the same shape, and `edit_list` nests a
  58. row under a parent by id. `get_list` gives every row and folder an id for those edits, and
  59. reads from an edit link too, by the share code in its address. A share code is the read
  60. capability and the edit link's fragment token the write one, hashed on arrival and passed
  61. only as a tool argument, so nothing new is trusted. The transport is stateless JSON-RPC
  62. over POST (MCP revisions 2025-06-18 and 2025-11-25, no sessions, no event stream, GET
  63. answers 405), hand-rolled in `server/routes/mcp.post.ts` with the tools in
  64. `server/utils/mcp.ts`; both files carry the reasoning.
  65. Two more tools, and one more use of `get_list`, reach an **account**. `get_list` with no
  66. share code names the lists filed under it, each by its share code, so an assistant can
  67. open one without being handed a link, and with read-and-change access `edit_list` takes
  68. that share code in place of the edit link, resolved through the same claim the site uses
  69. when a signed-in owner edits a list, so the edit token still never leaves the server.
  70. `get_my_gear` and `edit_my_gear` read and change **My Gear**, and can link a piece to the
  71. catalog, as it is added or later. An account's lists and its gear belong to the account
  72. rather than a link, so
  73. these need the account behind the call, and there are two ways to give it. In Claude, add
  74. the URL as a connector and choose "Sign in when needed": the first call to an account tool
  75. shows a Connect card, you sign in to Mahonia with your passkey or a link, allow
  76. read-and-change, and the call goes through. That is OAuth 2.1 with Mahonia as its own
  77. authorization server (discovery under `/.well-known`, `/authorize`, `/token`, `/revoke`,
  78. `/register`; PKCE S256; Client ID Metadata Documents, so Claude registers nothing;
  79. hour-long access tokens with rotating refresh tokens; `server/utils/oauth.ts` and
  80. `server/utils/oauthClients.ts` carry the reasoning). A client configured from a file takes
  81. a token minted under Assistant access on `/account` instead, sent as `Authorization:
  82. Bearer <token>`. Either way only hashes are stored, the credential reaches the account's
  83. filed lists and its gear and nothing more, and it lasts until it is revoked on that page
  84. or by "Sign out everywhere". With read-and-change, `create_list` also files the list it
  85. makes under the account, as a signed-in browser files the lists it creates, and reports
  86. `saved_to_account`.
  87. The gate is at the door, as Claude requires: a `tools/call` naming an account tool with no
  88. valid bearer answers 401 with a `WWW-Authenticate` header that points at the discovery
  89. document and asks for `write` (read-and-change), whichever account tool it was: Claude asks
  90. for exactly the scope a 401 names and doesn't step up on a 403, so a sign-in that asked
  91. only for read couldn't change anything until it was connected again. A read-only bearer (a
  92. read token from `/account`) on a tool that changes gear or a list answers 403 with
  93. `insufficient_scope`. `edit_list` called with an edit link
  94. and `get_list` called with a share code are not account tools; the same tools without
  95. one are. `initialize`, `tools/list` and the four list tools never ask for a credential
  96. on their own, so a connector added with no sign-in works exactly as before.
  97. Add it to a client:
  98. [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=mahonia&config=eyJ1cmwiOiJodHRwczovL21haG9uaWEuYXBwL21jcCJ9)
  99. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=mahonia&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmahonia.app%2Fmcp%22%7D)
  100. - **Claude** (claude.ai, Desktop, mobile): [add Mahonia as a connector](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Mahonia&connectorUrl=https%3A%2F%2Fmahonia.app%2Fmcp)
  101. and choose "Sign in when needed". Lists and the catalog work at once; the first My Gear
  102. call asks you to sign in. Connectors added there are available in Claude Code too.
  103. - **Claude Code:** `claude mcp add --transport http --scope user mahonia https://mahonia.app/mcp`,
  104. then `/mcp` to sign in when a gear tool asks, or add
  105. `--header "Authorization: Bearer <token>"` to skip the sign-in with a token from `/account`
  106. (the page prints the line with your token in it).
  107. - **Gemini CLI:** `gemini mcp add --transport http mahonia https://mahonia.app/mcp` (`-H "Authorization: Bearer <token>"` for My Gear)
  108. - **ChatGPT:** Settings, Developer mode, add `https://mahonia.app/mcp` with "No Authentication".
  109. - **Anything that reads an `mcp.json`:** `{"mcpServers":{"mahonia":{"url":"https://mahonia.app/mcp"}}}`,
  110. plus `"headers":{"Authorization":"Bearer <token>"}` for My Gear.
  111. - **A client that only speaks stdio:** bridge with `npx mcp-remote https://mahonia.app/mcp`
  112. (`--header "Authorization: Bearer <token>"` for My Gear).
  113. The server is listed in the [official MCP registry](https://registry.modelcontextprotocol.io)
  114. as `app.mahonia/mahonia`; [`server.json`](server.json) is the listing, published with
  115. `mcp-publisher` under the domain's DNS proof. The registry never reads this repo, so a
  116. change to the listing reaches it only when it is published again (`mcp-publisher login dns`
  117. then `mcp-publisher publish`) once the change is on `main`; directories such as mcptry copy
  118. the registry, not the repo. Its version moves with `MCP_SERVER_INFO` in
  119. `server/utils/mcp.ts`, and a test holds the two in step.
  120. ## Changelog
  121. The changelog is [GitHub Releases](https://github.com/ryankiley/mahonia/releases): one release
  122. per day that ships something, tagged by date (`v2026.09.12`), cut by a workflow from the entries
  123. below. When a change is user-facing, add a plain one-sentence entry as part of the same PR:
  124. ```bash
  125. npm run changelog -- --added "Sort folders by weight."
  126. npm run changelog -- --fixed "…" --changed "…"
  127. ```
  128. Entries are grouped Added / Changed / Fixed and describe the observable change, not the
  129. implementation.
  130. Each run writes its own file under `content/changelog.d/`, so entries from PRs open at the
  131. same time never collide — [`content/changelog.json`](content/changelog.json) is the settled
  132. archive, and `npm run changelog:compact` folds fragments into it now and then. Once a day is
  133. over (Pacific), `.github/workflows/releases.yml` turns it into a release; a late entry updates
  134. its day's notes.
  135. A PR comment reminds any user-facing PR that's missing an entry — but nothing auto-fills it,
  136. so the entry is always hand-written (plain, curated prose). If a PR merges
  137. without one, that day's release just omits the change until it's backfilled. For non-user-facing work,
  138. prefix the PR title (`refactor:`, `chore:`, `ci:`, `test:`, `docs:`, `build:`) or label it
  139. **`skip-changelog`** — `perf:` and `style:` don't count, since both are things a visitor notices.
  140. ## License
  141. Code is [MIT](LICENSE). The gear catalog data under `seed/` is licensed separately — see
  142. [`seed/LICENSE.md`](seed/LICENSE.md).
  143. Third-party notices for the libraries bundled into the client are in
  144. [`public/licenses.txt`](public/licenses.txt), served at `/licenses.txt`. The file exists
  145. because Mahonia bundles its dependencies instead of loading them from a CDN (a CDN
  146. `<script>` could read a list's edit token out of `location.hash`), which makes serving the
  147. site a redistribution of that code — and the minifier strips the banner comments those
  148. libraries ship their copyright in. Add an entry when a dependency's code starts reaching
  149. the browser; server-only packages aren't redistributed and aren't listed.

Ratings and comments

Sign in to rate this skill.

Sign in

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