Skip to content

hirebestie/bestie-check

v1.2.0MIT

Prepare document deliverables with Bestie Check before handoff and read the free Claim and Assumption Quick Look. Paid verification is offered only when the server opens it, and only against a quote the user approves. Portable Agent Plugins core; clients load native overlays separately.

GitHubOpen Website

Bestie Check

See your document from above: every claim, and every assumption it rests on.

Bestie Check prepares a memo, report, or other document for a reasoning check. The free Quick Look gives you a helicopter view of its claims and assumptions. Agents can also read findings and a fix list from checks in the connected account. Paid checks require server availability and approval of a specific quote.

This repository contains the public plugin distribution. The Node CLI and stdio MCP implementation are bundled in @mybestie/check. Plugin version 1.2.0 uses CLI version 0.3.0, published on npm.

Connect

Hosted MCP with OAuth

For hosts that accept a remote MCP server, connect to:

https://www.hirebestie.com/api/check/mcp

Sign in to your Bestie account and authorize the connection. Use the hosted connection or the local stdio connection for each host. Configuring both duplicates the tools.

CLI and local MCP

Requires Node.js 20 or newer and npm.

npx -y @mybestie/check@0.3.0 login
npx -y @mybestie/check@0.3.0 capabilities
npx -y @mybestie/check@0.3.0 prepare --file memo.pdf --wait --progress
npx -y @mybestie/check@0.3.0 mcp

The plugin's local MCP process pins @mybestie/check@0.3.0. Sign in through the CLI first; credentials stay in the CLI's local credential store. You may instead configure BESTIE_API_KEY in your host's private environment. Never commit a key or include one in a prompt.

Claude Code

/plugin marketplace add HireBestie/bestie-check
/plugin install bestie-check@bestie

Use /bestie-check:verify to prepare a document. The optional Stop hook asks whether to offer Check; it never approves spending.

Cursor and Codex

The root plugin.json, mcp.json, and skills/ form a portable Agent Plugin. .codex-plugin/plugin.json provides Codex compatibility metadata. .cursor/mcp.json and .cursor/rules/bestie-check.mdc provide a Cursor configuration and rule for manual setup. Follow your client's local-plugin setup instructions.

Public directory acceptance is separate from this repository. This repository does not imply a listing in the Claude, OpenAI, or Cursor directories.

Agent skill

bunx skills add HireBestie/bestie-check --skill verify-deliverable

Expected journey

  1. Call inspect_capabilities and use the returned availability.
  2. Prepare the document with prepare_deliverable, or upload its bytes with the file-upload tools.
  3. Poll get_preparation until the returned nextAction is review; respect retry and failure states.
  4. Report the returned claims and assumptions without inventing findings or a verdict.
  5. For an existing check, read its findings and fix list using the account's authorized access.

Paid tools are offered only when the server reports them ready. An agent must obtain approval for the actual quote, its hash, and a credit ceiling. Installing a plugin, signing in, or saying "check this" does not approve spending.

Links

The fixture under review-fixtures/ is fictional and may be used for integration testing. Review-account credentials are supplied privately through submission portals; they are never part of this repository.

License

The plugin files in this repository are MIT licensed. Bestie's hosted service is governed by its own service terms. See LICENSE.