@orbitpanel/cli

Orbit CLI — strumento locale per sviluppatori OrbitPanel.

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

Installazione

npm install -g @orbitpanel/cli

Quick Start

# 1. Autenticazione
orbit login --token orbit_mcp_xxx

# 2. Collega la directory al sito Orbit
cd /path/to/progetto
orbit link --site <site_id>

# 3. Inizia una sessione
orbit session start

# 4. Lavora... e aggiungi note
orbit note add "Fixato layout mobile homepage"

# 5. Invia il report
orbit report send --title "Fix homepage" --tag fix

Comandi

| Comando | Descrizione | |---------|-------------| | orbit login | Autentica con token MCP | | orbit logout | Rimuove il token | | orbit link | Collega directory → sito Orbit | | orbit unlink | Rimuove collegamento | | orbit status | Stato corrente | | orbit doctor | Diagnostica completa | | orbit session start | Inizia sessione | | orbit session end | Chiude sessione | | orbit note add | Aggiunge nota | | orbit report send | Invia report a Orbit | | orbit intervention list | Lista interventi | | orbit intervention get | Dettaglio intervento | | orbit intervention update | Aggiorna intervento | | orbit intervention delete | Elimina intervento | | orbit serve | MCP server per LLM |

Integrazione LLM (MCP)

orbit serve avvia un MCP server su stdio con 9 tool. Configurazione:

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

Tool MCP disponibili

• orbit_session_start / orbit_session_end
• orbit_report_send
• orbit_note_add
• orbit_status
• orbit_interventions_list
• orbit_intervention_get / orbit_intervention_update / orbit_intervention_delete

Sviluppo

cd cli
npm install
npm test        # 73 test
npm run build   # TypeScript → dist/

Architettura

• Framework: oclif v4 + ESM
• MCP SDK: @modelcontextprotocol/sdk
• Persistenza: JSON files in ~/.orbit/
• Auth: MCP token (Bearer, HMAC-SHA256)
• Retry: Exponential backoff su 502/503/504/429

Licenza

MIT