Sign-up and Sync
You don't need an account to use Hillnote on your own computer. Create one in the app or at hillnote.com to sync and share workspaces, use premium models and routines, and more! Paid plans add more, like publishing, extra storage and your own API keys. To sync a workspace, click on the Sync tab in the sidebar of a workspace.
To sign in:
- On the home screen, click Login.
- Choose Continue with Google, Continue with Apple or Continue with GitHub and finish in your browser. Or choose Continue with email: Sign In with your password, or Sign Up and enter the 6-digit code you're emailed.

Once you're signed in, the person icon on the home screen opens your account menu, with your plan, usage and Account settings.
All free accounts also get limited usage of premium models! ✨
Sync
Syncing backs a workspace up to your account, so you can open it on your other computers and share it.
- Open the workspace and click the Sync tab in the sidebar.
- Click Sync this Workspace.
- If you have several accounts, choose one. Click Sync.

Every document and resource uploads to that account's cloud storage. Files over 100 MB don't sync. The workspace tile at the top of the sidebar shows which account it syncs to.
A few things never sync, such as your Notepad and Hillnote's own hidden folders. Privacy and your data lists them all and explains what else leaves your computer.
Automatic sync
Sync automatically is on by default. Hillnote sends your edits about 30 seconds after you pause (every few minutes if you keep typing), checks for other people's changes every couple of minutes, and syncs before it quits. While someone else edits the page you have open, it syncs every few seconds.
A small ring in the top bar shows the sync status. Hover over it for details, such as Synced just now. If it says sync is paused, see Fix common problems.

To sync by hand instead, turn off Sync automatically in the Sync panel's ⚙ tab. Then use Sync changes in the top bar, or Sync and Pull latest changes in the Sync panel.
Syncing by hand is only in the desktop app. While Sync automatically is off, quitting Hillnote asks whether to Sync and Quit.
The Sync panel
The Sync tab is where all of your sync related controls live.
- Changes shows all of the files changed since the last sync. You can always select files and click Discard to replace them with the cloud version.
- Users shows who shares the workspace (see Share below).
- Activity covers recent sync activity.
- ⚙ shows the account the workspace is Synced to, the Sync automatically switch and the Storage you've used.
Changes and Activity are only in the desktop app.

At the bottom of ⚙, the owner can Disconnect Sync. Local files stay, but the cloud copy is deleted for everyone. Other members see Leave Workspace instead.
To get back an older version of a page, see Version history.
Other computers and offline
To get a synced workspace on another computer, sign in there with the same account. On the home screen, open Workspaces ▸ Synced (desktop app), click the workspace, then Choose a folder... and Download. Each synced workspace is marked Owner, Shared or Shared · Admin.

You can keep working offline. The top bar shows Offline — changes saved locally, and your changes sync when you're back online.
Hillnote in a browser
If Hillnote on the web is available for your account, you can also open app.hillnote.com and sign in with the same account to work on your synced workspaces in a browser.
Changes you make there save straight to your Hillnote cloud, and workspaces you create there open in the desktop app too. If sync pauses, Download unsaved changes saves a copy of the edits that haven't reached the server. The terminal, local AI and local MCP need the desktop app.
When edits overlap
With Sync automatically on, Hillnote merges changes to pages for you, so edits to different parts of a page combine quietly. When two people change the same lines, the page shows both: Current (yours) and Proposed changes (theirs). Hover over the block, then click discard changes to keep yours, Both to keep both, or Accept changes to take theirs. Base, when shown, restores the version you both started from.
In the desktop app, slides, moodboards, and overlaps inside tables, code blocks or properties make a conflict copy instead. Click the orange badge in the top bar to open Conflicts, then choose Keep Local Version, Keep Remote Version or Merge Documents. Uploads wait until you decide. Merge Documents puts both versions into the page as review blocks, so you can settle each difference.
Markdown files outside documents/, such as agents.md, aren't merged: the synced copy replaces yours. More on conflicts in Version history.
Share
There are two ways to share. Both need you to be signed in and the workspace to be synced.
- Share workspace… invites people to everything in a workspace. They download it and edit alongside you.
- Share… invites people to a single page by email or link. They open the same page, and their edits come back to your workspace.
You'll find both in the top bar's ⋮ menu.

Invite people to a workspace
- Open the Sync tab in the sidebar and choose Users, or use the top bar's ⋮ menu ▸ Share workspace….
- Type an Email address, pick Editor or Admin, and click Add.

Collaborators are of 2 types:
- Editors can edit and work on files.
- Admins can also invite people and share pages.
If someone isn't on Hillnote yet, click the envelope (Invite to Hillnote) to email them. They get access when they sign up with that address. A member's ⋮ menu has Make Admin, Make Editor and Remove.
Members download the workspace from Workspaces ▸ Synced on their own computer (see Other computers and offline above).
Share one page
- Open the page and choose Share… from the top bar's ⋮ menu, or from the page's ⋮ menu in the sidebar.
- In Add emails to invite, type up to 20 addresses at a time.
- Choose Can edit or Can view, then click Invite.
Or click Copy link and send the link yourself.
Who has access lists everyone who can open the page, including People in this workspace. Each person's menu has Resend invite and Remove access. Removing someone doesn't delete a copy they already downloaded to the desktop app.

Link access and passwords
The first row under Who has access sets who can open the link: Restricted (only people you add), Anyone with the link (after signing in to Hillnote) or Link + password (they also need a password of at least 6 characters).
For Link + password, type the password and click Set password. People who already joined with the link will need it to join again. With link access, you also choose whether people with the link can edit or only view.

The dialog's ⋯ menu has Reset link, which stops the old link working, and Stop sharing, which removes everyone's access. To see every page you've shared, open the Sync panel's Users tab and look under Shared documents. Each page there has Manage….
What can't be shared
Only the workspace owner or an admin can share pages. Slide decks, moodboards, password-protected pages, collection rows, documents inside a library, the Notepad and pages over 2 MB can't be shared on their own. Pages in a team space can't be shared one by one yet, so share the whole workspace instead.
To send someone a standalone copy of a page instead, use the top bar's ⋮ menu ▸ Send a copy… (desktop app only).
To turn a whole workspace into a public website instead, see Publish.
Pages shared with you
Pages shared with you appear on the home screen under Workspaces ▸ Recent files ▸ Shared with me. Your edits go back to the owner.

When you open a share link, Hillnote asks Open “…”? and shows who shared it.
- If you have several accounts, pick one under Open as.
- If the page has a password, type it under Password.
- Click Open.
The owner sees your name and email address.
The desktop app keeps shared pages in your Shared with me folder, so you can edit them offline. You can change where that folder is in Settings ▸ Advanced. Avoid folders that sync between computers, such as iCloud Drive or OneDrive, because two computers editing the same copies can undo each other's changes.
If you and the owner change the same lines, Hillnote sends nothing until you choose Keep mine, Use theirs or Replace with mine…. Keep mine keeps the owner's other changes too. A shared page's menu has Save a copy to a workspace… and Leave.
See who's here
In a synced workspace, the top bar shows a coloured circle with the initial of each person who has it open. Hover over a circle to see their name and the page they're on.
When someone edits the page you're on, the circles expand with a note saying they're editing. Hillnote then syncs every few seconds, so you see each other's changes quickly.

To leave notes for each other on a page, see Comments and mentions.
Teams
Teams are for companies on the Team plan. When Teams are available for your account, Settings ▸ Team manages members, shared workspaces, AI and billing.
When you join a team, your new synced workspaces go to its team space, where its admins can see them. You can only be in one team. To see what the Team plan includes, visit the pricing page.
Several accounts
In the desktop app, you can be signed in to more than one account at once.
In the account menu, choose Add another account. Each workspace syncs to the account you chose for it.
AI features and credits use your Primary account. To switch, click the make-primary button next to another account. Each account has a Sign out this account button, and Log out all accounts signs out of everything.

Settings shows your primary account's plan and usage. To keep your app preferences the same on every computer too, see Customise Hillnote.
Plans and credits
Hillnote has four plans: Free, Plus, Pro and Ultra. Each plan's card lists what it includes: credits per month or week, synced storage, how many workspaces you can publish, how many routines you can have, and whether you can bring your own API key. To compare them, open Settings ▸ Plans & Subscription and click Upgrade plan (or Change plan). For current prices, see the pricing page.
Change or cancel your plan
- In Settings ▸ Plans & Subscription, click Upgrade plan or Change plan.
- Under Choose your plan, pick Monthly or Yearly.
- Click the plan's button, such as Get Pro or Switch to Pro. If a payment is needed, it finishes in your browser.
Upgrades apply right away. Downgrades take effect when the period you've paid for ends.
Cancel subscription keeps full access until the period ends, then moves you to Free. Resume undoes it. Manage billing opens your payment details in your browser.
How credits work
Credits pay for cloud AI, such as premium models, cloud transcription and voice, Auto Organise and Hillnote Routines. Plan credits are spent first and reset each period. Add-on credits never expire. Local models, Apple Intelligence and on-device transcription are free.
Add-on credits come from purchases and rollover. Total balance is what you can use now.

A few more details:
- The model menu shows what each premium model costs. See Chat with AI.
- Ask AI from search uses credits when you choose a cloud model.
- Enriching or asking a library with a cloud model uses credits. See Library.
- Cloud transcription is charged by the minute of audio, and cloud voice sessions use credits while they run. See Dictation and voice.
- Each routine run uses credits. See Automations.
- Requests on your own API keys don't use credits either; your provider bills you.
To use AI without credits, see Local models.
Check your usage
Open Settings ▸ Usage to see your Credit usage, Storage, when your credits reset, and an Activity list of each credit transaction.

- The Plan card shows Credit usage, Storage and when credits reset (Resets in…).
- The Credit balance card splits Plan credits, Add-on credits and Total balance, with Buy credits.
- Each Activity entry says what used the credits, such as AI chat, Transcription or Plan reset.
The account menu on the home screen also shows your plan, with one bar for credits used and one for storage.
Extra credits and storage
In Settings ▸ Plans & Subscription:
- Extra credits: click Buy credits for a credit pack. Bought credits are add-on credits, so they never expire.
- Extra storage: click Add storage to add synced storage by the gigabyte. Use Change amount to change it later.
If you run out of credits, switch to a local model or buy more. If cloud storage fills up, your changes stop syncing until you free up space or add storage. Other people's changes still arrive.
Use your own API keys
On Plus, Pro and Ultra, AI can run on your own API keys instead of credits. In Settings ▸ API Keys, add a key for Anthropic, OpenAI, Google Gemini or xAI (Grok), then turn on Use my own API keys. Your provider bills you directly.
To add a key, click Get a key next to the provider to create one on its site. Paste the key and click Save. Hillnote checks the key with the provider before saving it.

With your own keys on, premium models are limited to the providers you've added a key for. Keys are encrypted and never shown again after saving. Removing your last key turns Use my own API keys off, and credits are used again. For how keys are stored, see Privacy and your data.