Repository navigation
ArghBox 0.1.0
The first public version.
Added
- Widget: a Feedback tab (loader under 4 KB gzipped) and a dialog loaded on first intent, with a public list, voting, search, tag filters, statuses, owner comments, an add form with similar-entry suggestions, and "Your arghs". Shadow DOM, light and dark themes, a full-screen sheet on phones, keyboard and screen-reader support, funny and neutral wording, translatable strings, and a JavaScript API with
#arghboxlinks. - Backend: a PHP 8.1+ and SQLite API for shared hosting from one folder. Cloudflare Turnstile, hashed IPs and voter keys, rate limits, honeypot, CORS allow-list and an Atom feed. No visitor cookies.
- Health check (
api.php?action=health): version, database location, Turnstile and proxy-header state, and awarningslist for the owner. It does not warn that the IP header is ignored when the web server has already put the visitor's address inREMOTE_ADDR(LiteSpeed on Hostinger behind Cloudflare). - Admin page: statuses, public comments and private notes, private owner tasks, merge, reject, tags, a full action log with undo, and exports as JSON, CSV and Jira CSV.
- AI triage: a Claude Code skill (
arghbox-triage) that rejects spam, merges duplicates, tags and flags, with checked verdicts applied in one transaction, a confidence gate and whole-run undo. No paid AI calls. - MCP server (
mcp.php): search, triage and update the box from Claude Code, Cursor and VS Code, with a read-only token and no delete tool. - npm package
arghbox:npx arghbox installcopies the server folder and the triage skill into a site (safe to re-run from aprebuildscript, never touchesconfig.phpor data),npx arghbox secretsmakes the tokens, andimport { version } from 'arghbox'gives the version for the script tag. Published with npm provenance by the release workflow, which also attaches the zips with build provenance attestations to the GitHub Release. - Reports and blocks: visitors can report a published entry (spam, rude or abusive, off topic, other). Three reports from different people (
report_hide_at) hide it until it is reviewed. The admin page has a Reported list (open reports on published, pending or flagged entries), "Keep it (dismiss reports)" for public entries and "Put it back (dismiss reports)" for hidden ones, a list of blocked authors, Block author and Unblock author. Blocked authors' new posts are rejected quietly (limits.block_days). Triage decides reported entries (keeporreject) and may setblock_authorfor clear spam or abuse. The MCP server hasarghbox_dismiss_reports,arghbox_block_authorandarghbox_unblock_author. New config:contact_url(a "Contact" link in the dialog),report_hide_at,limits.reports_per_hourandlimits.block_days. Schema version 4. - Mobile apps:
arghbox/app.htmlshows the whole board full screen in an app's WebView, with no sign-in, URL parameters,context.app(platform and version, shown on the admin page) and a bridge that posts events (open, close, add, vote and link, for external links) to Swift, Kotlin, React Native and Flutter. An opt-inapp_passhelps WebViews that cannot pass Turnstile. Seedocs/mobile.md, with an App Store guideline 1.2 and Google Play checklist. - Tools: a local dev server with a demo site, secret generation, install and release-zip scripts, a seed loader, a size check, a README screenshot capture, and an owner-only translation script.
- Docs: install guide, configuration, triage, MCP, integrations, translations and API reference, plus a trademark policy (
TRADEMARKS.md).
Install with npm install --save-dev arghbox@0.1.0 and npx arghbox install --public <your web root> --skill, or download arghbox-0.1.0.zip below and upload its arghbox folder. Every file has a build provenance attestation: gh attestation verify <file> --repo BinaryBananaLLC/ArghBox.