OpenCLI

Command-line interface (CLI) tool for open.mp server management and Pawn project building with package management system.

Documentation

• Wiki Home
• Package Management
• Compiler Options
• Docker Guide
• Contributing

Features

• Package Management - Install libraries like sscanf, mysql from GitHub
• Compiler Management - Automatic compiler download and caching
• Security First - Integrity verification with Argon2 hash
• Progress Tracking - Real-time download and build monitoring
• Build Performance - See how fast your projects compile
• Comprehensive Logging - Complete activity logs for debugging

Installation

From Release

Download the latest binary for your platform from Releases.

Linux/macOS:

tar -xzf opencli-*.tar.gz
sudo mv opencli /usr/local/bin/
opencli --version

Windows: Extract the ZIP and add to PATH.

From Source

git clone https://github.com/mxp96/open-cli
cd open-cli
cargo build --release

Binary will be in target/release/opencli.

Using Docker

docker pull ghcr.io/mxp96/open-cli:latest
docker run --rm -v $(pwd):/workspace ghcr.io/mxp96/open-cli:latest --help

Quick Start

# Setup new project
opencli setup

# Install Pawn compiler
opencli install compiler

# Install packages
opencli package install Y-Less/sscanf

# Build project
opencli build

# Run server
opencli run

Package Management

Install Packages

# Install all packages from opencli.toml
opencli package install

# Install specific package
opencli package install Y-Less/sscanf
opencli package install "Y-Less/sscanf=2.13.8"
opencli package install Y-Less/sscanf --target components

# With version constraints
opencli package install "Y-Less/sscanf=^2.13.7"

Manage Packages

# List installed packages
opencli package list

# Remove package
opencli package remove Y-Less/sscanf

# Update packages
opencli package update Y-Less/sscanf
opencli package update --all

# Check integrity
opencli package check

Version Constraints

[packages]
"owner/repo" = "^x.y.z"              # Compatible updates
"owner/repo" = "~x.y.z"              # Patch updates only
"owner/repo" = ">=x.y.z, <a.b.c"     # Range constraint
"owner/repo" = "latest"              # Always latest
"owner/repo" = "x.y.z"               # Exact version

Configuration

Create opencli.toml with opencli setup:

[build]
entry_file = "gamemodes/gamemode.pwn"
output_file = "gamemodes/gamemode.amx"
compiler_version = "v3.10.11"

[build.includes]
paths = ["include"]

[build.args]
args = ["-d3", "-;+", "-(+", "-\\+", "-Z+"]

[packages]
"Y-Less/sscanf" = { version = "^2.13.8", target = "components" }

Building

# Default build
opencli build

# Verbose output
opencli build --verbose

# Force compiler re-download
opencli build --force-download

# Update compiler config
opencli build --update-config

Development

# Format code
cargo fmt --all
make docker-format  # Using Docker

# Run linter
cargo clippy --all-targets --all-features

# Run tests
cargo test --release

# Docker development
docker compose up dev

See CONTRIBUTING.md for more details.

Requirements

• Rust 1.89.0+ (for building from source)
• Internet connection (first time setup)
• open.mp server binary (for running servers)

Contributors

Thanks to all contributors who made this project possible:

Made with contrib.rocks.

License

MIT License - Copyright (c) 2025 Matthias Theodore "mxp96" Bartholomew. See LICENSE for details.

Inspired by sampctl