Skip to content

The key finder looks for API keys, tokens and passwords where your agents can read them, says who can read each one, and helps you take it out and replace it.

On this page

Your agents can read most of what you can. That includes the keys in your shell's startup files, your .env files and your tools' settings. The key finder shows where they are.

Where it looks

  • shell startup files such as ~/.zshrc, and your shell history;
  • .env files in the folders your agents worked in, and ~/.env;
  • tool settings such as ~/.npmrc, ~/.aws/credentials and ~/.docker/config.json;
  • the settings and sign-in files of the 43 agents Excellent recognizes.

Many tools keep their sign-ins in ~/.config. The key finder looks there only if you turn on Also check ~/.config in Settings. A folder your never-open rules close stays closed.

It runs by itself after your first scan. Open it from the keys row in the menu.

What it tells you

For each key: what kind it is, where it is, who can read it, and whether it has already reached a model. Excellent keeps a fingerprint of each key, never the key itself.

Take a key out of a file

Remove… shows you which lines it will change, then replaces the key with REMOVED-BY-EXCELLENT. There's no backup, because the backup would hold the key. It can't be undone.

Replace a key

Replace this key opens the provider's own key page in your browser: Anthropic, OpenAI, GitHub, GitLab, Slack, AWS, Google Cloud, Stripe, OpenRouter or xAI. You make the new key and cancel the old one there. Excellent never talks to the provider itself.

A key you removed still works until you cancel it with its provider.

Keys in logs and commands

  • A key typed into a command ends up in the agent's log. The finding API keys are sitting in your agent logs has a button to clear them. See What it finds.
  • With protection on, the check blocks an agent typing an API key into a command. See Turn on protection.

Was this page helpful?

Something wrong or missing in the docs? Email hello@excellent.so.

Start here

  • StartWhat Excellent does
  • StartInstall Excellent for Mac
  • StartYour first scan
  • StartWhat it finds
  • StartFree and Pro