Install the skill
- Claude Code —
~/.claude/ - Codex —
~/.codex/ - Cursor —
~/.cursor/
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:Credential broker
Why your agent should never ask you to paste an API token.
Rules that make this work well
Reuse existing stores
Reuse existing stores
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.The agent does the extraction
The agent does the extraction
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.Never handle raw service tokens
Never handle raw service tokens
To reach Gmail or any connected service, use
bestmate proxy. Bestmate owns
the integration and injects the credential server-side.Restart after a skill update
Restart after a skill update
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.