launch

name	launch
description	Use when the user wants to run, launch, start, or preview the markrig desktop app — the viewer/editor for the Markdown plan files Claude Code generates.

Launch markrig

markrig is a standalone desktop app. Launch the installed copy, passing the current project folder so the app opens with it imported:

• macOS: open -a markrig --args "$PWD"
• Linux: run the installed markrig binary or AppImage with the folder as the first argument: markrig "$PWD" &

If the app is already running, the argument is ignored — the existing window is activated; the user can switch folders via its recents or Import Folder button.

If the launch command fails because the app is not installed, do not guess at alternatives — tell the user to install it first via the instructions at https://github.com/RiggdAI/markrig#installation (Homebrew cask once released, or build from source).

Exception: if the current working directory is a clone of the markrig repo itself, run the dev build instead, as a background task from the repo root (everything after the third -- goes to the app binary):

npm run tauri dev -- -- -- "$PWD"

The first dev run compiles the Rust crate (1–2 minutes); the window opens when the build finishes, and a clean exit means the window was closed. Do NOT run npm run dev alone — outside the Tauri runtime the frontend only shows a placeholder message.