Bestie Check

Document reasoning checks: a helicopter view of claims and assumptions before handoff.

Otherv0.3.0

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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @mybestie/check

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-hirebestie-bestie-check": {
      "command": "npx",
      "args": [
        "-y",
        "@mybestie/check"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@mybestie/checknpm

Compatible MCP Clients

Bestie Check works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More