mohManual

Manual/Get started

Install, open, update

Chapter 02 · 2 min read

moh runs on Mac and Linux, and on Windows through WSL (a built-in Windows feature that runs Linux programs). It is one self-contained file: it does not need Node, Bun, npm or any other developer tool installed first.

Install it

  1. Open your terminal. On a Mac, open the app called Terminal. On Windows, open your WSL window (for example Ubuntu from the Start menu).
  2. Paste this line and press enter. It downloads moh, checks that the file is exactly the one that was published, and puts it in place.
    curl -fsSL https://raw.githubusercontent.com/Marco-Cricchio/moh/main/scripts/install.sh | sh
  3. That's it. The installer places moh in ~/.local/bin (a folder for your own programs) and tells you if your terminal needs to be reopened to find it.

If you already use Homebrew, this does the same with the same checked file:

brew install Marco-Cricchio/moh/moh

Windows

Keep your projects inside the Linux side of WSL — for example ~/projects — rather than on a Windows drive under /mnt/c. Everything works on /mnt/c, but every file access crosses into Windows and back, so searches and large edits crawl. moh shows a reminder when it notices.

Open it

moh

The very first run needs nothing at all — no accounts, no keys, no setup. moh starts with a practice AI (called mock) so you can look around safely: nothing you do in this mode touches a real AI service. When you are ready for a real one, connect a provider.

The home screen

Every time you open moh you land on the home screen: a short animation of the logo (any key skips it), then the list of your conversations in this project.

moh — home
type to filter, or start something new
› fix the login form 2 min ago
📌 release checklist yesterday
explain the project 3 days ago
enter open · n new · ctrl+r rename · ctrl+p pin · ctrl+d delete · ? keys
Type to filter the list, or type a new request and press enter to start a conversation with it.
  • enter opens the selected conversation — or starts a new one with what you typed.
  • n starts an empty conversation.
  • o picks up a task you moved from another computer (see handoff).
  • s opens the settings, ? shows every key, q quits.

Keep it up to date

While you work, moh can check whether a new version exists — and it never installs anything without your explicit yes. To update on purpose:

moh update

It downloads the latest release, verifies its checksum and replaces the program in place. Running the installer again does the same. The update check can be switched off in the settings (ctrl+s).

Tip

Starting a brand-new project? moh init creates an AGENTS.md file and a small docs/agents/ folder: a place to write down how your project works, for people and for moh alike.

Written for moh 0.61. Inside moh, ctrl+h opens the built-in manual for your exact version.