NobGit
public nobgit read

Wiki

This is Markdown version of NobGit Docs

Create file Wiki Documentation
Clone
https://nobgit.com/orgs/nobgit/wiki.git
ssh://[email protected]:2222/orgs/nobgit/wiki.git

Commit

Initial commit

a7ad6fa
Alex Nord <[email protected]> 2 weeks ago
Deploy with Cloudflare.md                       |  21 +++++
 Disconnect accounts and integrations.md         |  49 ++++++++++
 Enable AI inside NobGit.md                      |  21 +++++
 How to add a passkey or OTP.md                  |  12 +++
 How to commit to NobGit.md                      |  53 +++++++++++
 How to connect Slack.md                         |  20 ++++
 How to connect Trello.md                        |  16 ++++
 How to connect webhooks.md                      |  15 +++
 How to create an access token.md                |  19 ++++
 How to create an org.md                         |  14 +++
 How to create repo.md                           |  26 ++++++
 How to get started.md                           |  20 ++++
 How to link your Discord account with NobGit.md |  18 ++++
 How to set up SSO for organizations.md          |  18 ++++
 How to transfer a repo.md                       |  12 +++
 How to upload a GPG key.md                      |  49 ++++++++++
 How to upload an SSH key.md                     |  46 +++++++++
 How to upload and use releases.md               | 118 ++++++++++++++++++++++++
 How to use Wiki.md                              |  40 ++++++++
 How to use the NobGit MCP.md                    |  37 ++++++++
 Import from GitHub.md                           |  19 ++++
 NobGit Docs.md                                  |  47 ++++++++++
 Page not found.md                               |   5 +
 23 files changed, 695 insertions(+)
 create mode 100644 Deploy with Cloudflare.md
 create mode 100644 Disconnect accounts and integrations.md
 create mode 100644 Enable AI inside NobGit.md
 create mode 100644 How to add a passkey or OTP.md
 create mode 100644 How to commit to NobGit.md
 create mode 100644 How to connect Slack.md
 create mode 100644 How to connect Trello.md
 create mode 100644 How to connect webhooks.md
 create mode 100644 How to create an access token.md
 create mode 100644 How to create an org.md
 create mode 100644 How to create repo.md
 create mode 100644 How to get started.md
 create mode 100644 How to link your Discord account with NobGit.md
 create mode 100644 How to set up SSO for organizations.md
 create mode 100644 How to transfer a repo.md
 create mode 100644 How to upload a GPG key.md
 create mode 100644 How to upload an SSH key.md
 create mode 100644 How to upload and use releases.md
 create mode 100644 How to use Wiki.md
 create mode 100644 How to use the NobGit MCP.md
 create mode 100644 Import from GitHub.md
 create mode 100644 NobGit Docs.md
 create mode 100644 Page not found.md

Diff

diff --git a/Deploy with Cloudflare.md b/Deploy with Cloudflare.md
new file mode 100644
index 0000000..d88d40d
--- /dev/null
+++ b/Deploy with Cloudflare.md	
@@ -0,0 +1,21 @@
+# Deploy with Cloudflare
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **Deployment**.
+5. In **Cloudflare connection**, enter a connection name, Cloudflare Account ID, and API token.
+6. Select **Save and test connection**.
+7. Open the repository you want to deploy.
+8. Visit **Settings**.
+9. Expand **Cloudflare** under **Integrations**.
+10. Check **Enable deployments**.
+11. Choose an existing Pages project or Worker, or create a new target.
+12. Set branch, build command, and output directory or Worker entry in **Advanced build settings**.
+13. Select **Save Cloudflare integration**.
+
+On push, NobGit queues deployments from the Git post-receive hook. Pages deploys upload files from the output directory. Workers deploys upload a JavaScript module entry such as `worker.js`, `index.js`, or `src/index.js`.
+
+- [Previous: Trello](How to connect Trello.md)
+
+- [Next: SSO](How to set up SSO for organizations.md)
diff --git a/Disconnect accounts and integrations.md b/Disconnect accounts and integrations.md
new file mode 100644
index 0000000..9c20813
--- /dev/null
+++ b/Disconnect accounts and integrations.md	
@@ -0,0 +1,49 @@
+# Disconnect accounts and integrations
+
+## Disconnect integrations
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **Deployment**.
+
+Here you can disconnect Cloudflare deployer.
+
+## Disable NobGit AI
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **AI Providers**.
+5. Uncheck **Enable NobGit AI for this account**.
+6. Select **Save AI status**.
+7. Click **Disconnect**.
+
+## Disconnect accounts
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **Linked accounts**.
+
+Here you can disconnect Discord and Slack workspaces.
+
+## Disconnect Trello
+
+1. Open the organization you want to disconnect from Trello.
+2. Visit **Organization settings**.
+3. Under **Integrations**, expand **Trello**.
+4. Select **Disconnect Trello**.
+
+## Unlink social logins
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Access**.
+4. Open **Other Sign in methods**.
+
+Here you can unlink Cloudflare, Google, and LinkedIn.
+
+- [Previous: link Discord account](How to link your Discord account with NobGit.md)
+
+- [Next: transfer repo](How to transfer a repo.md)
diff --git a/Enable AI inside NobGit.md b/Enable AI inside NobGit.md
new file mode 100644
index 0000000..b044750
--- /dev/null
+++ b/Enable AI inside NobGit.md	
@@ -0,0 +1,21 @@
+# Enable AI inside NobGit
+
+NobGit AI currently supports ChatGPT. Support for Claude and Google Gemini is coming soon.
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **AI Providers**.
+5. Create or copy an API key from [OpenAI API keys](https://platform.openai.com/api-keys).
+6. Paste the API key into NobGit.
+7. Choose a model you want to use.
+8. Check **Enable NobGit AI for this account**.
+9. Select **Save AI status**.
+
+## Disable NobGit AI
+
+To turn NobGit AI off later, follow [Disconnect accounts and integrations](Disconnect accounts and integrations.md).
+
+- [Previous: create org](How to create an org.md)
+
+- [Next: NobGit MCP](How to use the NobGit MCP.md)
diff --git a/How to add a passkey or OTP.md b/How to add a passkey or OTP.md
new file mode 100644
index 0000000..3f8f65a
--- /dev/null
+++ b/How to add a passkey or OTP.md	
@@ -0,0 +1,12 @@
+# How to add a passkey or OTP
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Access**.
+4. Open **Security**.
+5. To add a passkey, use the **Passkeys** section, enter a name, select **Create passkey**, and complete the browser or operating system prompt.
+6. To add an authenticator code, use the **Authenticator app** section, create an OTP key, scan the QR code or copy the manual key, enter the 6-digit code, and select **Enable OTP**.
+
+- [Previous: Wiki](How to use Wiki.md)
+
+- [Next: link Discord account](How to link your Discord account with NobGit.md)
diff --git a/How to commit to NobGit.md b/How to commit to NobGit.md
new file mode 100644
index 0000000..5df48e4
--- /dev/null
+++ b/How to commit to NobGit.md	
@@ -0,0 +1,53 @@
+# How to commit to NobGit
+
+An [SSH key](How to upload an SSH key.md) or [access token](How to create an access token.md) is required to push code to NobGit. Password authentication is not supported.
+
+## Prepare Git
+
+1. Install Git on your computer.
+2. Set the name and email address you want on commits.
+
+```
+git config --global user.name "Your Name"
+git config --global user.email "[email protected]"
+```
+
+## Clone a repository
+
+Open the NobGit repository and use the clone panel to copy either the HTTPS or SSH clone URL.
+
+```
+git clone https://www.nobgit.com/{owner}/{repo}.git
+cd {repo}
+```
+
+For HTTPS, use your NobGit username and an access token when Git asks for credentials. For SSH, add an SSH key to NobGit first.
+
+## Commit and push changes
+
+1. Edit or add files in the repository folder.
+2. Review the changed files.
+3. Stage the files you want to commit.
+4. Create the commit.
+5. Push the branch to NobGit.
+
+```
+git status
+git add .
+git commit -m "Describe your change"
+git push origin main
+```
+
+## Edit from NobGit
+
+1. Open the repository in NobGit.
+2. Click the file you want to change.
+3. Edit the file in NobGit.
+4. Write a clear commit message.
+5. Commit the change.
+
+If your repository uses a different default branch, replace `main` with that branch name. If the push is rejected because the remote has newer commits, run `git pull --rebase origin main`, resolve any conflicts, and push again.
+
+- [Previous: GPG key](How to upload a GPG key.md)
+
+- [Next: releases](How to upload and use releases.md)
diff --git a/How to connect Slack.md b/How to connect Slack.md
new file mode 100644
index 0000000..4c36a9a
--- /dev/null
+++ b/How to connect Slack.md	
@@ -0,0 +1,20 @@
+# How to connect Slack
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Integrations**.
+4. Open **Linked accounts**.
+5. Under **Slack workspaces**, select **Connect Slack workspace**.
+6. Complete Slack authorization.
+7. Open the repository that should send Slack notifications.
+8. Visit **Settings**.
+9. Expand **Slack** under **Integrations**.
+10. Check **Enable Slack push notifications**.
+11. Choose the workspace and channel in **Slack channel**.
+12. Select **Save Slack integration**.
+
+NobGit sends push summaries from the Git post-receive hook, including branch actions, short SHAs, and commit subjects.
+
+- [Previous: NobGit MCP](How to use the NobGit MCP.md)
+
+- [Next: webhooks](How to connect webhooks.md)
diff --git a/How to connect Trello.md b/How to connect Trello.md
new file mode 100644
index 0000000..95d0269
--- /dev/null
+++ b/How to connect Trello.md	
@@ -0,0 +1,16 @@
+# How to connect Trello
+
+1. Open the organization you want to connect to Trello.
+2. Visit **Organization settings**.
+3. Under **Integrations**, expand **Trello**.
+4. Select **Connect Trello**.
+5. Authorize NobGit in Trello.
+6. The callback page saves the token returned by Trello.
+7. Choose a **Board** and **List**.
+8. Select **Save Trello destination**.
+
+Trello is configured from organization settings so the organization can use the selected board and list as its Trello destination.
+
+- [Previous: webhooks](How to connect webhooks.md)
+
+- [Next: Cloudflare](Deploy with Cloudflare.md)
diff --git a/How to connect webhooks.md b/How to connect webhooks.md
new file mode 100644
index 0000000..2dbb95d
--- /dev/null
+++ b/How to connect webhooks.md	
@@ -0,0 +1,15 @@
+# How to connect webhooks
+
+1. Open repository settings for the repository. The repository settings path follows `/:owner/:repo/settings`.
+2. Expand **Webhooks** under **Integrations**.
+3. Enter a **Name**.
+4. Choose **Generic JSON** for normal HTTP JSON endpoints, or **Discord** only for Discord webhook URLs.
+5. Enter an HTTP or HTTPS **Webhook URL**.
+6. Keep **Enable webhook** checked.
+7. Select **Add webhook**.
+
+NobGit immediately attempts a test delivery. Push payloads include `event`, `repository`, `changes`, and `delivered_at`.
+
+- [Previous: Slack](How to connect Slack.md)
+
+- [Next: Trello](How to connect Trello.md)
diff --git a/How to create an access token.md b/How to create an access token.md
new file mode 100644
index 0000000..6717a26
--- /dev/null
+++ b/How to create an access token.md	
@@ -0,0 +1,19 @@
+# How to create an access token
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Access**.
+4. Open **Git access**.
+5. Find **Expiring access token**.
+6. Enter a recognizable **Name**, such as `Work laptop` or `CI deploy`.
+7. Choose an expiration date if the form asks for one.
+8. Select **Create token**.
+9. Copy the token when NobGit shows it. You will not be able to view the full token again later.
+
+Use access tokens for Git over HTTPS. When Git asks for credentials, enter your NobGit username as the username and paste the access token as the password.
+
+You can revoke active tokens later from **Access** under **Git access** and **Active tokens**.
+
+- [Previous: Import from GitHub](Import from GitHub.md)
+
+- [Next: SSH key](How to upload an SSH key.md)
diff --git a/How to create an org.md b/How to create an org.md
new file mode 100644
index 0000000..7994a7a
--- /dev/null
+++ b/How to create an org.md	
@@ -0,0 +1,14 @@
+# How to create an org
+
+1. Click your account menu in the top right.
+2. Click **Organizations**.
+3. Select **New organization**.
+4. Enter the organization **Name**.
+5. Add an optional **Description**.
+6. Optionally upload a PNG, JPG, WEBP, or GIF profile photo.
+7. Select **Create organization**.
+8. After creating the organization, use **Organization settings** to update the organization profile, add members, create teams, connect Trello, and configure SAML SSO.
+
+- [Previous: transfer repo](How to transfer a repo.md)
+
+- [Next: AI inside NobGit](Enable AI inside NobGit.md)
diff --git a/How to create repo.md b/How to create repo.md
new file mode 100644
index 0000000..b3bc57b
--- /dev/null
+++ b/How to create repo.md	
@@ -0,0 +1,26 @@
+# How to create repo
+
+1. Select **New repo** in the top bar, or [import from GitHub](Import from GitHub.md).
+2. Choose an **Owner**: your personal namespace or an organization you own.
+3. Enter a **Repository name**. NobGit converts it into a URL-safe slug.
+4. Add an optional **Description**.
+5. Choose **Private** or **Public** visibility.
+6. Select **Create repository**.
+
+After creation, the repository is available at this canonical NobGit URL:
+
+```
+https://www.nobgit.com/{your username or org}/{repo name}
+```
+
+Example:
+
+```
+https://www.nobgit.com/alex/payment-service
+```
+
+We suggest creating a repository named `.nobgit` for your profile or organization. NobGit uses that special repository's `README.md` to customize the profile or organization page.
+
+- [Previous: get started](How to get started.md)
+
+- [Next: Import from GitHub](Import from GitHub.md)
diff --git a/How to get started.md b/How to get started.md
new file mode 100644
index 0000000..c10ffba
--- /dev/null
+++ b/How to get started.md	
@@ -0,0 +1,20 @@
+# How to get started
+
+1. Visit [NobGit](https://www.nobgit.com).
+2. Select **Sign up**.
+3. Create your account with an email address. Alternatively, choose **Continue with Cloudflare**, or click **More sign-in options** to sign up with Google or LinkedIn.
+4. After signing in, use your dashboard for your workspace and Explore for public repositories.
+5. Before pushing code, open Git access settings and create either an expiring HTTPS access token or add an SSH key.
+6. For extra account protection, open security settings and add a passkey or authenticator OTP.
+
+## Useful first actions
+
+Create your first repository, add SSH or GPG keys, set up account security, and connect integrations when you need notifications or deployments.
+
+We suggest creating a repository named `.nobgit`. It is a special repository that lets you customize your profile or organization page with a `README.md`.
+
+An [SSH key](How to upload an SSH key.md) or [access token](How to create an access token.md) is required to [push code to NobGit](How to commit to NobGit.md). Password authentication is not supported.
+
+- [Previous: Docs home](NobGit Docs.md)
+
+- [Next: create repo](How to create repo.md)
diff --git a/How to link your Discord account with NobGit.md b/How to link your Discord account with NobGit.md
new file mode 100644
index 0000000..61e12e5
--- /dev/null
+++ b/How to link your Discord account with NobGit.md	
@@ -0,0 +1,18 @@
+# How to link your Discord account with NobGit
+
+1. Join the [NobGit Discord server](https://discord.gg/upwECGnD9P).
+2. Open the channel called **verify**.
+3. Click **Verify NobGit Account**.
+4. Click **Verify NobGit Account** again.
+5. A page will open in your preferred web browser.
+6. Press **Continue with Discord**.
+7. Log in with Discord and authorize the login.
+8. Your Discord account is now linked to your NobGit account.
+
+## To unlink your Discord account from NobGit
+
+Follow [Disconnect accounts and integrations](Disconnect accounts and integrations.md).
+
+- [Previous: passkey or OTP](How to add a passkey or OTP.md)
+
+- [Next: disconnect accounts](Disconnect accounts and integrations.md)
diff --git a/How to set up SSO for organizations.md b/How to set up SSO for organizations.md
new file mode 100644
index 0000000..32b3eb0
--- /dev/null
+++ b/How to set up SSO for organizations.md	
@@ -0,0 +1,18 @@
+# How to set up SSO for organizations
+
+1. Open the organization that should use SSO.
+2. Visit **Organization settings**.
+3. Expand **SAML 2.0 SSO**.
+4. Copy the NobGit **ACS URL** and **Entity ID / Metadata URL** into your identity provider.
+5. Check **Enable SAML SSO**.
+6. Enter the IdP Entity ID, IdP SSO URL, optional IdP SLO URL, and IdP X.509 certificate.
+7. Confirm attribute names for email, username, and display name.
+8. Optionally restrict **Allowed email domains**.
+9. Optionally enable **Create NobGit users on first SAML login**.
+10. Select **Save SAML settings**, then use **Test SAML sign-in**.
+
+Use the NobGit service provider values shown in the SAML panel when configuring your identity provider.
+
+- [Previous: Cloudflare](Deploy with Cloudflare.md)
+
+- [Next: Docs home](NobGit Docs.md)
diff --git a/How to transfer a repo.md b/How to transfer a repo.md
new file mode 100644
index 0000000..364bb07
--- /dev/null
+++ b/How to transfer a repo.md	
@@ -0,0 +1,12 @@
+# How to transfer a repo
+
+1. Open the repository you would like to transfer.
+2. Visit **Settings**.
+3. On the right, find **Transfer**.
+4. Enter the destination organization or account.
+5. Confirm the transfer with your passkey, OTP, or password.
+6. After confirmation, NobGit moves the repository to the destination owner.
+
+- [Previous: disconnect accounts](Disconnect accounts and integrations.md)
+
+- [Next: create org](How to create an org.md)
diff --git a/How to upload a GPG key.md b/How to upload a GPG key.md
new file mode 100644
index 0000000..63c113f
--- /dev/null
+++ b/How to upload a GPG key.md	
@@ -0,0 +1,49 @@
+# How to upload a GPG key
+
+## Generate and export a GPG key
+
+Install GPG first if your system does not already include it. Use the same email address you use for Git commits.
+
+### Windows
+
+1. Install **Gpg4win**.
+2. Open **PowerShell**.
+3. Run `gpg --full-generate-key`.
+4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
+5. List your keys with `gpg --list-secret-keys --keyid-format=long`.
+6. Export the public key with `gpg --armor --export KEY_ID`.
+
+### macOS
+
+1. Install GPG with **GPG Suite** or Homebrew.
+2. Open **Terminal**.
+3. Run `gpg --full-generate-key`.
+4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
+5. List your keys with `gpg --list-secret-keys --keyid-format=long`.
+6. Export the public key with `gpg --armor --export KEY_ID`.
+
+### Linux
+
+1. Install GPG from your package manager if needed.
+2. Open your terminal.
+3. Run `gpg --full-generate-key`.
+4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
+5. List your keys with `gpg --list-secret-keys --keyid-format=long`.
+6. Export the public key with `gpg --armor --export KEY_ID`.
+
+## Upload the key to NobGit
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Access**.
+4. Open **Git access**.
+5. Find **GPG keys**.
+6. Enter a key **Name**.
+7. Paste the ASCII-armored public key into **Public key**. It normally starts with `-----BEGIN PGP PUBLIC KEY BLOCK-----`.
+8. Select **Add GPG key**.
+
+NobGit syncs the GPG keyring after the key is saved.
+
+- [Previous: SSH key](How to upload an SSH key.md)
+
+- [Next: commit to NobGit](How to commit to NobGit.md)
diff --git a/How to upload an SSH key.md b/How to upload an SSH key.md
new file mode 100644
index 0000000..1845674
--- /dev/null
+++ b/How to upload an SSH key.md	
@@ -0,0 +1,46 @@
+# How to upload an SSH key
+
+## Generate an SSH key
+
+Use an Ed25519 key unless your system requires a different key type.
+
+### Windows
+
+1. Open **PowerShell**.
+2. Run `ssh-keygen -t ed25519 -C "[email protected]"`.
+3. Press **Enter** to accept the default file location.
+4. Optionally enter a passphrase when prompted.
+5. Copy the public key with `Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub`.
+
+### macOS
+
+1. Open **Terminal**.
+2. Run `ssh-keygen -t ed25519 -C "[email protected]"`.
+3. Press **Enter** to accept the default file location.
+4. Optionally enter a passphrase when prompted.
+5. Copy the public key with `cat ~/.ssh/id_ed25519.pub`.
+
+### Linux
+
+1. Open your terminal.
+2. Run `ssh-keygen -t ed25519 -C "[email protected]"`.
+3. Press **Enter** to accept the default file location.
+4. Optionally enter a passphrase when prompted.
+5. Copy the public key with `cat ~/.ssh/id_ed25519.pub`.
+
+## Upload the key to NobGit
+
+1. Click your account menu in the top right.
+2. Click **Settings**.
+3. Open **Access**.
+4. Open **Git access**.
+5. Find **Optional SSH key**.
+6. Enter a recognizable **Key name**, such as `Work laptop`.
+7. Paste the public key into **Public key**. It should start with a type such as `ssh-ed25519`.
+8. Select **Add SSH key**.
+
+Use the SSH clone URL shown in the repository clone panel after the key is saved.
+
+- [Previous: access token](How to create an access token.md)
+
+- [Next: GPG key](How to upload a GPG key.md)
diff --git a/How to upload and use releases.md b/How to upload and use releases.md
new file mode 100644
index 0000000..f284625
--- /dev/null
+++ b/How to upload and use releases.md	
@@ -0,0 +1,118 @@
+# How to upload and use releases
+
+## Create a release
+
+1. Open the repository where you want to publish release files.
+2. Click **Releases**.
+3. Select the option to upload or create a release.
+4. Enter a release title.
+5. Enter the release version.
+6. Upload release asset files by dragging and dropping them into the upload area, or click the upload area and choose files from your computer.
+7. Review the uploaded assets.
+8. Save or publish the release.
+
+## Use a release
+
+1. Open the repository.
+2. Click **Releases**.
+3. Open the release you want to use.
+4. Download the release assets you need.
+5. Use checksum or signature files, such as `.sha256` or `.sig`, when the project provides them.
+
+## Supported asset formats
+
+Each uploaded file must be **100 MB or smaller**.
+
+Most release archives, installers, packages, binaries, checksums, and signatures are supported.
+
+### Show supported file extensions
+
+`.zip` `.7z` `.rar` `.tar` `.tgz` `.gz` `.bz2` `.xz` `.exe` `.msi` `.msp` `.ipa` `.app` `.apk` `.aab` `.dmg` `.pkg` `.deb` `.rpm` `.jar` `.war` `.ear` `.nupkg` `.gem` `.whl` `.crate` `.vsix` `.bin` `.run` `.wasm` `.sha256` `.sig`
+
+### Signing and checksums
+
+A GPG public key must already be uploaded to NobGit under **Settings**> **Access**> **Git access**> **GPG keys**.
+
+For each release asset, generate a detached signature and a checksum file:
+
+- `<asset filename>.asc`
+- `<asset filename>.sha256`
+
+### Windows PowerShell example
+
+```
+$key = "211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
+$asset = "release\project-1.0.0-win-x64.msi"
+
+gpg --armor --local-user $key --detach-sign `
+  --output "$asset.asc" `
+  $asset
+
+(Get-FileHash $asset -Algorithm SHA256).Hash.ToLower() + "  " + $asset | Set-Content "$asset.sha256"
+
+gpg --verify "$asset.asc" $asset
+```
+
+### macOS Terminal example
+
+```
+key="211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
+asset="release/project-1.0.0-macos-universal.dmg"
+
+gpg --armor --local-user "$key" --detach-sign \
+  --output "$asset.asc" \
+  "$asset"
+
+shasum -a 256 "$asset" > "$asset.sha256"
+
+gpg --verify "$asset.asc" "$asset"
+```
+
+### Linux terminal example
+
+```
+key="211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
+asset="release/project-1.0.0-linux-x64.tar.gz"
+
+gpg --armor --local-user "$key" --detach-sign \
+  --output "$asset.asc" \
+  "$asset"
+
+sha256sum "$asset" > "$asset.sha256"
+
+gpg --verify "$asset.asc" "$asset"
+```
+
+Upload each asset with its matching signature and checksum:
+
+```
+project-1.0.0-win-x64.exe
+project-1.0.0-win-x64.exe.asc
+project-1.0.0-win-x64.exe.sha256
+
+project-1.0.0-macos-universal.dmg
+project-1.0.0-macos-universal.dmg.asc
+project-1.0.0-macos-universal.dmg.sha256
+
+project-1.0.0-linux-x64.tar.gz
+project-1.0.0-linux-x64.tar.gz.asc
+project-1.0.0-linux-x64.tar.gz.sha256
+```
+
+A successful local verification should report a good signature from the key owner.
+
+The `.asc` filename must exactly match the asset filename plus `.asc`. NobGit pairs each asset and signature by filename.
+
+```
+Correct:
+project-1.0.0-win-x64.msi
+project-1.0.0-win-x64.msi.asc
+
+Incorrect:
+project.msi.asc
+project-1.0.0.asc
+```
+
+- [Previous: commit to NobGit](How to commit to NobGit.md)
+
+- [Next: Wiki](How to use Wiki.md)
diff --git a/How to use Wiki.md b/How to use Wiki.md
new file mode 100644
index 0000000..9b0a7d4
--- /dev/null
+++ b/How to use Wiki.md	
@@ -0,0 +1,40 @@
+# How to use Wiki
+
+Wiki is the best way to give users knowledge about your code, project decisions, setup steps, and release notes that do not belong directly in the repository README.
+
+## Create wiki pages in the web UI
+
+1. Open any repository that needs a wiki.
+2. Open **Wiki**.
+3. Create a page manually from the web UI.
+4. Give the page a clear title and write the content in Markdown.
+5. Save the page.
+
+## Use a wiki repository
+
+You can also manage wiki pages with Git by using the repository's `.wiki` repo. For example, if a NobGit repository is called `DotSlash`, its wiki repo is called `dotslash.wiki`.
+
+This lets you push Markdown files to the wiki. The wiki repo is normally hidden from search and does not show in your regular repository list. To make changes, open the repository that has the wiki.
+
+## Wiki file format
+
+Wiki pages are Markdown files. Use clear file names so each page maps cleanly to one wiki page.
+
+```
+How to get started.md
+How to create repo.md
+How to create an access token.md
+```
+
+You can also organize pages into folders:
+
+```
+Get started/
+How to get started.md
+How to create repo.md
+How to create an access token.md
+```
+
+- [Previous: releases](How to upload and use releases.md)
+
+- [Next: passkey or OTP](How to add a passkey or OTP.md)
diff --git a/How to use the NobGit MCP.md b/How to use the NobGit MCP.md
new file mode 100644
index 0000000..9db6c03
--- /dev/null
+++ b/How to use the NobGit MCP.md	
@@ -0,0 +1,37 @@
+# How to use the NobGit MCP
+
+Use this MCP server URL in an MCP-capable client:
+
+```
+https://nobgit.com/mcp
+```
+
+1. When the client opens the NobGit authorization page, sign in with your NobGit account.
+2. Review the client that is asking to connect.
+3. Select the repositories the client should be allowed to use.
+4. Choose whether the connection should have optional write access or read-only access.
+5. Authorize the connection only after the selected repositories and access level look correct.
+
+## Repository access
+
+The MCP connection can only use repositories you select during authorization. It stays inside your existing NobGit permissions and does not grant access to repositories your NobGit account cannot already access.
+
+Read access allows the client to inspect selected repository metadata, branches, commit summaries, README files, text file contents, language breakdowns, and issues.
+
+## Write access
+
+Optional write access lets MCP tools create issues in selected repositories where your NobGit account already has write access.
+
+Write access never allows direct pushes, branch modifications, repository deletion, permission changes, or organization administration.
+
+Leave write access unchecked when you only want the client to read repository information.
+
+## Revoke access
+
+You can revoke MCP access at any time from your NobGit account settings.
+
+MCP provides a standards-based way to connect NobGit with AI assistants and developer tools. Additional native integrations may be added in the future.
+
+- [Previous: AI inside NobGit](Enable AI inside NobGit.md)
+
+- [Next: Slack](How to connect Slack.md)
diff --git a/Import from GitHub.md b/Import from GitHub.md
new file mode 100644
index 0000000..22b56e6
--- /dev/null
+++ b/Import from GitHub.md	
@@ -0,0 +1,19 @@
+# Import from GitHub
+
+1. Click [New repo](https://www.nobgit.com/new).
+2. Select **Import from GitHub**.
+3. Select **Connect GitHub**.
+4. Choose where to configure the **NobGit Importer** in GitHub.
+5. Select the GitHub repositories you want to import.
+6. Choose whether each imported repository should belong to you or to one of your organizations.
+7. If you want to rename a repository during import, enter a new name.
+8. Choose the repository **Visibility**.
+9. Select **Import selected** to import only the checked repositories, or **Import all available** to import every available repository.
+
+## GitHub connection lifetime
+
+The GitHub token can be manually disconnected, or it will automatically expire after one hour.
+
+- [Previous: create repo](How to create repo.md)
+
+- [Next: access token](How to create an access token.md)
diff --git a/NobGit Docs.md b/NobGit Docs.md
new file mode 100644
index 0000000..2b2960e
--- /dev/null
+++ b/NobGit Docs.md	
@@ -0,0 +1,47 @@
+# NobGit Docs
+
+Practical guides for setting up repositories, account security, organizations, integrations, deployments, and SSO in NobGit.
+
+## Guides
+
+- [How to get started](How to get started.md)
+
+- [How to create repo](How to create repo.md)
+
+- [Import from GitHub](Import from GitHub.md)
+
+- [How to create an access token](How to create an access token.md)
+
+- [How to upload an SSH key](How to upload an SSH key.md)
+
+- [How to upload a GPG key](How to upload a GPG key.md)
+
+- [How to commit to NobGit](How to commit to NobGit.md)
+
+- [How to upload and use releases](How to upload and use releases.md)
+
+- [How to use Wiki](How to use Wiki.md)
+
+- [How to add a passkey or OTP](How to add a passkey or OTP.md)
+
+- [How to link your Discord account with NobGit](How to link your Discord account with NobGit.md)
+
+- [Disconnect accounts and integrations](Disconnect accounts and integrations.md)
+
+- [How to transfer a repo](How to transfer a repo.md)
+
+- [How to create an org](How to create an org.md)
+
+- [Enable AI inside NobGit](Enable AI inside NobGit.md)
+
+- [How to use the NobGit MCP](How to use the NobGit MCP.md)
+
+- [How to connect Slack](How to connect Slack.md)
+
+- [How to connect webhooks](How to connect webhooks.md)
+
+- [How to connect Trello](How to connect Trello.md)
+
+- [Deploy with Cloudflare](Deploy with Cloudflare.md)
+
+- [How to set up SSO for organizations](How to set up SSO for organizations.md)
diff --git a/Page not found.md b/Page not found.md
new file mode 100644
index 0000000..6305ac3
--- /dev/null
+++ b/Page not found.md	
@@ -0,0 +1,5 @@
+# Page not found
+
+The page you requested does not exist in NobGit Docs.
+
+[Return to NobGit Docs](NobGit Docs.md)