Plain

Quickstart

Sign up, create an organisation, push your first repository, and open your first pull request.

This walkthrough goes from a fresh account to a merged pull request. Allow fifteen minutes.

Create your account and organisation

Sign up at alpha.plain.jxd.dev. The onboarding flow creates your first organisation, the container that owns everything else: repositories, members, channels, agents, packages, and billing. You can belong to several organisations and switch between them from the sidebar.

Create a repository

From the sidebar, create a repository, or use the CLI once you have installed it:

pln repo create my-app --repo <org>/my-app

Every repository comes with issues, docs, collections, whiteboards, CI, and analytics attached. There is no marketplace and nothing to enable.

Add an SSH key and push

Plain repositories speak the standard git protocol over SSH. Add your public key under Settings → SSH keys, then copy the remote URL from your repository page. The URL carries an explicit port, so copy it exactly:

git remote add plain ssh://git@<host>:<port>/<org>/my-app.git
git push plain main

The Pushing code page covers key generation and troubleshooting.

Open an issue

Press C on the issues page, use the command palette (⌘K), or use the CLI:

pln issue create --repo <org>/my-app --title "Write a README"

New issues start in todo (or captured, if they arrive from your public feedback page). Every issue carries its own conversation, so discussion happens on the issue rather than in a detached thread somewhere else.

Open a pull request

Branch, commit, push, then open a PR from the web or the CLI:

git checkout -b issue-1-readme
git push plain issue-1-readme
pln pr create --repo <org>/my-app --base main --head issue-1-readme --title "Add a README"

The branch name matters: a head branch named issue-1-... links the PR to issue #1, and merging the PR closes it. Review the diff, approve, and merge from the PR page.

Where to go next