Docs/Getting Started

Create a New Workspace

If you’re brand new to Pierre, this crash course helps you set up a new workspace on Pierre, from signing up after you receive an invite to creating and pushing your first project.


Sign In

Once you’ve been invited by our team to try Pierre’s private alpha, it’s time to sign in to Pierre for the first time and get yourself setup. We recommend signing in with Google, but you can also request a magic link be sent to your email.


Team, or Personal?

After signing up with your invited email address, you’ll be asked to choose between using With a team or for Personal use. Starting with a team allows you to create and customize your first workspace, while personal use automatically creates your first workspace based on your name (e.g., "Mark’s Pierre"). Choose whichever option best fits your needs.

If you choose to start with a team, you’ll be asked to name your first workspace. You can always change this or create more workspaces later.

After that, you’ll be asked to invite teammates. You can also skip this step and invite them later if you’d like. This is the last step in creating your first workspace, and whether you invite folks or skip it, you’ll be taken to your workspace’s home page next.


SSH Keys

After you sign in, you’ll need to setup your SSH keys so you can authenticate and push local changes to Pierre’s server. We recommend using our CLI to set up your SSH keys, but you can also do it manually, too. Use our SSH guides linked below to get setup.

Once you’re done with SSH, continue onto the next step here.


First Repository

In your browser, navigate to your workspace on Pierre. In the left-hand sidebar, click the create a repository link to create your first repository.

After you complete the form and create the repository, you’ll be taken to an empty repository page.

In the top right, click the icon to copy the Git repository URL. You’ll need this to connect a local project to Pierre.

From your terminal, create a new folder for your project and navigate into it.

# Create project folder
mkdir my-project
cd my-project

# Add an initial file to push up
echo "Hello, Pierre" >

With the project folder and first file made, it’s time to initialize your Git repository and add Pierre as a new remote.

# Initialize a new Git repository
git init

# Add Pierre as a remote (replace {workspace} and {repo-name} with your own)
git remote add origin{workspace}/{repo-name}.git

Now you can add and commit your changes before finally pushing the project to Pierre.

# Add changed files
git add .

# Commit changes
git commit -m "Initial commit"

# Push the project to Pierre
git push origin main

Success! Your project is now on Pierre and ready for you to start working on it.


Existing Repositories

If you have any existing Git repositories you’d like to move to Pierre, it’s as straightforward as adding Pierre as a new remote. We recommend making Pierre your new origin and renaming the old one to upstream just in case.

# Rename existing origin to upstream
git remote rename origin upstream

# Add Pierre as new remote origin (replace {team} and {repo-name} with your own)
git remote add origin{team}/{repo-name}.git

# Push all branches in the project to Pierre
git push --all origin

And you’re all set! Once pushed, your project and all its branches will be available on Pierre.


Next Steps

Heck yeah, you’ve setup your new workspace on Pierre and have your local environment ready to go! When you’re ready, consider looking over our guides to familiarize yourself with Pierre.

  • Workspaces: Learn how to manage worksapces, invite new members, and create new workspaces.
  • Repositories: Learn about using and navigating repositories on Pierre.
  • Branches: Learn how to create, merge, and delete branches in your repositories.

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