xgic-cli 0.2.0

XGIC CLI — modular command-line framework for XGIC tools and environment orchestration (core package).

XGIC CLI

XGIC CLI is the modular command-line framework for XGIC tools.

This repository is the thin core package (xgic.cli, console entry xgic). It is product-agnostic: no Payload CMS or Dev Container orchestration implementations live here.

Package	Namespace	Repository
Core (this repo)	xgic.cli	xgic/cli
Dev Container / env	xgic.cli.dev	xgic/dev-cli
Payload CMS	xgic.cli.payload	xgic/payload-cms-cli

Architecture: ADR-0005 - Modular XGIC CLI.

Multi-repo standards: xgic/ai.

Publishing to PyPI: follow the hub standard
python-package-release.md
(TestPyPI RC + smoke → PyPI via OIDC Trusted Publishing; uv build/smoke).
Tags: vX.Y.ZrcN → TestPyPI; vX.Y.Z → PyPI. Requires GitHub Environments testpypi / pypi and matching Trusted Publishers on the index.

Status

0.2.0 — thin core. Framework + environment detection + output helpers. Domain modules ship separately.

Requirements

• Python 3.14+

Install (development)

python -m pip install -e ".[dev]"
xgic --help
xgic --version
xgic info

Console commands (core)

Command	Purpose
xgic --help	Top-level help
xgic --version	Package version
xgic info	Detected execution environment summary

Domain packages register additional subcommands via entry point group xgic.cli.commands.

Library API (core only)

from xgic.cli.core import EnvironmentContext, EnvironmentType
from xgic.cli.utils.output import print_info, print_error
from xgic.cli.app import CommandContext, build_parser, main

Module	Role
xgic.cli.app	Parser, plugin loading, dispatch
xgic.cli.core.environment	Host / Dev Container / container detection
xgic.cli.utils.output	Rich console helpers

Plugin entry points

[project.entry-points."xgic.cli.commands"]
my_module = "my_package.cli:register"

def register(subparsers):
    p = subparsers.add_parser("example", help="...")
    p.set_defaults(func=run_example)

Handlers may accept a CommandContext or (args, env=...).

License

Apache License 2.0. See LICENSE and NOTICE.
Copyright form: Copyright 2026 XGIC.