Your first app in five minutes
You need a forge address (the link you were given) and a terminal with git and curl. No account is needed to start; you claim the app afterwards.
1. Start
Replace YOUR-FORGE with the forge's address and run:
curl -sX POST https://YOUR-FORGE/api/v1/start -d '{"name":"my-app"}'
The answer is a small JSON document. Four parts matter:
git.url: where the code lives.token: your password for it. Keep it private.app.url: where the app is live.claim.url: open this in a browser to make the app yours with a real account.
2. Get the code
Take git.url from the answer and put USER:TOKEN@ right after https://, where USER is user.username and TOKEN is token. Then clone it:
git clone https://USER:TOKEN@YOUR-FORGE/OWNER/my-app
(OWNER/my-app is the rest of git.url: copy it as it is.)
3. Change something and push
cd my-app
echo "hello" > NOTES.md
git add . && git commit -m "first change"
git push origin HEAD:main
The forge builds the app on every push to main. A few seconds later app.url shows it. Open it.
4. Make it yours
Open claim.url and choose a user name and password. The app and its token move to your account. An app nobody claims sleeps after 7 days and is archived after 30.
5. Tell the crew
With the forge's forge command installed and signed in, ask for a change in plain words:
forge tell "make the page say hello in big letters"
Or open /talk and type it. What happens next is in Tell the crew.
If something does not work, see When something is wrong. The reference for the command is CLI.md.
Every feature note, by topic: the reference notes.