cli

README

OrchCLI - KubeOrch Developer CLI

OrchCLI is a command-line tool for developing with the KubeOrch platform. It streamlines local development, testing, and contribution workflows for cloud-native applications.

Installation

Native Install (Recommended)

macOS, Linux, WSL:

curl -sfL https://raw.githubusercontent.com/KubeOrch/cli/main/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/KubeOrch/cli/main/install.ps1 | iex

Windows CMD:

curl -fsSL https://raw.githubusercontent.com/KubeOrch/cli/main/install.cmd -o install.cmd && install.cmd && del install.cmd

Via NPM

npm install -g @kubeorch/cli

Via Go

go install github.com/kubeorch/cli@latest

From Source

git clone https://github.com/KubeOrch/cli
cd cli
make install

Advanced Options

# Install specific version
curl -sfL https://raw.githubusercontent.com/KubeOrch/cli/main/install.sh | ORCHCLI_VERSION=v0.0.5 sh

# Install to custom directory
curl -sfL https://raw.githubusercontent.com/KubeOrch/cli/main/install.sh | ORCHCLI_INSTALL_DIR=~/.local/bin sh

# Uninstall
curl -sfL https://raw.githubusercontent.com/KubeOrch/cli/main/install.sh | sh -s -- --uninstall

Features

• Concurrent Operations - Fast parallel execution for cloning, pulling, and health checks
• Safe Configuration Management - File locking prevents corruption during concurrent access
• Multiple Project Support - Manage multiple KubeOrch projects seamlessly
• Auto-detection - Automatically determines development mode based on cloned repositories
• Hot Reload - All development modes support hot reload for rapid iteration

Commands

Command	Description
orchcli init	Initialize environment
orchcli start	Start services
orchcli stop	Stop services
orchcli restart [service]	Restart services
orchcli logs	View service logs
orchcli status	Check service status
orchcli exec <service> [command]	Execute command in service container
orchcli debug	Debug service connectivity

Common Flags

• orchcli start -d - Run services in background
• orchcli stop -v - Remove volumes when stopping
• orchcli logs -f - Follow log output
• orchcli logs --tail 50 - Show last 50 lines
• orchcli init --fork-ui - Clone UI repository
• orchcli init --fork-core - Clone Core repository

Quick Start

Production Mode

# Initialize and start services
orchcli init
orchcli start -d

# Access application
# UI: http://localhost:3001
# API: http://localhost:3000

# View logs
orchcli logs -f

# Stop services
orchcli stop

Development Mode

# Clone repositories for development
orchcli init --fork-ui --fork-core

# Start PostgreSQL
orchcli start -d

# Start Core (Terminal 1)
cd core && air

# Start UI (Terminal 2)  
cd ui && npm run dev

# Access: UI at localhost:3001, API at localhost:3000

Frontend Development Only

# Clone UI repository
orchcli init --fork-ui

# Start backend services in Docker
orchcli start -d

# Start UI development server
cd ui && npm run dev

Backend Development Only

# Clone Core repository
orchcli init --fork-core

# Start all services (Core with hot reload)
orchcli start -d

# Edit Core files locally - changes auto-reload
# Access: UI at localhost:3001, API at localhost:3000

Documentation

• Architecture - System design and development modes
• Configuration Management - Config system with file locking
• Concurrent Operations - Parallel task execution
• Release Process - How to create releases
• Publishing - NPM and GitHub release process
• Automated Release - CI/CD pipeline details

Contributing

See the contributing guide.

License

Apache 2.0