shikamaru CLI

Spin up multi-repo dev environments with env management, port allocation, Docker/Hybrid orchestration, and real-time interactive centralized logs.

npm install -g shikamaru Get Started

✅ Node ≥16🐳 Docker required for docker/hybrid

$ maru start
✔ Select repositories: api, web, player
✔ Execution mode: hybrid
✔ Ports allocated: saved to ports-map.json
✔ Generated env files from .env.example
→ Web logs: http://localhost:3015

Features

Repo discovery

Pick services to run. Save profiles.

.env generation

From .env.example + cloud + globals.

Port allocation

Avoid conflicts. Persist across runs.

Docker/Hybrid modes

Run locally, in Docker, or mix.

log viewer

real-time interactive centralized logs in web or terminal.

Infra inference

Auto decide Docker vs external DB/queues.

One Command Quick Start

npm install -g shikamaru
maru start

Add global.env and frontend.global.env to your workspace root for all services variables. Use --skip-cloud to avoid fetching from Azure.