CLI Reference

The neoengine CLI is the primary way to interact with the NeoEngine network.

Installation


# macOS / Linux
curl -fsSL https://get.neoengine.dev | sh
 
# Windows (PowerShell)
irm https://get.neoengine.dev/windows | iex
 
# Verify installation
neoengine --version

Global Flags

Flag	Description
`--help`, `-h`	Show help for any command
`--version`, `-v`	Show CLI version
`--config`	Path to config file
`--network`	Network to use (mainnet, testnet, devnet)
`--json`	Output in JSON format
`--quiet`, `-q`	Suppress non-essential output

Commands

auth

Authentication commands.


neoengine auth login      # Authenticate with browser
neoengine auth logout     # Clear credentials
neoengine auth status     # Check authentication status

wallet

Wallet and balance management.


neoengine wallet balance      # Check NGNX balance
neoengine wallet earnings     # View provider earnings
neoengine wallet withdraw     # Withdraw earnings
neoengine wallet history      # Transaction history

stake

Staking management for providers.


neoengine stake deposit <amount>   # Stake NGNX tokens
neoengine stake withdraw <amount>  # Unstake tokens (begins unbonding)
neoengine stake status             # View stake details

job

Job submission and management.


neoengine job submit [flags]       # Submit a new job
neoengine job status <job-id>      # Check job status
neoengine job logs <job-id>        # View job logs
neoengine job results <job-id>     # Download job results
neoengine job cancel <job-id>      # Cancel a running job
neoengine job list                 # List your jobs

Submit flags:

Flag	Description
`--image`	Container image to use
`--cpu`	CPU cores to request
`--memory`	Memory to request (e.g., 4Gi)
`--gpu`	Number of GPUs
`--gpu-type`	GPU type preference
`--script`	Command to run
`--input`	Input files/directories
`--output`	Output directory
`--max-price`	Maximum price willing to pay
`--timeout`	Job timeout duration

provider

Provider management commands.


neoengine provider register       # Register as a provider
neoengine provider status         # View provider status
neoengine provider hardware       # Show detected hardware
neoengine provider pricing set    # Update pricing
neoengine provider config         # View/edit configuration

daemon

Daemon control for providers.


neoengine daemon start            # Start the daemon
neoengine daemon stop             # Stop the daemon
neoengine daemon restart          # Restart the daemon
neoengine daemon status           # Check daemon status
neoengine daemon logs             # View daemon logs
neoengine daemon install          # Install as system service

guild

Guild management.


neoengine guild list              # List available guilds
neoengine guild join <guild-id>   # Apply to join a guild
neoengine guild leave             # Leave current guild
neoengine guild status            # View guild membership
neoengine guild create            # Create a new guild (Tier 3+)

market

Market information.


neoengine market prices           # Current market rates
neoengine market providers        # Browse providers
neoengine market stats            # Network statistics

Configuration

Config file location: ~/.neoengine/config.toml


[network]
default = "mainnet"
 
[provider]
auto_accept = true
max_concurrent_jobs = 5
reserved_cpu = 2
reserved_memory = "4Gi"
 
[pricing]
cpu = 0.02
memory = 0.01
gpu = 0.75
storage = 0.002

Environment Variables

Variable	Description
`NEOENGINE_CONFIG`	Path to config file
`NEOENGINE_NETWORK`	Default network
`NEOENGINE_KEY`	Wallet private key (not recommended)