FAQ

Questions, answered

The short version of what people ask before they install ArghBox.

Is ArghBox a free alternative to hosted feedback boards?

If a monthly SaaS plan is more than your side project can justify, yes: it does the same job on ordinary PHP hosting, it is MIT licensed, and there is no per-seat pricing. If you need SSO or two-way Jira sync, an all-in-one tool fits better.

Can visitors report bugs, not just request features?

Yes. Every entry is an idea, a bug or a question. The dialog lists bugs on their own tab, and ideas and questions together on the other. Visitors vote on what others already reported, so the same bug is not filed twenty times, and you see which ones hurt most.

Do visitors need an account?

No. A Cloudflare Turnstile check, usually invisible, stands in for a login. Visitors vote and add entries without signing up, and ArghBox sets no cookies for them.

What does the AI cost?

Nothing extra. Triage runs in your own Claude Code session, using the plan you already pay for. ArghBox itself never calls a paid AI API.

Can I use Codex or another agent?

Yes. The triage skill is plain Markdown instructions plus a Node script, so any coding agent that can read the instructions and run node can follow them.

What hosting do I need?

Ordinary shared hosting with PHP 8.1 or newer and SQLite through PDO. No Docker, no database server, no cron jobs. If you can upload a folder by FTP or a file manager, you can run ArghBox.

Does it need a build step or a framework?

No. It is one script tag. It works on any site that lets you add a script tag, as long as the folder with ArghBox runs on PHP hosting.

Does it work on WordPress?

Yes. Upload the arghbox folder to the same hosting, next to your WordPress folders, and add the script tag with a header-and-footer plugin or in your theme. ArghBox does not depend on WordPress and does not touch its database.

Does it slow my site down?

The loader is about 4 KB gzipped, deferred, and makes no network request until a visitor interacts with the tab. The dialog code loads on first intent.

What about privacy and GDPR?

ArghBox stores no raw IP addresses, no emails and no cookies for visitors, and the add form shows exactly what it sends. You decide the retention: entries can be exported and removed. This is not legal advice, so check your own obligations.

What if I don't use Claude Code or Codex?

Everything except the automatic sorting still works. The widget, the votes and the export need no AI at all, and you review the waiting entries by hand on the admin page, where statuses, replies and notes live too. You can add an AI later without changing anything.

Can I get my data out?

Any time. Export everything as JSON, CSV for spreadsheets, or a Jira-ready CSV, and subscribe to the Atom feed. It is one SQLite file on your own hosting.

What if the AI gets it wrong?

The AI suggests, you decide. Verdicts it is not sure about are flagged for you instead of applied. Every action is logged on the admin page and can be undone, one entry or a whole triage run. The skill never deletes data outright.

Is it free? What is the catch?

It is free and MIT licensed, with no paid tiers and no locked features. If it saves you time, you can donate a coffee, but that never unlocks anything.

Can I fork it, or use the ArghBox name?

Fork it, change it, host it, even sell it: the MIT licence allows all of that. The name and the logo are trademarks of BinaryBanana LLC, so a changed version you publish needs its own name, and "based on ArghBox" is fine. Running ArghBox on your own site, with your own settings and wording, never needs permission. The trademark policy in the repository has the details.

Who is it not for?

Larger teams that need accounts, roles, SSO or two-way Jira sync are better served by the all-in-one feedback tools. ArghBox deliberately does one job: collect feedback and keep the box clean.

Does it work without PHP, on pure static hosting?

Not yet: the folder with ArghBox needs PHP for the backend. A Cloudflare Worker backend is an idea for later.

How do I report a bug, suggest an idea or ask a question?

Use the Feedback tab on this site. It is a real ArghBox, so you try it while you use it. Bugs, ideas and questions all go there.

Still stuck? Ask with the real thing: the Feedback tab on this site is a live ArghBox.