Paleta de comandos

La paleta de comandos es un panel gobernado por el teclado para manejar Ceum desde una línea de comandos sin salir de la aplicación. Ejecuta exactamente los mismos comandos que el cliente de terminal independiente (@ceum/cli, instalable con npm), sobre el mismo conjunto de herramientas que la integración MCP expone a herramientas externas: una gramática, tres formas de entrar.

La diferencia está en lo que te pide. Una herramienta externa se autentica con un token de MCP que tú creas y limitas. La paleta no: se ejecuta como tú, con tu propio acceso, así que no hay ningún token que crear ni ninguno que rotar. Sus cambios quedan registrados en Actividad de herramientas junto a todo lo demás que toca tu espacio de trabajo.

Abrir el panel

Pulsa el acento grave (`) en cualquier lugar fuera de un campo de texto. El panel se desliza hacia arriba desde la parte inferior sobre la barra de navegación. Pulsa Escape para cerrarlo.

Dentro del panel encontrarás:

• Un campo de comando con autocompletado por tabulador.
• Una transcripción de tus comandos recientes y su salida (las últimas 100 entradas).
• Un tirador para redimensionar la altura del panel.

Comandos

Los comandos se leen como <recurso> <acción>, con las opciones como indicadores largos:

tasks list --status doing
tasks create --title "Ship v1"
clients get C-7
invoices list --columns id,client,amount,status

El conjunto completo se genera desde el servidor, así que siempre coincide con lo que existe de verdad: consulta la gramática más abajo, o escribe help. Todo lo que puede hacer la API lo puede hacer la paleta: crear y actualizar además de listar, operaciones masivas, registros de tiempo, tableros kanban, relaciones.

Algunas opciones funcionan en cualquier comando:

• --columns: elige qué columnas muestra una tabla.
• -o json (o csv, ndjson): salida sin procesar en lugar de una tabla.
• --all: recorre más allá de la primera página de una lista larga.
• --dry-run: muestra la llamada que haría un comando, sin hacerla.
• --yes: omite la confirmación que pide un comando que borra.

Las filas de una tabla son clicables: cada una enlaza con el elemento correspondiente, así que la paleta sirve también para llegar rápido a lo hondo de tu espacio de trabajo. Al seguir un enlace se navega y el panel se cierra.

Borrar algo

Un comando que borra pregunta primero. Muestra lo que está a punto de hacer y espera: escribe y para continuar, cualquier otra cosa para cancelar. Añade --yes para saltarte la pregunta cuando lo tengas claro.

Lo que la paleta no puede hacer

Dos cosas que sí puede el cliente de terminal, deliberadamente:

• Sin archivos. --file, --input-file y --stdin no existen aquí: un panel en el navegador no tiene sistema de archivos. Usa --input '<json>' para lo que necesite un valor anidado, o el cliente de terminal para una importación masiva desde una hoja de cálculo.
• Sin credenciales que configurar. --token, --url y --profile tampoco existen, porque tu inicio de sesión es la credencial.

Si escribes alguno, la paleta lo dice por su nombre, en vez de tratarlo como una errata.

Obtener ayuda

help se adapta a lo concreto que seas:

• help: todos los recursos, más los comandos propios del panel.
• help <recurso>: las acciones de ese recurso, cada una con una descripción de una línea (p. ej. help invoices).
• help <recurso> <acción>: el detalle completo de un comando: cada opción, su tipo de dato y si es obligatoria (p. ej. help tasks create).

El texto de ayuda procede de las propias descripciones de herramientas del servidor, así que está en inglés aunque el resto de la aplicación no lo esté, y es el mismo texto que imprime ceum --help en una terminal.

Gramática de comandos

Generada a partir del conjunto de comandos en vivo, así que siempre coincide con lo que la paleta y el cliente de terminal aceptan de verdad. Una línea por recurso, con sus acciones; ejecuta help <recurso> <acción> para ver las opciones.

assistant-config            get
calendar-items              list
client-statuses             create, delete, list, update
clients                     bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
combined-views              create, delete, get, list, resolve, update
document-versions           delete, get, list, restore
documents                   bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
events                      create, delete, get, list, update
invoice-statuses            create, delete, list, update
invoices                    bulk-create, bulk-delete, bulk-update, create, delete, flag, get, list, update
kanban-boards               create, delete, get, list, update
profile                     get
project-relationship-types  create, list
project-relationships       create, list
project-statuses            create, delete, list, update
projects                    bulk-create, bulk-delete, bulk-update, create, delete, get, link-clients, list, unlink-clients, update
relationship-types          delete, get, update
relationships               delete, update
settings                    get
subscriptions               bulk-create, bulk-delete, bulk-update, create, delete, get, list, list-due, pause, unpause, update
tags                        bulk-delete, bulk-update, create, delete, list, update
task-comments               create, delete, list, update
task-relationship-types     create, list
task-relationships          create, list
task-statuses               create, delete, list, update
task-types                  create, delete, get, list, update
tasks                       bulk-delete, bulk-update, create, delete, duplicate, flag, get, link-projects, list, unlink-projects, update
time-entries                aggregate, bulk-delete, bulk-update, create, delete, get, link-tasks, list, unlink-tasks, update
time-goals                  create, delete, get, list, pause, unpause, update
time-sessions               resume, start
transactions                bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
workspace                   search

Mientras se ejecuta un comando

Los comandos que acceden al servidor muestran un indicador en vivo — un pequeño girador y el tiempo transcurrido en segundos — hasta que terminan, para que puedas distinguir una solicitud lenta de una atascada.

Autocompletado por tabulador

El autocompletado funciona igual que en un shell:

• Un tabulador — rellena el prefijo común más largo.
• Dos tabuladores — muestra todos los candidatos.
• Completa recursos, acciones, nombres de indicadores y los valores de un indicador cuando la opción tiene un conjunto fijo, así que tasks list --status <Tab> ofrece los estados.

Consejos y casos límite

• Clic para enfocar. Al hacer clic en cualquier parte del espacio vacío del panel se enfoca el campo de comando, así que puedes empezar a escribir sin tener que apuntar a la línea de entrada.
• ¿El acento grave resulta incómodo? Si la distribución de tu teclado dificulta alcanzar el acento grave, aún puedes alternar la CLI mediante la cadena de acordes en Atajos de teclado.
• La lista rápida está al lado. El panel de la CLI aparece desde la parte inferior, mientras que el panel de la Lista rápida se desliza desde el lateral — no se solapan.
• Tuberías. Las filas de una tabla se pueden filtrar sobre la marcha con |: tasks list | grep -E urgent, además de head, tail, sort y uniq. Se ejecutan sobre lo que ya llegó y nunca hacen una segunda petición.
• La transcripción es temporal. Cerrar el panel mantiene la transcripción; recargar la página la borra.

En móvil

No está disponible en la aplicación móvil — gestiónalo desde la aplicación web.