ForgeKey

Manage your Foundry keystores from the menu bar.

Features

Key Management

• Create, import, and organize wallets by project or environment
• Generate vanity addresses with custom prefixes and suffixes
• One-click copy for addresses and private keys

Developer Experience

• Menu bar native — always one click away
• Cross-platform — macOS menu bar, Linux system tray
• Auto-updates keep you current

Security

• Foundry-backed — your keys stay in Foundry's secure keystore format

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/ForgeKey/ForgeKey/main/install.sh | bash

This will download the latest release for your platform and install it automatically.

Manual Download

Download the latest release for your platform from the Releases page:

Platform	Download
macOS (Apple Silicon)	ForgeKey_x.x.x_aarch64.dmg
macOS (Intel)	ForgeKey_x.x.x_x64.dmg
Linux (x64 only)	ForgeKey_x.x.x_amd64.deb / .AppImage

Prerequisites

ForgeKey requires Foundry to be installed. If Foundry isn't detected on first launch, ForgeKey will offer to install it for you.

Security

ForgeKey is a GUI wrapper around Foundry's cast wallet commands — your keys never leave Foundry's secure keystore. We don't implement our own crypto.

See SECURITY.md for details on our security model and how to report vulnerabilities.

FAQ

Where are my keystores stored?

ForgeKey uses Foundry's default keystore location:

• macOS: ~/.foundry/keystores/
• Linux: ~/.foundry/keystores/

These are standard Foundry keystores — you can use them directly with cast wallet commands.

Can I use keystores I created with Foundry CLI?

Yes. ForgeKey reads from the same keystore directory that Foundry uses. Any keystores you've created with cast wallet new or cast wallet import will appear automatically.

Is my private key ever exposed?

Only when you explicitly request it. ForgeKey can decrypt and display your private key for copying, but this requires entering your keystore password. The decrypted key is held in secure memory and zeroed immediately after use.

What happens if Foundry isn't installed?

On first launch, ForgeKey checks for Foundry. If not found, it will offer to install it for you using Foundry's official installer (foundryup).

Does ForgeKey support hardware wallets?

Not currently. ForgeKey is focused on software keystores managed by Foundry. Hardware wallet support may be considered for future releases.

Contributing

Contributions are welcome! See CONTRIBUTING.md for development setup and guidelines.

License

ForgeKey is licensed under the GPL-3.0 License.