Files
stack/packages/mosaic/framework/tools/glpi/README.md
Jason Woltje b38cfac760
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
feat: integrate framework files into monorepo under packages/mosaic/framework/
Moves all Mosaic framework runtime files from the separate bootstrap repo
into the monorepo as canonical source. The @mosaic/mosaic npm package now
ships the complete framework — bin scripts, runtime configs, tools, and
templates — enabling standalone installation via npm install.

Structure:
  packages/mosaic/framework/
  ├── bin/          28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.)
  ├── runtime/      Runtime adapters (claude, codex, opencode, pi, mcp)
  ├── tools/        Shell tooling (git, prdy, orchestrator, quality, etc.)
  ├── templates/    Agent and repo templates
  ├── defaults/     Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.)
  ├── install.sh    Legacy bash installer
  └── remote-install.sh  One-liner remote installer

Key files with Pi support and recent fixes:
- bin/mosaic: launch_pi() with skills-local loop
- bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses
- bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find
- bin/mosaic-link-runtime-assets: Pi settings.json patching
- bin/mosaic-migrate-local-skills: Pi skill roots, symlink find
- runtime/pi/RUNTIME.md + mosaic-extension.ts

Package ships 251 framework files in the npm tarball (278KB compressed).
2026-04-01 21:19:21 -05:00

1.6 KiB

GLPI Tool Suite

Manage GLPI IT service management (tickets, computers/assets, users).

Prerequisites

  • jq and curl installed
  • GLPI credentials in ~/src/jarvis-brain/credentials.json (or $MOSAIC_CREDENTIALS_FILE)
  • Required fields: glpi.url, glpi.app_token, glpi.user_token

Authentication

GLPI uses a two-step auth flow:

  1. session-init.sh exchanges app_token + user_token for a session_token
  2. All subsequent calls use the session_token + app_token

The session token is cached at ~/.cache/mosaic/glpi-session and auto-refreshed when expired.

Scripts

Script Purpose
session-init.sh Initialize and cache API session
computer-list.sh List computers/IT assets
ticket-list.sh List tickets (filter by status)
ticket-create.sh Create a new ticket
user-list.sh List users

Common Options

  • -f json — JSON output (default: table)
  • -l limit — Result count (default: 50)
  • -h — Show help

API Reference

  • Base URL: https://help.uscllc.com/apirest.php
  • Auth headers: App-Token + Session-Token
  • Pattern: RESTful item-based (/ItemType/{id})

Examples

# List all tickets
~/.config/mosaic/tools/glpi/ticket-list.sh

# List only open tickets
~/.config/mosaic/tools/glpi/ticket-list.sh -s new

# Create a ticket
~/.config/mosaic/tools/glpi/ticket-create.sh -t "Server down" -c "Web server unresponsive" -p 4

# List computers as JSON
~/.config/mosaic/tools/glpi/computer-list.sh -f json