Forge support

Email [email protected]. Include your macOS version and, if a file misbehaves, the file itself if you can share it — Forge works on plain files, so you can open them in a text editor first and remove anything private.

Common questions

Which files does Forge open?

Markdown, plain text and source code (Swift, JavaScript, TypeScript, Python, Go, Rust, C and C++, Java, Kotlin, Ruby, SQL, HTML, CSS, YAML, TOML, shell scripts and more), CSV and TSV, JSON and XML, Word documents, PowerPoint and Keynote decks, PDFs and images. Markdown, text, code and spreadsheets are editable; Word, slide decks, PDFs and images open for reading, and a Word document can be exported as Markdown.

Will other apps open what I write?

Yes. Forge saves Markdown as ordinary .md files and spreadsheets as ordinary CSV, in the folder they came from. There is no library or database; if you stop using Forge, your files are exactly where you left them.

Forge asked for access to a folder

The macOS sandbox lets Forge see only what you open. A document opened on its own comes with access to that one file — not the images beside it or the documents it links to. The one-time "Grant Access" prompt is how you allow it. Choose the folder it points at; the permission is remembered. Opening the whole folder from the sidebar avoids the prompt altogether.

Committing and syncing with git

Open a folder that is a git repository and turn on Settings ▸ General ▸ Show git status: changed files get a dot. The Changes panel in the sidebar lists them; write a short message and press Commit & Sync to commit everything, bring in what's new from GitHub, and push. If your changes overlap with someone else's, Forge stops before making a mess: it backs out the merge, keeps your commit, and tells you.

Signing in with GitHub

Settings ▸ Favorites ▸ Sign in with GitHub… shows a short code; enter it on the GitHub page that opens and approve Forge. Forge then works with your repositories over HTTPS, with the token kept in your Keychain and renewed automatically. To work with a repository that isn't on your Mac yet, add it under Favorites ▸ Repositories and open it: Forge clones it for you.

My repository uses an SSH remote

The sandbox keeps apps away from your SSH keys, so Forge talks to GitHub over HTTPS using your GitHub sign-in, even when the repository's remote is a [email protected]: address. Nothing in the repository's settings is changed. Syncing works with GitHub; repositories hosted elsewhere show their status and commit locally, but Forge can't push to them yet. Your GitHub token is only ever sent to GitHub.

Where do pasted images go?

Next to the document, as ordinary image files — or into a subfolder you choose in Settings ▸ Images. You can also send images to your own S3-compatible bucket (Amazon S3, Cloudflare R2, Backblaze B2 and others), per document; credentials stay in your Keychain.

Finding a file quickly

⌘P opens Quick Open: type part of a name to jump to any file in the folder. The search field at the bottom of the sidebar filters the tree.

Exporting and printing

File ▸ Export… writes a Markdown document as PDF, HTML or Word. File ▸ Header & Footer… sets what appears at the top and bottom of exported and printed pages.

Requirements

macOS 26 or later. Apple silicon recommended.