Quickstart

Five minutes from sign-up to your first commit. By the end of this page you’ll have created an account, minted a write-scoped token, and pushed a file to a fresh repo using the SDK.

Head to app.githosted.dev/login and sign in with GitHub or Google. Public beta — free.

A personal organization and a default workspace are created automatically. You’ll be able to rename the workspace from the welcome screen.

2. Create a write-scoped token

In the web admin, click your workspace → Tokens → Create Token:

Kind: Workspace (lets the token create new repos in this workspace)
Permission: Write
Expiration: 90 days

Copy the gw_… value when it appears. It’s only shown once.

3. Install the SDK

pip install githosted

Or in TypeScript:

npm install @githosted/sdk

4. Write your first file

from githosted import Client

client = Client(token="gw_…")
repo = client.create_repo("hello")

repo.write(
    "README.md",
    "# hello\n\nMy first githosted repo.\n",
    message="Initial commit",
)

print("Committed:", repo.log(limit=1)[0].sha)

Run it. You should see your first commit’s SHA print to stdout.

5. Verify

Open the web admin → workspace → hello. The file tree shows README.md; the commit log shows your “Initial commit”. You can also clone the repo locally:

# One-time setup — opens the browser, stores the token in your
# OS keychain, configures git's credential helper.
curl -fsSL https://githosted.sh | sh
gho auth login

# Now plain git clone works — no token in the URL, no prompt.
git clone https://githosted.dev/<workspace>/hello.git

The SDK and git are two windows into the same repo.

No CLI installed? The dashboard’s repo page has a Clone button with a copy-paste setup block that wires git’s http.extraHeader against api.githosted.dev. One paste, then git clone works the same way.

What next