kctl-glpi

GLPI IT asset management CLI — manage tickets, assets, users, entities, plugins, and health for your GLPI IT Service Management platform.

Installation

uv tool install kctl-glpi

Requires kctl-lib>=0.4.0 (installed automatically).

For workspace development:

cd /path/to/kodemeio-skills
uv sync --all-extras --all-packages

Configuration

Config lives in ~/.config/kodemeio/config.yaml under the glpi service key, using the standard Kodemeio profile system.

# Interactive setup
kctl-glpi config init

# Add a named profile
kctl-glpi config add --profile production \
  --url https://glpi.kodeme.io \
  --app-token <glpi-app-token> \
  --user-token <glpi-user-token>

# Switch active profile
kctl-glpi config use production

# Show current config (secrets masked)
kctl-glpi config show

Example ~/.config/kodemeio/config.yaml entry:

profiles:
  kodemeio:
    glpi:
      url: https://glpi.kodeme.io
      app_token: ${GLPI_APP_TOKEN}
      user_token: ${GLPI_USER_TOKEN}

Use -p/--profile or KCTL_GLPI_PROFILE env var to select a profile.

Command Groups

Examples

Ticket Management

# List all open tickets
kctl-glpi -p production tickets list

# Get a specific ticket
kctl-glpi -p production tickets get 1234

# Create a new ticket
kctl-glpi -p production tickets create \
  --title "Network outage in server room" \
  --description "Switches unreachable since 09:00" \
  --priority 4

# Assign ticket to a user
kctl-glpi -p production tickets assign 1234 --user-id 42

# Close a resolved ticket
kctl-glpi -p production tickets close 1234

Asset Inventory

# List all computer assets
kctl-glpi -p production assets list

# Get details for a specific asset
kctl-glpi -p production assets get 56

# Create a new asset record
kctl-glpi -p production assets create \
  --name "srv-prod-01" \
  --serial "SN12345ABC"

# List available asset types
kctl-glpi -p production assets types

User and Entity Management

# Search for a user
kctl-glpi -p production users search --query "john"

# List entity hierarchy
kctl-glpi -p production entities tree

# View entity details
kctl-glpi -p production entities get 1

Health and Diagnostics

# Quick health check
kctl-glpi -p production health check

# Full dashboard status
kctl-glpi -p production health dashboard

# AI-ready diagnostic summary (for agent workflows)
kctl-glpi -p production --json doctor ai-summary

Global Options

Development

cd packages/kctl-glpi
uv sync --all-extras
uv run pytest tests/ -v
uv run mypy src/
uv run ruff check src/
uv build

Standards

Follows the Kodemeio CLI standard — profile inheritance, --json machine output, doctor ai-summary, commands list --json for agent discovery, and skill generate for SKILL.md auto-generation.