agentiis

CLI di agentiis.com: autentica e parla con i tuoi agenti AI personali dal terminale. Progettata con una regola guida: "un altro agente mi chiamerà via Bash" — output deterministico, --json, exit code espliciti, niente rumore su stdout.

Questa è la CLI del .com. È un canale di export distinto da AgentiisOS (il runtime scaricabile).

Installazione

npx agentiis login          # zero-install, sempre l'ultima versione
# oppure
npm i -g agentiis

Comandi (MVP)

agentiis login                          # apre il browser, collega i tuoi agenti
agentiis whoami                         # stato di login (chi sei, n. agenti) · --json
agentiis logout                         # revoca il token sul server + rimuove le credenziali (--all: anche le sessioni)
agentiis agents                         # lista numerata: "N. Nome — descrizione"
    --json            array {id,name,slug,model,description} (senza segreti)
agentiis ask <agente> "<domanda>"       # chiedi a un agente, ricevi la risposta
    --session <id>    continua una conversazione (storico locale in ~/.agentiis/sessions)
    --json            output machine-readable
agentiis --version

La scoperta è puramente locale: agents legge gli agenti collegati al login. La CLI non possiede né stampa mai le agent key: vivono sul server, il proxy le inietta.

Exit codes

| code | significato | |------|-------------| | 0 | ok | | 1 | errore generico | | 2 | uso errato | | 3 | budget dell'agente esaurito | | 4 | non autenticato (agentiis login) |

Skill (convenzione skillflag / agentskills.io)

La CLI bundla la propria skill. Un agente (Claude Code, OpenClaw, Hermes) può scoprirla e installarla da solo:

agentiis --skill list
agentiis --skill export agentiis | npx skillflag install --agent claude      # → .claude/skills/agentiis
agentiis --skill export agentiis | npx skillflag install --agent openclaw
agentiis --skill export agentiis | npx skillflag install --agent hermes

Lo stesso SKILL.md (skills/agentiis/SKILL.md) è standards-pure (solo name + description, corpo Bash-agnostico) e funziona invariato su tutti e tre i runtime.

Sviluppo / test

ask è testabile passando un token CLI e l'apiBase del sito via flag o env (--token/AGENTIIS_TOKEN, --base/AGENTIIS_BASE). Il token autentica verso il proxy del sito; le agent key restano server-side.

node bin/agentiis.js ask legale "spiega cos'è una RLS in una riga" \
  --token "<cli-token>" --base "http://localhost:3000" --json

npm test esegue i test unit (node --test). Per il --skill: npm install (tira giù skillflag), poi node bin/agentiis.js --skill list.

Backend (come funziona login)

login apre un loopback OAuth verso /connect-cli su agentiis.com. Dopo il login Supabase, il sito rimanda alla loopback un payload base64url con un token CLI revocabile (NON le agent key) + i metadati degli agenti. ask chiama poi /api/cli/ask col token: è il sito a iniettare la agent key e parlare col gateway. Contratto completo in docs/connect-cli-contract.md e src/commands/login.js.