Quickstart

This guide takes an existing local Git repository to its first reviewed change on Upstream.

1. Create an account

Create an Upstream account. Your handle becomes the namespace for your personal repositories. The same identity also works across Coline.

2. Create a repository

Open Repositories, select New repository, choose a namespace, name the repository, and set its visibility.

• Public repositories are visible and cloneable without signing in.
• Private repositories require explicit access.
• Internal repositories are visible to members of the owning workspace.

3. Set up Git authentication

Public repositories can be cloned without a credential. To push, create a Git credential in Git settings or add an SSH key in SSH key settings.

For HTTPS, use any non-empty username and the one-time credential as the password.

4. Push your repository

git remote add upstream https://git.coline.app/{namespace}/{repository}.git
git push -u upstream main

To clone instead:

git clone https://git.coline.app/{namespace}/{repository}.git

5. Open a Change Request

Push a branch, open the repository on upstream.codes, select Changes, then New Change Request. Choose the source and target branches, describe the change, and create the request.

Each later version keeps its own review and check history. An approval of an older version never silently approves newer code.