@orbitpanel/cli

Orbit CLI v5 — gestione hosting AI-powered da terminale.

Collega il lavoro di sviluppo locale alla piattaforma Orbit con sessioni tracciate, report strutturati, comandi remoti e integrazione LLM via MCP.

Installazione

npm install -g @orbitpanel/cli

Quick Start

orbit                     # Avvia la shell interattiva

Al primo avvio, l'onboarding wizard ti guida in 30 secondi:

╭──────────────────────────────────────────╮
│ ORBIT CLI v5.0.0                         │
│                                          │
│ Come iniziare:                           │
│   1. Accedi            /auth             │
│   2. Seleziona sito    /sites            │
│   3. Avvia sessione    /session start    │
╰──────────────────────────────────────────╯

Workflow in 5 passi

| Passo | Comando | Cosa fa | |-------|---------|---------| | 1 | /auth | Autenticazione via browser (device flow) | | 2 | /sites | Selezione interattiva del sito | | 3 | /session start | Avvia sessione di lavoro | | 4 | /note, /task add, /decision | Annota il lavoro | | 5 | /report | Invia report e chiudi |

Dopo ogni passo la CLI mostra il prossimo passo automaticamente.

Comandi principali

Sessione

| Comando | Alias | Descrizione | |---------|-------|-------------| | /session start | /ss | Avvia sessione di lavoro | | /session end | /se | Chiudi sessione | | /session | | Info sessione attiva | | /note | /n | Aggiungi nota | | /task add | /ta | Crea task | | /task done | /td | Completa task | | /decision | /dec | Registra decisione | | /report | /r | Invia report a Orbit | | /history | /hist | Sessioni passate |

Interventi

| Comando | Alias | Descrizione | |---------|-------|-------------| | /list | /ls | Lista interventi | | /get | /g | Dettaglio intervento | | /orbit tasks | | Interventi remoti |

Sito & Progetto

| Comando | Descrizione | |---------|-------------| | /sites | Selezione interattiva sito | | /link <id> | Collega directory a sito | | /unlink | Scollega sito | | /init | Crea ORBIT.md e manifest (opzionale) | | /set | Modifica platform/env/name | | /context | Mostra contesto progetto |

Comandi remoti

| Comando | Descrizione | |---------|-------------| | /remote health | Health report WordPress | | /remote plugins | Lista plugin | | /remote updates | Aggiornamenti disponibili | | /remote log | Debug log | | /remote ssl | Stato SSL | | /remote disk | Spazio disco | | /remote audit | Audit operazioni |

Account & Sistema

| Comando | Alias | Descrizione | |---------|-------|-------------| | /auth | | Accedi con browser | | /login | | Accedi con token | | /logout | | Scollega CLI | | /status | /s | Panoramica completa | | /info | /i | Workflow + prossimo passo | | /doctor | /doc | Diagnostica | | /model | | Seleziona modello AI | | /diagnose | /diag | Diagnostica aggregata | | /ide install | | Installa VS Code extension |

Integrazione LLM (MCP)

orbit serve avvia un MCP server su stdio con 12 tool per agenti LLM.

Configurazione Claude Code / Cursor

{
  "mcpServers": {
    "orbit-local": {
      "command": "orbit",
      "args": ["serve"],
      "env": {
        "MCP_TOKEN": "orbit_mcp_xxx",
        "ORBIT_LOCAL_PATH": "/path/to/progetto"
      }
    }
  }
}

Tool MCP (12)

| Tool | Tipo | Descrizione | |------|------|-------------| | orbit_session_start | write | Avvia sessione (OBBLIGATORIO) | | orbit_session_end | write | Chiudi sessione | | orbit_report_send | write | Invia report (OBBLIGATORIO) | | orbit_note_add | write | Aggiungi nota | | orbit_task_done | write | Completa task | | orbit_status | read | Stato corrente | | orbit_interventions_list | read | Lista interventi | | orbit_intervention_get | read | Dettaglio intervento | | orbit_intervention_update | write | Aggiorna intervento | | orbit_intervention_delete | write | Elimina intervento | | orbit_subtask_add | write | Aggiungi subtask | | orbit_subtask_complete | write | Completa subtask |

Caratteristiche tecniche

• Framework: oclif v4 + ESM + TypeScript
• UI: Ink (React) + boxen + figlet + @clack/prompts + ora
• Linter: Biome
• Persistenza: JSON atomici in ~/.orbit/sessions/ (write-rename)
• Auth: Device flow (RFC 8628) + MCP token (Bearer)
• Retry: Exponential backoff su 502/503/504/429
• Signal handling: SIGINT/SIGTERM/SIGTSTP con cleanup sessione
• Auto-refresh: Store aggiornato ogni 15s (git, sessione, health)
• Test: 1234 test (vitest)

Sviluppo

cd cli
npm install
npm test              # 1234 test
npm run build         # TypeScript + oclif manifest
npx biome check src/  # Lint + format
npm publish --access public

Licenza

MIT