Feature how-tos

A feature's how-to goes in its own file here, docs/features/<name>.md, named for the one feature it describes. Do not add a section to the top-level README.md: it is capped (test/readme-cap.test.ts) because every pull that appended to it collided with the next. Existing README sections stay where they are.

Reference notes

Every note is listed once below, under the topic a reader would look in; the topics follow the guide. A new note gets a row here (test/feature-orphans.test.ts).

What a forge is

Read with the guide page What a forge is.

Your first app in five minutes

Read with the guide page Your first app in five minutes.

Tell the crew

Read with the guide page Tell the crew.

Ship and undo

Read with the guide page Ship and undo.

Your apps

Read with the guide page Your apps.

Files in the browser

Hosting forges for others, and getting paid

Read with the guide page Hosting forges for others, and getting paid.

Bring your own AI

Read with the guide page Bring your own AI.

Agents: MCP, git, or the terminal

Read with the guide page Agents: MCP, git, or the terminal.

Backups and moving

Read with the guide page Backups and moving.

Every setting, by topic

Read with the guide page Every setting, by topic.

When something is wrong

Read with the guide page When something is wrong.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs