GroundControl.Cli 1.0.12-preview

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of GroundControl.Cli. 
dotnet tool install --global GroundControl.Cli --version 1.0.12-preview
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local GroundControl.Cli --version 1.0.12-preview
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=GroundControl.Cli&version=1.0.12-preview&prerelease
                    


                    

                
nuke :add-package GroundControl.Cli --version 1.0.12-preview

GroundControl CLI

Command-line tool for managing a GroundControl configuration server. Packaged as a .NET global tool.

Installation

dotnet tool install -g GroundControl.Cli

Quick Start

# Login to a server
groundcontrol auth login --server-url https://groundcontrol.example.com --method Pat --token <your-token>

# Create organizational structure
groundcontrol scope create --dimension Environment --values "dev,staging,prod"
groundcontrol group create --name "Backend Services"
groundcontrol project create --name "OrderService" --group-id <group-id>

# Add configuration and publish
groundcontrol config-entry create --key "Database:ConnectionString" \
  --owner-id <project-id> --owner-type Project --value-type String \
  --value "default=Server=localhost"
groundcontrol snapshot publish --project-id <project-id>

Global Options

Option Values Default Description
--debug verbose -- Enable debug logging (--debug for Information, --debug verbose for Debug)
--output table, json table Output format
--no-interactive -- false Disable interactive prompts and use defaults

Commands

Command Description
auth Login, logout, and authentication status
group Create, list, update, and delete groups
project Create, list, update, and delete projects
scope Create, list, update, and delete scope dimensions
template Create, list, update, and delete shared templates
variable Create, list, update, and delete reusable variables
config-entry Create, list, update, and delete configuration entries
snapshot Publish and list configuration snapshots
client Create, list, update, and delete API clients
client-config Preview resolved configuration for a client
user Manage users
role Manage roles and permissions
token Manage personal access tokens
audit Query the audit trail
tui Launch the interactive TUI dashboard

TUI Dashboard

Running groundcontrol with no arguments launches an interactive terminal dashboard built with Terminal.Gui. The TUI provides a navigable view of groups, projects, configuration entries, and snapshots.

Configuration

The CLI reads configuration from these sources (in order of precedence):

  1. Command-line arguments
  2. Environment variables (e.g., GroundControl__ServerUrl)
  3. appsettings.local.json (user-specific overrides)
  4. appsettings.json (bundled defaults)

Documentation

See the full CLI reference for detailed command documentation.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.12-preview 90 5/15/2026
1.0.8-preview 76 5/10/2026
1.0.7-preview 67 5/7/2026
1.0.5-preview 93 4/26/2026
1.0.2-preview 90 4/18/2026
1.0.1-preview 73 4/17/2026

https://github.com/mrtaikandi/GroundControl/releases/tag/cli/v1.0.12-preview