Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runwita.com/llms.txt

Use this file to discover all available pages before exploring further.

Runwita runs on macOS. A Windows build is on the roadmap. There’s no web version, the whole point is that your data lives on your machine.

​
Download

1

Get the latest build

Head to runwita.com and click the download button. You’ll get a .dmg file named something like Runwita-1.1.10-arm64.dmg. The version number changes; the rest stays the same.
TODO: screenshot of runwita.com download CTA
2

Open the disk image

Double-click the .dmg. A Finder window opens with the Runwita app icon and a shortcut to your Applications folder.
3

Drag to Applications

Drag the Runwita icon onto the Applications shortcut. macOS copies the app over. You can eject the disk image after.
TODO: screenshot of dmg drag-to-applications window
4

Launch

Open Launchpad or your Applications folder and double-click Runwita. The first launch can take a few seconds while macOS verifies the app.

​
”Runwita can’t be opened because Apple cannot check it for malicious software”

If you see this on first launch, it’s because the build isn’t notarised yet. Notarisation is on the roadmap. For now:
1

Open System Settings

Apple menu, then System Settings, then Privacy & Security.
2

Find the Security section

Scroll to the bottom. You’ll see a line that says “Runwita was blocked from use because it is not from an identified developer” with an Open Anyway button next to it.
3

Click Open Anyway

macOS will ask once more, with a more dramatic warning. Click Open. From this point on, the app launches normally, you only need to do this once.
This is a one-time step per machine. If you re-download the same version or update, you don’t need to repeat it.

​
Where Runwita keeps its data

Everything lives at ~/Library/Application Support/Runwita/. Inside that folder:
  • app.db, your journeys, engagements, topics, decisions, actions, and settings, all in one SQLite file.
  • attachments/, image and PDF attachments you’ve added to engagements.
  • a few small WAL files that SQLite uses while the app is running.
Back this folder up however you back up the rest of your machine. Time Machine, Arq, rsync to an external drive, anything that copies ~/Library/Application Support/Runwita/ works. There’s no cloud sync yet, so this folder is your data. If you ever want to start fresh, quit Runwita and delete the folder. Next launch, the app rebuilds an empty database.

​
What’s next

Set up your first journey

A journey is the thread you’ll pull on. You’ll create one in about thirty seconds.