# Keys

> 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.

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](https://www.excellent.so/docs/what-it-finds).
- With protection on, the check blocks an agent typing an API key into a command. See
  [Turn on protection](https://www.excellent.so/docs/turn-on-protection).

Source: https://www.excellent.so/docs/keys
