1. Create your account

Request access at https://src.land/signup. Once your spot opens, you'll receive an email and land in the welcome wizard, which collects a username (your slug) and a display name.

2. Set up a passkey

The wizard offers a Set up a passkey step — take it. Passkeys are phishing-resistant and replace passwords for sign-in, so there's nothing to steal or phish. You can also enrol or manage passkeys later under Settings → Access. Browsers without WebAuthn support skip the step automatically.

3. Add an SSH key

Push and clone over SSH require a public key on file. From your terminal:

ssh-keygen -t ed25519 -C "you@example.com"
pbcopy < ~/.ssh/id_ed25519.pub  # macOS - Linux: xclip / wl-copy

Paste the public key into Settings → SSH keys. Verify with ssh -T git@src.land — you should see your slug echoed back.

4. Import from GitHub

The wizard's Bring your code step lets you import GitHub repositories in bulk: paste a personal access token with repo read scope, pick the repositories you want, and Citadel fetches code, issues, pull requests, labels, and comments in the background. You can skip it during setup and run the same flow any time from the standalone Import page. Imports are one-time snapshots — there is no ongoing mirror mode.

5. Create your first repo

Click ＋ New → Repository in the top bar, fill the slug + visibility, optionally tick Initialize with README. The new repo is reachable immediately.

6. Push existing code

cd ~/projects/your-repo
git remote add origin git@src.land:your-slug/your-repo.git
git push -u origin main

7. Invite collaborators

On a personal namespace, sharing is read-only via the public URL. For multi-author work, create an organization: click ＋ New → Organization in the top bar (or go directly to Create an organization) then invite members by email from the org's Members settings. Invitees receive a claim link.

8. Connect an agent

citadel-cli, MCP clients, and CI runners authenticate with agent tokens — long-lived credentials that carry your permission grants without requiring an interactive sign-in. Issue one under Settings → Access → New token, then hand it to your tool. Full details in the Agent tokens help topic.

Getting started