Killio CLI

CLI oficial para operar Killio desde terminal en modo usuario o modo agente.

• Modo usuario: salida legible para trabajo manual.
• Modo agente: salida JSON deterministica (--json) para automatizacion.

Requisitos

• Node.js >= 20

Instalacion

Global:

npm install -g killio-cli

Sin instalar global (uso puntual):

npx killio-cli --help

Primer uso

1. Login:

killio auth login --identifier [email protected] --password SECRET

2. Ver sesion:

killio auth whoami

3. Configurar URL API si no usas default:

killio config set apiUrl http://localhost:4000

Configuracion local

El CLI persiste estado en:

• ~/.killio/config.json

Claves principales:

• apiUrl
• accessToken
• refreshToken
• user
• updatedAt

URL default de API si no configuras nada:

• https://killio-back.vercel.app

Flags globales

• --json: fuerza salida JSON
• --debug-level <0|1|2|3>:
  • 0: silencioso
  • 1: errores
  • 2: trazas API (metodo/ruta/status)
  • 3: verbose (incluye payload)

Internamente el nivel se refleja en KILLIO_DEBUG_LEVEL.

Catalogo completo de namespaces y subcomandos

config

• killio config path
• killio config list
• killio config get <key>
• killio config set <key> <value>

auth

• killio auth register
• killio auth login
• killio auth whoami
• killio auth refresh
• killio auth logout

health

• killio health

team

• killio team list
• killio team create
• killio team activity <teamId>

team member

• killio team member list <teamId>
• killio team member update-role <teamId> <memberId>
• killio team member remove <teamId> <memberId>

team invite

• killio team invite list <teamId>
• killio team invite create <teamId>
• killio team invite revoke <teamId> <inviteId>
• killio team invite accept --token <token>

team board

• killio team board list <teamId>
• killio team board create <teamId>

board

• killio board create
• killio board get <boardId>
• killio board delete <boardId>
• killio board set-visibility <boardId>
• killio board comment list <boardId>
• killio board comment add <boardId> --text <text>
• killio board list-team <teamId>

board appearance

• killio board appearance get <boardId>
• killio board appearance set <boardId>

board member

• killio board member list <boardId>
• killio board member add <boardId>
• killio board member remove <boardId> <memberId>

board list

• killio board list create <boardId>
• killio board list update <boardId> <listId>

card

• killio card create
• killio card update <cardId>
• killio card archive <cardId>
• killio card unarchive <cardId>
• killio card delete <cardId>
• killio card get <cardId>
• killio card context <cardId>

card timer

• killio card timer current
• killio card timer list

card comment

• killio card comment list <cardId>
• killio card comment add <cardId> --text <text>

card tag

• killio card tag add <cardId> <tagId>
• killio card tag remove <cardId> <tagId>

card assignee

• killio card assignee add <cardId> <assigneeId>
• killio card assignee remove <cardId> <assigneeId>

card brick

• killio card brick add <cardId>
• killio card brick update <cardId> <brickId>
• killio card brick delete <cardId> <brickId>
• killio card brick reorder <cardId>

document

• killio document list
• killio document create
• killio document get <documentId>
• killio document update-title <documentId>
• killio document delete <documentId>
• killio document export <documentId>

document brick

• killio document brick add <documentId>
• killio document brick update <documentId> <brickId>
• killio document brick delete <documentId> <brickId>
• killio document brick reorder <documentId>

document comment

• killio document comment list <documentId>
• killio document comment add <documentId>

document member

• killio document member add <documentId>

tag

• killio tag list
• killio tag create

notification

• killio notification list
• killio notification unread-count
• killio notification read <notificationId>
• killio notification read-all
• killio notification run-reminders

activity

• killio activity team <teamId>
• killio activity board <boardId>
• killio activity list <listId>
• killio activity card <cardId>

upload

• killio upload file <filePath>
• killio upload image <filePath>
• killio upload get-image <key>

ably

• killio ably auth

ai

• killio ai extract
• killio ai chat
• killio ai generate-cards
• killio ai generate-documents
• killio ai generate-boards
• killio ai generate-report
• killio ai improve-card
• killio ai team-metrics <teamId>

skill

• killio skill install
• killio skill list
• killio skill preset <type>
• killio skill preset-all
• killio skill <type> (e.g. killio skill scrum-master or killio skill developer to install specific preset directly)

Instala el skill para agentes en .github/skills/.

Funciones avanzadas de IA y referencias

El CLI soporta referencias semanticas en prompts para operar con contexto estructurado:

• @[tipo:id:nombre]
• #[cardId:brickId:selector]
• $[docId:brickId:selector]

Selectores comunes:

• texto: line, chars, body, title
• checklist: item, items, checked, unchecked
• tabla: cell, row, col, range, csv
• media: url, caption, mime, size, asset

Seguridad en borrados

Comandos destructivos (por ejemplo board/document delete) aplican confirmacion reforzada.

• Confirmacion interactiva de 2 pasos.
• Uso de --force para pipelines no interactivos.

Desarrollo local del CLI

Instalar dependencias:

npm install

Ejecutar en modo dev:

npm run dev -- --help

Compilar:

npm run build

Typecheck:

npm run typecheck

Build, release y publicacion

Scripts de package:

• npm run build
• npm run typecheck
• npm run bump
• npm run release:auto
• npm run deploy:publish
• npm run bump:patch:deploy:publish
• npm run bump:minor:deploy:publish
• npm run bump:major:deploy:publish

Binario publicado:

• comando: killio
• entrypoint: dist/index.js

Troubleshooting

401 o 403 en comandos

• Rehacer killio auth login
• Verificar token con killio auth whoami

API apuntando a entorno equivocado

• Revisar killio config list
• Ajustar con killio config set apiUrl <url>

Necesito salida para automatizacion

• Agregar --json a cada comando

Necesito trazas de requests

• Agregar --debug-level 2 o --debug-level 3

Relacion con otros repos

• Killio-Backend: endpoints reales que invoca este CLI.
• Killio-Frontend: misma semantica funcional expuesta como UI.