CLI-referentie

De comp-hub CLI biedt een set commando's om je lokale dev-server te beheren. Meerdere projecten kunnen tegelijk draaien, elk met een eigen poort.

De CLI wordt geleverd met drie binaire namen — comphub, ch en comp-hub — die allemaal naar hetzelfde programma wijzen. Alle onderstaande commando's werken met elk van deze namen, bijvoorbeeld ch status, comp-hub -p 8080.

Overzicht van commando's

Commando	Beschrijving
comphub	Start de dev-server voor het huidige project
comphub status	Bekijk de status van de master en alle draaiende projecten
comphub stop <hash>	Stop een specifiek project
comphub stop --all	Stop alle projecten
comphub kill	Sluit het master-proces af
comphub fix	Los veelvoorkomende problemen op (verouderd runtime-bestand, enz.)

---

comphub — Server starten

Voer dit uit in de map van het project om de dev-server te starten en componenten in de browser te previewen.

comphub

Opties:

Optie	Kort	Type	Standaard	Beschrijving
--port	-p	number	5478	Servicepoort
--dir	-d	path	"./"	Relatief pad naar de resourcemap
--log-level	-l	string	"error"	Logniveau: debug, info, warn, error

| --version | -v | - | - | Toon versie | | --help | -h | - | - | Toon help |

--port geldt alleen als er nog geen master-proces draait. Als er al een master actief is, hergebruikt de CLI die en wordt een waarschuwing getoond dat -p wordt genegeerd; voer eerst comphub kill uit als je echt een andere poort nodig hebt.

Voorbeelden:

# Starten met de standaardpoort
comphub

# Een eigen poort gebruiken
comphub -p 8080

# Map opgeven
comphub -d ./src

Na een succesvolle start zie je de projectinformatie en de toegangs-URL:

✓ comp-hub v0.44.11

   ██████╗  ██████╗  ███╗   ███╗ ██████╗       ██╗  ██╗ ██╗   ██╗ ██████╗
  ██╔════╝ ██╔═══██╗ ████╗ ████║ ██╔══██╗      ██║  ██║ ██║   ██║ ██╔══██╗
  ██║      ██║   ██║ ██╔████╔██║ ██████╔╝      ███████║ ██║   ██║ ██████╔╝
  ██║      ██║   ██║ ██║╚██╔╝██║ ██╔═══╝       ██╔══██║ ██║   ██║ ██╔══██╗
  ╚██████╗ ╚██████╔╝ ██║ ╚═╝ ██║ ██║           ██║  ██║ ╚██████╔╝ ██████╔╝
   ╚═════╝  ╚═════╝  ╚═╝     ╚═╝ ╚═╝           ╚═╝  ╚═╝  ╚═════╝  ╚═════╝


  Version  0.44.11
  Project  D:\project\housing\vue2
  Hash     94525912
  Port     5478

  URL      http://localhost:5478/94525912/main/

  ─────────────────────────────────────────────

  comphub status                View all projects
  comphub stop    94525912      Stop current project
  comphub stop    --all         Stop all projects
  comphub kill                  Shutdown master

Open de URL in je browser om het platform te openen.

Gedrag bij het starten

• Versiecontrole: voordat de CLI start, vraagt hij aan de externe service of de geïnstalleerde versie nog is toegestaan. Als de huidige versie is geblokkeerd, stopt het starten met comp-hub must be upgraded before it can start; voer npm install comp-hub@latest -g uit en start opnieuw. Als er alleen een nieuwere versie beschikbaar is, wordt een melding getoond en start de CLI gewoon.
• Logstream: na de banner streamt de CLI de MidwayJS-logs van dit project (SSE). Druk op Ctrl+C om te stoppen — het project wordt dan automatisch bij de master uitgeschreven.

---

comphub status — Status bekijken

Bekijk welke projecten op dit moment draaien.

comphub status

Voorbeeld van de uitvoer:

● Master Status

  Status      ● running
  Version     0.44.11
  Uptime      2m
  Projects    2

  ▸ Registered Projects (2):
  ────────────────────────────────────────────────────────
    hash     94525912
    path     D:\project\housing\vue2
    url      http://localhost:5478/94525912/main/
  ────────────────────────────────────────────────────────
    hash     a3f82109
    path     D:\project\housing\vue3
    url      http://localhost:5478/a3f82109/main/
  ────────────────────────────────────────────────────────

Als er geen service draait:

✗ Master service is not running

---

comphub stop — Projecten stoppen

Stop een of alle draaiende projecten zonder de andere te beïnvloeden.

# Eén specifiek project stoppen (gebruik status om de hash te vinden)
comphub stop <hash>

# Alle projecten stoppen
comphub stop --all

Voorbeelden:

# Project met hash 94525912 stoppen
comphub stop 94525912

# Alle projecten in één keer stoppen
comphub stop --all

---

comphub kill — Alle services afsluiten

Sluit alle projecten en services af.

comphub kill

Dit beëindigt het master-proces en alle geregistreerde projecten. Voer comphub opnieuw uit om weer te starten.

---

comphub fix — Veelvoorkomende problemen oplossen

Ruim verouderde runtime-bestanden op en los andere veelvoorkomende problemen op:

comphub fix

Dit is handig wanneer:

• Een eerdere afsluiting een verouderd procesbestand heeft achtergelaten dat een nieuwe start blokkeert
• Je de lokale runtime-status opnieuw wilt instellen

---

Meerdere projecten draaien

Je kunt verschillende projecten op hetzelfde moment draaien:

# Terminal 1: project A starten
cd /path/to/project-a
comphub

# Terminal 2: project B starten
cd /path/to/project-b
comphub

# Alle actieve projecten bekijken
comphub status

Elk project krijgt zijn eigen poort en is bereikbaar via een andere URL.