| 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.
