Log In and Connect

• In Gitfox, go to “Gitfox > Settings” (Shortcut: Cmd+,).
• Visit the Accounts tab in the Settings window.
• Click “Add Account > GitHub > oAuth”.
• Click “OK” in the “Organization Repositories” dialog.
• You web browser will open to a page to log in to GitHub.
• Log in.
• Approve connecting Gitfox and GitHub.

Clone Repository

• In the left-hand sidebar of Gitfox, look for the “Stimpunks” folder in the “Service Accounts” section.
• Select the repository to clone: Papers or Why-Sheets.
• Click the Clone button.
• Clone all repositories you want to work with in Ulysses.

Add External Folders

In Ulysses, add the repositories you cloned as external folders.

• To find out the folder a repository is stored in, select the repository in the “Repositories” section of the sidebar in Gitfox.
• Secondary click on the repository name and choose “Reveal in Finder”.
• In Ulysses, visit “File > Add External Folder”.
• In the file picker, navigate to the folder revealed with “Reveal in Finder”.
• Tip: You can drag and drop the folder from the “Reveal in Finder” window to the file picker.
• The external folders will show at the bottom of the Ulysses Library window.
• Edit the sheets directly in the external folders.

Review Changes

After making changes in Ulysses, review those changes in Gitfox.

• In Gitfox, select a repository by double-clicking it in the “Repositories” list.
• This will bring up the “Worktree” view. This is the only view you need to use.
• If there are modified files in the repository, they will be counted at the top of the Worktree as “1 modified file”.
• Click “Inspect Changes” to view a diff of all changes.

Commit

• Select the checkbox next to all files you want to commit.
• Click “Commit”.
• Add a descriptive commit message.
• Click “Commit”.

Push

• Click the Push button in the toolbar to push the changes to GitHub.

Pull

• Click the Pull button in the toolbar to pull the latest changes pushed to GitHub.