Moovent Developer Environment Setup Guide

Developer Environment Setup Guide

What’s in this guide

Part 1

Moovent Stack

Install & run your local dev environment

Part 2

Terminal

CMUX — the recommended terminal

Part 3

Claude Code

Skills & plugins to install

Why we built this

What is Moovent Stack?

Moovent Stack is your dev environment — everything you need to work on Moovent
We built it so setup is plug and play — no manual config needed
One command starts all services, installs dependencies, and keeps everything up to date
A visual dashboard lets you start, stop, and monitor everything

Prerequisites

Install these before anything else

Install Dependencies

Terminal# Homebrew (macOS package manager)
/bin/bash -c "$(curl -fsSL ...Homebrew/install/HEAD/sh)"
 
# Node.js 20 (via nvm)
brew install nvm
nvm install 20 && nvm use 20
 
# Python 3.11+
brew install python@3.11
 
# Git + GitHub CLI
brew install git gh

Recommended terminal: We recommend CMUX — see the dedicated slide later in this deck.

Installation

One command, that’s it

Install Moovent Stack

Terminal# Install moovent-stack
brew install moovent-stack
 
# Verify installation
moovent-stack --version
 
# Launch (every time)
moovent-stack

Auto-updates: Moovent Stack automatically checks for updates when you launch it. If a new version is available, it will update itself — no action needed on your side.

First Run Setup

Three steps on your first launch

1

Infisical Credentials

Enter your Client ID and Client Secret
These will be provided to you by Geoffrey or Thibaud
Moovent Stack verifies your access against the Moovent project
Credentials are never stored on disk — only used at runtime

Host: EU Infisical
https://eu.infisical.com

What it does: Securely gives you access to all the config your dev environment needs

Note: You only need to enter these once — it remembers you

2

Workspace & GitHub

Choose install path (default: ~/Documents/Moovent-stack)
Click Connect GitHub to authorize via OAuth
If you don’t have access yet, ask Geoffrey or Thibaud to add you to the Moovent GitHub org

One-time setup: Opens your browser to authorize — takes 10 seconds

After that: Moovent Stack handles all git operations for you

Repos: mqtt_dashboard_watch and dashboard

3

Repo & Branch Selection

Geoffrey or Thibaud will give you access to the repos you need — you may get one or both depending on what you'll be working on
Pick a branch per repo (default: main)
Click Install Selected — repos are cloned, .env config written
Admin Dashboard starts automatically at 127.0.0.1:9000

The Admin Dashboard

Your command center at 127.0.0.1:9000

Service Ports

Four services, each on its own port

:9000

Admin Dashboard

127.0.0.1:9000

:8000

MQTT Backend

Backend API

:3000

MQTT Frontend

Admin interface

:4000

Dashboard UI

Main web app

Dashboard Features

Feature	Description
Service Cards	Live status for each service — listening or not listening
Start / Stop / Restart	Control each service individually with one click
Real-time Logs	See what each service is doing in real time
Git Integration	See your current branch and status at a glance
Update Detection	Tells you when updates are available
One-click Update	Update and restart with one click
Branch Switching	Switch branches safely from the dashboard

Terminal Setup

The right tool for the job

Recommended

CMUX Terminal

The terminal built for coding agents. Native macOS app powered by Ghostty.

Vertical tabs — see git branch, working directory & ports at a glance
Notification rings — panes light up when agents need attention
Split panes — run multiple agents side by side
In-app browser — view PRs alongside your terminal

cmux.com

# Install via Homebrew
brew tap manaflow-ai/cmux
brew install --cask cmux

# Update later
brew upgrade --cask cmux

Free & open source
Native Swift + AppKit, no Electron. GPU-accelerated.

Claude Code Setup

Skills & plugins to supercharge your workflow

Add the Grill Me Skill

Stress-test your plans & designs before building. Ask Claude to add this skill:

Claude Code

# Add the grill-me skill

/skill add grill-me "Interview me relentlessly about every
  aspect of this plan until we reach a shared
  understanding..."

When to use: Type /grill-me whenever you want Claude to challenge your plan or design before you start building.

Install Impeccable Plugin

Beautiful, polished UI & design quality tools for Claude Code

Claude Code# Add the marketplace source
/plugin marketplace add pbakaus/impeccable
 
# Then install the plugin
/plugin install impeccable

Reference: impeccable.style — all available commands and design patterns

Install Visual Explainer Plugin

Generate diagrams, slide decks & visual documentation from code

Claude Code# Add the marketplace source
/plugin marketplace add nicobailon/visual-explainer
 
# Install the plugin
/plugin install visual-explainer@visual-explainer-marketplace

Reference: github.com/nicobailon/visual-explainer — source & documentation

You're all set

You're Ready

To start working, just run moovent-stack and you're good to go

If you have any issues, contact geoffrey@moovent.io