Skip to content
Back to search

asked-before

MarketplaceWorks with Claude CodeGitHub

The AskedBefore plugin for Claude Code

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/m1kutech--askedbefore/badge.svg)](/listings/m1kutech--askedbefore)

HTML

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

Install

Install instructions from the README

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

AskedBefore runs on your computer under `wrangler dev`, which runs it as Cloudflare Workers would, with no Cloudflare account. Sorts and cold reps need an Anthropic API key; the rest of the app runs without one.

<p align="right"><a href="#readme-top">&uarr;</a></p>

Prerequisites

- [Bun](https://bun.com/) 1.4 or later. - [Node.js](https://nodejs.org/) 22 or later, which Wrangler runs on. - An [Anthropic API key](https://platform.claude.com/), for sorts and cold reps.

<p align="right"><a href="#readme-top">&uarr;</a></p>

Installation

1. **Clone and install.**

```sh git clone https://github.com/m1kutech/AskedBefore.git cd AskedBefore bun install ```

2. **Add your key.** Copy `apps/web/.env.example` to `apps/web/.env`, beside `wrangler.jsonc`, and set `ANTHROPIC_API_KEY`. `.env` is git-ignored, and a key exported in your shell works too.

```sh cp apps/web/.env.example apps/web/.env ```

3. **Start the app.** `bun run dev` builds the pages into `apps/web/dist/`, applies the D1 migrations to a local database in `apps/web/.wrangler/` and starts `wrangler dev`.

```sh bun run dev ```

4. **Open it.** Open the address Wrangler prints, <http://localhost:8787> unless that port is taken. Sign up and choose **Try the demo shelf** on Home, or try it as a guest. Your local data stays in `apps/web/.wrangler/`; delete that folder to start again. Wrangler reloads the Worker when its code changes, but not the pages: run `bun run build:pages` after changing them.

The local app keeps a deployment's daily caps, from `apps/web/wrangler.jsonc`'s `vars`: 20 model requests and 8,000 messages a day. For more, raise `SITE_DAILY_MODEL_REQUESTS` and `SITE_DAILY_PHRASINGS` there and start the app again.

5. **Run the checks.** Each check starts its own copy of the app with a fresh database and drives it from outside: through the SDK, in a real browser or with the official MCP client. The browser checks need Playwright's Chromium once.

```sh bun run --cwd apps/web playwright install chromium bun run typecheck bun run journey ```

`bun run journey` walks the core journey in Chromium with the real model, in seven model calls: it signs up, uploads the demo export, fails and then passes a cold rep, makes an API key, lists the cards through the SDK and records a question through the MCP server. The root `package.json` has a `check:*` script for each area, run in `apps/web`, such as `check:guest`, `check:search` and `check:mcp`. Most stub the model inside the script; the few that call the real model need the key.

6. **Optionally, deploy to Cloudflare.** It runs on Workers Free. `apps/web/wrangler.jsonc` has no database ID and a placeholder address, so add your own. Run Wrangler from `apps/web`, beside its config. With your key exported in your shell, log in, make the database and add its ID as `database_id` to `wrangler.jsonc`'s `DB` binding. Then apply the migrations and set the key as the Worker's secret; Wrangler offers to create the Worker for it.

```sh cd apps/web bunx wrangler login bunx wrangler d1 create asked-before bunx wrangler d1 migrations apply DB --remote printenv ANTHROPIC_API_KEY | bunx wrangler secret put ANTHROPIC_API_KEY ```

Replace `PUBLIC_URL` in `wrangler.jsonc`'s `vars` with your app's address, then build and deploy, still in `apps/web`. To deploy a change, apply any new migrations first, then build and deploy again.

```sh bun run build:pages bunx wrangler deploy ```

`SITE_DAILY_MODEL_REQUESTS` and `SITE_DAILY_PHRASINGS` in `vars` cap the whole app's day, to stay under D1 Free's 100,000 rows written a day; raise them on Workers Paid. D1's Time Travel keeps 7 days of the database's history on the free plan and 30 on a paid one, and can't be turned off, so what a learner deletes stays in Cloudflare's backups for up to 7 days, or 30 on a paid plan.

Ratings and comments

Sign in to rate this skill.

Sign in

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