TALXIS.CLI 1.0.4

TALXIS CLI (txc)

WARNING This project is in active development and not yet production-ready. We welcome feedback, suggestions, and contributions via pull requests.

TALXIS CLI (txc) is a modular, extensible .NET global tool for automating development, data, and solution management tasks—especially for Power Platform and enterprise projects. It is designed to help developers scaffold, transform and manage code and data in local repositories.

MCP Server Support:

This CLI can also be consumed as a Model Context Protocol (MCP) server by installing the related .NET tool txc-mcp. This enables integration with tools and workflows that support the MCP standard.

• For setup and usage instructions, see src/TALXIS.CLI.MCP/README.md in this repository.

Installation

Install as a .NET global tool:

dotnet tool install --global TALXIS.CLI

Update to the latest version:

dotnet tool update --global TALXIS.CLI

After installation, use the CLI via the txc command in any terminal.

Command Groups & Usage

The CLI is organized into modular command groups. Each group provides a set of related commands.

Data Commands (txc data)

Data utilities for modeling, migration, ETL, and integration scenarios.

• txc data transform: Data-related utilities for ETL, Power Query, and migration.

  • txc data transform server start [--port <port>]: Starts a local HTTP server for ETL/data transformation tasks. Default port: 50505.
    • Endpoints:
      • POST /ComputePrimaryKey — Deterministically computes a GUID primary key from entity and alternate keys.

• txc data package: Configuration migration tool (CMT) for moving data between environments.

  • txc data package convert --input <file.xlsx> --output <file.xml>: Converts tables from an Excel .xlsx file to a CMT data package XML.

• txc data model: Data modeling utilities (see CLI help for available features).

Workspace Commands (txc workspace)

Develop and manage solution components in your local workspace.

• txc workspace component: Manage solution components.
  • txc workspace component list: List available component templates.
  • txc workspace component create <ShortName> [--output <path>] [--param key=value ...]: Scaffold a component from a template, passing parameters as needed.
  • txc workspace component explain <Name>: Show details about a component template.
  • txc workspace component parameter list <ShortName>: List parameters required for a specific component template.

Docs Commands (txc docs)

Knowledge base and documentation for TALXIS CLI and its usage.

Example Usage

# Start the data transformation server on default port
$ txc data transform server start

# Convert Excel to CMT XML
$ txc data package convert --input export.xlsx --output data.xml

# List available workspace components
$ txc workspace component list

# Scaffold a new component
$ txc workspace component create mycomponent --output ./src --param Name=MyComponent --param Type=Custom

# List parameters for a component template
$ txc workspace component parameter list mycomponent

Local Development & Debugging

1. Clone the repository and restore dependencies:

   git clone <repo-url>
   cd tools-cli
   dotnet restore
   

2. Build the solution:

   dotnet build
   

3. Run the CLI directly (for example, to test the data transform server):

   dotnet run --project src/TALXIS.CLI -- data transform server start
   

4. Debug using Visual Studio or VS Code as needed.

Versioning & Release

• Versioning is managed in Directory.Build.props (Microsoft-style versioning).
• Releases are published to NuGet.org via GitHub Actions.

Collaboration

We welcome collaboration! For feedback, suggestions, or contributions, please submit issues or pull requests.

For onboarding or customization, contact us at hello@networg.com.