ByteNite Dev CLI

The Dev CLI is a tool for developers to create and manage apps on ByteNite.

Download & Install

Quick Installation Script

The following script automates the installation of the ByteNite Dev CLI tool.

#!/bin/bash

# Define variables
ARCH="darwin-arm64" # Available releases: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64, windows-amd64.exe
TARGET_NAME="bytenite"
GLOBAL_PATH="/usr/local/bin/$TARGET_NAME"

# Fetch the latest release download URL
LATEST_RELEASE_URL=$(curl -s https://api.github.com/repos/ByteNite2/bytenite-dev-cli/releases/latest | grep "browser_download_url.*$ARCH" | cut -d '"' -f 4)

if [ -z "$LATEST_RELEASE_URL" ]; then
  echo "Error: Failed to fetch the latest release URL for $ARCH. Exiting."
  exit 1
fi

# Download the file
curl -L -o "$TARGET_NAME" "$LATEST_RELEASE_URL"
if [ $? -ne 0 ]; then
  echo "Error: Failed to download $LATEST_RELEASE_URL. Exiting."
  exit 1
fi

echo "Downloaded $LATEST_RELEASE_URL as $TARGET_NAME."

# Set executable permissions
chmod +x "$TARGET_NAME"
if [ $? -ne 0 ]; then
  echo "Error: Failed to set executable permissions on $TARGET_NAME. Exiting."
  exit 1
fi

echo "Set executable permissions on $TARGET_NAME."

# Move the executable to /usr/local/bin
sudo mv "$TARGET_NAME" "$GLOBAL_PATH"
if [ $? -ne 0 ]; then
  echo "Error: Failed to move $TARGET_NAME to $GLOBAL_PATH. Exiting."
  exit 1
fi

echo "Moved $TARGET_NAME to $GLOBAL_PATH."

# Verify installation
echo "Verifying installation..."
if command -v $TARGET_NAME >/dev/null 2>&1; then
  echo "$TARGET_NAME is successfully installed. Run '$TARGET_NAME --help' to verify."
else
  echo "Error: $TARGET_NAME is not installed correctly. Exiting."
  exit 1
fi

Download the Latest Version

1. Get the latest ByteNite CLI release from GitHub.

   • Executable files are available for Unix-like systems (e.g., Linux, macOS) and Windows.

Rename the Executable

1. For convenience, rename the downloaded file to bytenite to avoid typing the full command bytenite-cli-[release] each time.

Set Executable Permissions

1. Ensure the file has executable permissions:

chmod +x bytenite

Additional Permissions for Mac Users

Mac users have to manually give permissions for the System Settings > Privacy & Security before running a ByteNite command the first time.

Follow the necessary steps as shown in the image below to let your OS know ByteNite is safe to use.

Install Globally (Optional)

1. To install the executable globally, move it to a directory included in your system's PATH, such as /usr/local/bin or /usr/bin. Use the following command:

sudo mv bytenite /usr/local/bin/

Verify Installation

1. Run the executable from anywhere using:

bytenite [command]

---

Authenticate

1. To authenticate, run:

bytenite auth

This will open an oAuth2 authentication page in your browser. The login is automatic if you're already logged in on ByteNite.

After successful authentication, credentials will be stored in the application support or configuration directory:

• Linux: /$HOME/.config/bytenite-cli/auth.json

• Mac: /Users/[user]/Library/Application Support/bytenite-cli/auth.json

---

Commands & Usage

Run the help command to get started with the ByteNite Dev CLI:

bytenite --help

Authentication

• Authenticate with OAuth2: bytenite auth

Version

• Get Dev CLI Version: bytenite version

App Commands

• App Command Info: bytenite app --help

• Initialize New App: bytenite app new [app_id]

• Push/Upload App: bytenite app push [app_dir]

• Pull/Download App: bytenite app pull [app_id]

• Get App Details: bytenite app get [app_id]

• List Existing Apps: bytenite app list

• Activate App: bytenite app activate [app_id]

• Deactivate App: bytenite app deactivate [app_id]

• Get App Status: bytenite app status [app_id]

Template Commands

• Template Command Info: bytenite template --help

• Initialize New Template: bytenite template new [template_id]

• Push/Upload Template: bytenite template push [template.json]

• Pull/Download Template: bytenite template pull [template_id]

• Get Template Details: bytenite template get [template_id]

• List Existing Templates: bytenite template list

Engine Commands

• Engine Command Help: bytenite engine --help

• Initialize New Engine:

  • Partitioner: bytenite engine partitioner new [engine_id]

  • Assembler: bytenite engine assembler new [engine_id]

• Push/Upload Engine: bytenite engine push [engine_dir]

• Pull/Download Engine: bytenite engine pull [engine_id]

• Get Engine Details: bytenite engine get [engine_id]

• List Existing Engines: bytenite engine list