Install the skill

Auto-detects and installs into:
  • Claude Code~/.claude/
  • Codex~/.codex/
  • Cursor~/.cursor/
It also installs the bestmate CLI to /usr/local/bin if you don’t already have it. Prefer to read before you run:
Already installed the CLI via Homebrew? You still want this — it’s what drops the SKILL.md that teaches your agent when and how to call Bestmate.

Sign in

What your agent can do

Push what it learns. The agent has already read the content and knows who’s in it and what was decided, so it passes that structure straight through instead of making the backend re-derive it:
Ask what you already know.
Call your connected services without ever holding a token.

Credential broker

Why your agent should never ask you to paste an API token.

Rules that make this work well

Before every push, run bestmate stores list. If a store already covers the content — same client, same project, same theme — pass --store <slug>. Creating a new store for content that belongs in an existing one fragments your memory and breaks the routing you configured.
Pass --summary, --people, --decision, and the rest. The agent already did the reading; sending only raw text throws that work away and makes the backend guess at it.
To reach Gmail or any connected service, use bestmate proxy. Bestmate owns the integration and injects the credential server-side.
Agents cache SKILL.md on first load. If you re-run the installer, restart the agent session so it picks up the new instructions.

Troubleshooting

401 Unauthorized — run bestmate login again to mint a fresh key. Agent isn’t using Bestmate at all — check the skill landed (ls ~/.claude/skills/), then restart the session.