Docs/Getting Started

Setup SSH Keys

Learn how to setup SSH keys for your Pierre account.

Using the CLI

Sign in (or confirm you’re signed in) by running the following command:

npx pierre@latest

After you sign in, if you don’t yet have SSH keys setup, you’ll be asked to do so. We use these to authenticate you when you interact with your workspace’s repositories and our Git servers.

█ Pierre v2.0.27

✓ Sign in to Pierre? › Auth w/ Google (recommended)
✓ Hello, Mark.
? Pierre requires an SSH connection.
›   Auto setup SSH (recommended) # We create and add SSH key to config + agent
    Manually setup SSH
    Don’t setup SSH

Continue to follow the steps listed to complete the SSH key process. We recommend generating a new key pair for security reasons, but you can also use an existing one. If you already have a Pierre key, we’ll detect that and suggest you use it. Similarly, externally managed SSH keys can be detected and used as well.

█ Pierre v2.0.27

✓ Sign in to Pierre? › Auth w/ Google (recommended)
✓ Hello, Mark.
✓ Pierre requires an SSH connection. › Auto setup SSH (recommended)
? Select an existing SSH key or generate a new one
›   Generate a new key pair (recommended)

After you generate a new key or use an existing one, we’ll use that key to securely connect you with Pierre. Once you finish the SSH key setup, you can start cloning existing repositories from the workspace.

Manual Setup

If you prefer not to use the Pierre CLI, you can manually set up your local environment.


Generate SSH key pair

Generate a new SSH key pair if you don’t already have one. You can use the following command to generate a new key pair:

ssh-keygen -t ed25519 -C ""

Replace with the email address you’re using with Pierre. Confirm the default file location and enter a passphrase if you want to add an extra layer of security, or press Enter to skip.


Confirm key

Confirm your SSH key with ssh-agent.

eval "$(ssh-agent -s)"

This should return something like:

# eval "$(ssh-agent -s)"
Agent pid 76445

Update SSH config

Update your SSH config file to use your key. Open or create the ~/.ssh/config file and add the following lines:

   AddKeysToAgent yes
   UseKeychain yes
   IdentityFile ~/.ssh/id_ed25519

Replace ~/.ssh/id_ed25519 with the path and name of your private key file if it’s different.


Add private key

Add the SSH private key to the ssh-agent and store the passphrase in the keychain.

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Add public key to Pierre

Add your public SSH key to your Pierre account settings. You can find your public key by running the following command:

pbcopy < ~/.ssh/

Navigate to your Pierre account settings and paste the key into the new SSH key form with an optional title.

Verify your SSH key was correctly set with the following command:

ssh -T
# > Hello from Pierre! Your SSH key looks good.

Pierre is the product engineering tool

Code hosting, review, docs, and CI. One place for product engineers and their teams to focus on what they do best—building products.

Join the Waitlist
Skip the line! Join our Discord for early access