XGIC Dev Container CLI

Product-agnostic Docker Compose and Dev Container lifecycle for the modular XGIC CLI.

Namespace: xgic.cli.dev · Console entry: xgic (plugins via entry points) · Brand: XGIC CLI only (ADR-0005)

Standards hub: xgic/ai

Vision

Environment orchestration should be predictable, documented, and AI-operable. This package owns the generic lifecycle that every XGIC Dev Container product needs—up, down, check, logs, shell—without embedding Payload-specific or other product logic.

Humans get a stable command map. AI agents get the same map in AGENTS.md instead of inventing Make targets or host-global installs.

Why this module exists

Ecosystem

Quick start

Install (PyPI)

uv pip install "xgic-dev-cli>=0.2.1"
xgic --help
xgic up --help

Development (editable monorepo layout)

uv pip install -e ../cli
uv pip install -e ".[dev]"
xgic --help
xgic up --help

Typical session

export XGIC_COMPOSE_FILE=.devcontainer/docker-compose.yml
export XGIC_COMPOSE_PROJECT=my-project
export XGIC_PRIMARY_SERVICE=app

xgic up --profile postgres
xgic check
xgic logs
xgic down

Console commands

Registered on the core xgic entrypoint:

Common flags / environment

Note: Payload-specific env regenerate / setup lives in payload-cms-cli (xgic payload env, xgic payload setup, …).

Library API

from xgic.cli.core import EnvironmentContext
from xgic.cli.dev import DockerComposeController

env = EnvironmentContext.detect()
docker = DockerComposeController(
    env=env,
    compose_file=".devcontainer/docker-compose.yml",
    project_name="my-project",
    primary_service="app",
)
docker.up(profile="postgres")

Requirements

• Python 3.14+
• xgic-cli ≥ 0.2.1
• Docker / Docker Compose on the host when running lifecycle commands

Publishing

Follow python-package-release.md.

Publish after xgic-cli for stack releases. Tags: vX.Y.ZrcN → TestPyPI; vX.Y.Z → PyPI.

Working with AI assistants

• Prefer documented xgic lifecycle commands over ad-hoc docker compose one-liners in agent prompts.
• Point agents at AGENTS.md and the hub catalog.
• Public issues/PRs: BASE-STANDARDS public-safe gate.

Contributing

PRs with human UI review only. Conventional Commits; labels required. See CONTRIBUTING.md.

License

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

XGIC — Modular CLI architecture for open-source developer platforms: thin core, domain modules, AI-operable commands.