OSMAP CLI - Embed Map Navigator & Token Manager

A lightweight CLI tool for developers and administrators to manage authentication tokens and quickly navigate or launch OSMAP KAI embed map routes across different environments (live, beta, staging, demo, local).

---

⚡ Quick Start (No Installation Needed)

1. Prerequisites

• Bash (Git Bash, WSL, Linux, or macOS)
• curl
• jq (JSON processor)
  • Windows (PowerShell as Admin): choco install jq -y
  • Ubuntu / Debian / WSL: sudo apt update && sudo apt install -y jq
  • macOS: brew install jq

---

🚀 Running the CLI

Option A: Direct Execution via curl

Using Git Bash / Linux / macOS:

curl -sSL https://git.oslog.pro/dandy/osmap_cli/raw/branch/main/osmap-embed.sh | bash

To pass arguments / flags:

# Open Executive Map directly in browser
curl -sSL https://git.oslog.pro/dandy/osmap_cli/raw/branch/main/osmap-embed.sh | bash -s -- executive --env live --open

# Get all embed URLs for beta environment
curl -sSL https://git.oslog.pro/dandy/osmap_cli/raw/branch/main/osmap-embed.sh | bash -s -- all --env beta

Using Windows PowerShell:

bash -c "curl -sSL https://git.oslog.pro/dandy/osmap_cli/raw/branch/main/osmap-embed.sh | bash"

---

Option B: Clone & Run Locally

git clone https://git.oslog.pro/dandy/osmap_cli.git
cd osmap_cli
chmod +x osmap-embed.sh

# Launch Interactive Menu
./osmap-embed.sh

---

📖 Usage & Commands

./osmap-embed.sh [route|command] [options]

Commands

Command	Description
interactive (default)	Opens an interactive CLI menu to pick routes, copy tokens, or switch environments
all	Prints a formatted table of all map embed URLs with a valid token
token	Fetches and prints the raw active access token only
validate	Checks whether the locally cached token is still valid
revoke	Revokes active tokens on the server and clears local cache
register	Registers a new application and saves credentials

Available Map Routes

Route Identifier	Map Name	Target Path
executive	Executive Map	/executive
rolling	Rolling Map	/rolling
iris-jpl	IRIS JPL	/iris-jpl
iris-jpl-v2	IRIS JPL (v2)	/v2/iris-jpl
accelerometer	Executive Accelerometer	/executive/accelerometer
genset	Genset Monitoring	/genset
managerial	Managerial / Asset View	/managerial
fatigue	Fatigue Monitoring	/fatigue
sigap-tracker	SIGAP Tracker	/sigap-tracker
sigap-dashboard	SIGAP Dashboard	/sigap-dashboard
railway-cargo-system	Railway Cargo System (RCS)	/railway-cargo-system

---

⚙️ Options & Flags

Flag	Description	Default
-e, --env <env>	Target environment (live, beta, staging, demo, local, or custom URL)	live
-o, --open	Automatically open the generated URL in your default browser	false
-c, --copy	Automatically copy the URL to system clipboard	false
--app-id <id>	Override App ID credential	Default Built-in / Env
--app-secret <sec>	Override App Secret credential	Default Built-in / Env
--save	Save provided --app-id and --app-secret to .osmap_credentials	false
-h, --help	Show command line help and usage	-

---

💡 Examples

• Interactive Menu (live environment):

  ./osmap-embed.sh
  

• Open IRIS JPL in browser on Live environment:

  ./osmap-embed.sh iris-jpl --open
  

• Get the raw token string for scripts / automation:

  TOKEN=$(./osmap-embed.sh token --env live)
  echo "Current Token: $TOKEN"
  

• Open Managerial Map on Beta environment:

  ./osmap-embed.sh managerial --env beta --open
  

• Test against Local development server (http://localhost:8000):

  ./osmap-embed.sh --env local
  

---

🔐 Credentials & Configuration Precedence

Credentials are automatically loaded in the following order:

1. CLI Flags (--app-id, --app-secret)
2. Environment Variables (OSMAP_APP_ID, OSMAP_APP_SECRET)
3. Local config file (.osmap_credentials)
4. Current directory .env file
5. Built-in default credentials