Quick start
Once Resomark is installed, there's one thing to do: add a folder you already use as a Workspace. Then open the files in it to read and write. When your AI tools change something in that folder, the files they changed are listed at the top of the sidebar.
The first time you open Resomark, the sidebar already has a sample Workspace, Welcome to Resomark, where you can try seeing, keeping and reverting changes first. If you remove it and want a fresh one later, choose Help > Add Sample Workspace.
1. Open Resomark for the first time
Section titled “1. Open Resomark for the first time”The first time you open Resomark after installing it, three welcome pages appear. Choose a Folder… on the last page takes you straight to adding a Workspace. You can also click Skip and see the pages again later under Help > Welcome to Resomark.
If you opened Resomark by double-clicking a file, the welcome pages and the sample Workspace wait until the next normal launch, so you see your file first.
When no file is open, the main window says "Open a folder you already work in." with three buttons below it:
- New Document (press N)
- Open Folder or File… (press O)
- Connect to Remote (SSH)…
2. Add a Workspace
Section titled “2. Add a Workspace”- Click Choose a Folder… on the last welcome page, or choose File > Add Workspace….
- In the window that opens, click Choose… and pick a folder. You can also drag a folder from Finder onto the card in that window.
- Read what the card says:
- The folder isn't in Git: the card has a Track Changes switch, on by default. With it on, Resomark records every change other apps (AI tools included) make to the folder, and keeps version history for text files. Track Changes is part of Plus. If this Mac hasn't had a trial before, the 14-day free trial already started the first time you opened Resomark, with no account and no card. See Free, Plus and the 14-day trial.
- The folder is a Git repository: the card says Git repository. Changes and commit history come straight from Git, and there's no switch.
- The folder is inside a Git repository: the card suggests using the repository's folder instead (a button named Use “repository name”). Branches and commits are only available from the repository's root folder.
- Click Add Workspace.
The Workspace appears under Workspaces on the sidebar's Home page. Click it and the sidebar shows that folder's file tree.
3. Read and write
Section titled “3. Read and write”- Click a file in the sidebar to open it. Markdown files show their formatting as you write, and the line with the cursor shows the source.
- You don't need to save by hand: Resomark saves when you stop typing, switch to another file or close the tab. You can also press ⌘S.
- Press ⌘N for a new document, and give it a name in the title at the top of the editor.
- Press ⌘P to find a file, folder or command by name.
4. Let the AI make changes, then come back
Section titled “4. Let the AI make changes, then come back”Open the same folder in your AI tool and have it change some files. Back in Resomark:
- A Changes section appears at the top of the folder page, listing the files that changed. File names change color too: green for added, red for deleted, yellow for modified.
- Open a changed file and the changes are marked in the formatted text.
- In a folder outside Git, you can keep or revert each change; in a Git repository, you see the changes that haven't been committed yet.
For the details, see Work with your AI.