pks

stable

CLI tool for managing infrastructure, GitHub runners, and Agentic Live services

Author: Poul Kjeldager
Usage: pks <command> [options]
Platform: linuxmacos
Category: infrastructure

Examples

$ pks github runner register my-org/my-repo

Register a GitHub runner for a repository

$ pks agentics runner start

Start an Agentic Live runner

The pks CLI is the primary infrastructure management tool for the Agentic Live platform. It provides subcommands for managing GitHub runners, Agentic Live services, and other infrastructure components.

Run without installing

With .NET 10:

dotnet dnx pks-cli --yes -- --help

With Node.js:

npx @pks-cli/cli --help

Both commands download and run the current CLI without adding a permanent pks command to your PATH.

Permanent installation

.NET global tool

dotnet tool install --global pks-cli

Linux / macOS

curl -fsSL https://agentics.dk/install/pks-cli.sh | bash

Windows (PowerShell)

irm https://agentics.dk/install/pks-cli.ps1 | iex

The script detects your OS/architecture, verifies the sha256 checksum, installs the self-contained pks binary to ~/.local/bin (or %LOCALAPPDATA%\Agentics\bin), and puts it on your PATH. Pin a version with VERSION=1.2.3, opt out of PATH changes with NO_MODIFY_PATH=1.

Alternatively, install globally via npm:

npm install --global @pks-cli/cli

Subcommands

  • github -- Manage GitHub integrations (runners, workflows)
  • agentics -- Manage Agentic Live platform services
  • opencode -- Run OpenCode directly against a Scaleway serverless model (defaults to GLM 5.2)

Subcommands

pks agentics

stable

Manage Agentic Live platform services and runners

pks agentics <command>

1 subcommand

pks github

stable

Manage GitHub integrations including self-hosted runners

pks github <command>

1 subcommand

pks opencode

stable

Run OpenCode directly against a Scaleway serverless model — one command, no proxy, no config file. Defaults to GLM 5.2.

pks opencode [ARGS] [--model <id>]