# Craftian: account-less temporary git repos

Create a throwaway git repo (with a full backing app/project) without any
login, account, or API key. The unguessable UUID in the URL IS the credential -
anyone who knows it can clone and push.

## Quick start

    git clone https://craftian.ai/git/tmp/$(uuidgen)
    cd <uuid>
    echo "hello" > index.html
    git add -A && git commit -m "init"
    git push origin master

Cloning a UUID that does not exist yet auto-creates the repo and its app/project.
No `.git` suffix is required. No credentials are prompted. The default branch is
`master` - push there so your files are mirrored into the backing app. A freshly
created repo ships with a README.md describing these same facts.

## Publish (go live)

A push stores your files but does not serve them. To publish the static site,
POST to the publish endpoint (no credentials - the UUID is the capability):

    curl -X POST https://craftian.ai/git/tmp/<uuid>/publish

`index.html` at the repo root becomes the served page. The response is JSON with
the live `url`. Static files only (HTML/CSS/JS/images) - there is no build step,
so backend/engine code is not compiled.

## Edit online

Every temp repo is backed by a Craftian project whose id is `tmp-<uuid>` (the
`tmp-` prefix + the same UUID). Open it in the online editor to browse and edit
the project files in your browser:

    https://craftian.ai/go#/_/tmp-<uuid>/

Git pushes and online edits act on the same project files. Visiting the repo URL
itself (https://craftian.ai/git/tmp/<uuid>) in a browser shows a landing page
with the clone command, the editor link, and the time left before expiry.

## Lifetime

- Repos expire 24 hours after the LAST git operation (sliding TTL).
- Any clone/fetch/push resets the timer. Abandoned repos are deleted.
- Repos are org-less and unclaimed; treat them as scratch space.

## Limits

- Max 500 KB per file.
- Repo creation is rate-limited per IP.

See also https://craftian.ai/.well-known/agent.json for the machine-readable manifest.