GeneXus.Next.CLI 1.0.0

GeneXus.Next.CLI (gxnext)

Command-line client for the GeneXus Next MCP server. gxnext exposes the server's tools (Knowledge Base operations, builds, exports, …) as terminal subcommands — suitable for use from CI, shell scripts, or AI coding agents.

Installation

dotnet tool install --global GeneXus.Next.CLI

No need to pick a platform-specific package — the .NET tool resolver automatically selects the right Native-AOT build for your runtime. Supported runtimes: win-x64, linux-x64, osx-arm64. After install, the executable is on PATH as gxnext.

Prerequisites

• .NET 10 SDK — required to install the tool. The automatic per-platform resolution relies on .NET 10's RID-specific dotnet tool support.
• A running GeneXus MCP server reachable at http://127.0.0.1:1989/mcp by default. Override with --server <url> or the GXNEXT_MCP_SERVER environment variable.

Usage

Subcommands are derived at runtime from the MCP server's tools/list response — they reflect whatever tool set your server exposes today.

gxnext --help                # list available subcommands
gxnext list-tools            # short table: name + description
gxnext list-tools --json     # full JSON schemas (machine-readable)
gxnext <subcommand> --help   # options for a specific subcommand
gxnext --refresh-tools ...   # bypass the local schema cache

Tool names are kebab-case (e.g. open-knowledge-base, build-all, export-kb-to-text). The exact set is server-configurable; run gxnext list-tools against your target server for the live catalog.

Output modes

Mutually-exclusive flags:

The last line of every run is a structured RESULT: summary (in quiet/verbose) or a kind:result JSON entry (in --json) — that's the contract scripts should parse to determine the outcome.

Exit codes

• 0 — success
• 1 — failure
• 130 — interrupted (Ctrl+C)

License & usage

The gxnext CLI is licensed under Apache 2.0. It is a client for the GeneXus MCP server, which is a separate product distributed under its own license and terms — installing this CLI does not grant any rights to the GeneXus server or product, and obtaining and using them requires a valid GeneXus license. Third-party components bundled in this package (e.g. System.CommandLine) are covered by their own licenses.