Paleta de comandos

Un panel controlado por teclado para navegar por Ceum con comandos al estilo shell — listar entidades, saltar a ellas, controlar el temporizador, limpiar, ayuda. Se abre con el acento grave.

La CLI es un panel controlado por teclado que te permite moverte por Ceum y acotar tu espacio de trabajo mediante comandos cortos al estilo shell. Sus comandos ejecutan las mismas operaciones que la integración MCP expone a las herramientas externas — el panel es la forma de ejecutarlas dentro de la aplicación, y está previsto un binario de terminal independiente que se conecta por MCP.

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.

Los comandos

La CLI sirve principalmente para listar y saltar a tus datos, además de para el control del temporizador. Las principales familias son:

  • <entity> list (p. ej. clients list, tasks list, invoices list) — lista clientes, proyectos, tareas, facturas, suscripciones, transacciones, documentos, eventos y tus configuraciones de estados/tipos/relaciones. Muchas listas admiten filtros, p. ej. tasks list --projectId P-3, transactions list --type income o documents list --clientId C-1, y --columns para elegir qué se muestra.
  • timer start|stop|resume|pause|status|discard|list — controla la sesión de tiempo en curso sin soltar el teclado. Al detenerla, se informa del nombre de la sesión y la duración transcurrida.
  • <entity> get — muestra una factura o un documento en detalle.
  • clear — limpia la transcripción.
  • help — la referencia de comandos (ver más abajo).

Los resultados de <entity> list son clicables: cada fila enlaza con el elemento correspondiente (o con su página de edición de ajustes en el caso de las filas de configuración), de modo que la CLI sirve también como forma rápida de adentrarte en tu espacio de trabajo. Al seguir cualquier enlace se navega y se cierra el panel.

Obtener ayuda

help se adapta a lo concreto que seas:

  • help — una visión general agrupada por familia de comandos en tres columnas alineadas: el sustantivo raíz (mostrado una vez por familia), el subcomando y sus parámetros (p. ej. la familia documents lista list, get, versions, delete bajo un único encabezado documents, cada uno con sus opciones).
  • help <family> — el mismo listado agrupado acotado a una familia (p. ej. help timer).
  • help <command> — el detalle completo de un comando, incluyendo el tipo de dato de cada opción y si es obligatoria (p. ej. help transactions list).

Las opciones están tipadas: --start <ISO datetime>, --amount <number>, --type <income|expense>. Cuando a un comando le falta una opción obligatoria, el error nombra cada una — una por línea — con su tipo de dato, en lugar de limitarse a decir «obligatoria».

Gramática de comandos

Esta referencia se genera a partir de los propios comandos, así que siempre coincide con lo que la CLI acepta realmente. Las opciones obligatorias no llevan corchetes; las opcionales van envueltas en [ ].

clear
clients list [--columns <id|name|status|email|company|uuid>] [--id <string>]
documents delete [--id <string>]
documents get [--id <string>]
documents list [--columns <id|name|description|clients|projects|updatedAt|uuid>] [--id <string>] [--projectId <string>] [--clientId <string>]
documents versions [--id <string>]
events create --title <string> --start <ISO datetime> --end <ISO datetime> [--description <string>]
events list [--columns <title|start|end|recurring|description|uuid>] [--from <date>] [--to <date>]
exit
help [command]
invoices delete [--id <string>]
invoices flag [--id <string>] [--description <string>]
invoices get <id> [--id <string>]
invoices list [--columns <id|invoiceNumber|client|amount|status|issueDate|dueDate|currency|flagged|uuid>] [--id <string>] [--clientId <string>]
invoices unflag [--id <string>]
mail logs list [--columns <to|subject|status|sentAt|templateType|uuid>]
mail templates create --name <string> --subject <string> --body <string> --template-type <message_client|send_invoice|send_overdue_reminder|send_project_email|send_task_email>
mail templates list [--columns <name|subject|templateType|uuid>]
projects list [--columns <id|name|status|client|uuid>] [--id <string>] [--clientId <string>]
relationship-types list [--columns <scope|typeId|name|enabled|order|color|uuid>] [--scope <project|task>]
statuses list [--columns <entityType|name|statusId|enabled|finished|order|color|uuid>] [--entity-type <client|project|task|invoice>]
subscriptions create --name <string> --cost <number> --billing-period <weekly|monthly|quarterly|yearly> --billing-date <string> [--currency <string>] [--tags <string>] [--notes <string>] [--inactive]
subscriptions list [--columns <name|cost|billingPeriod|billingsPerPeriod|billingDate|currency|active|uuid>]
task-types list [--columns <typeId|name|enabled|billable|standalone|embeddable|order|color|uuid>]
tasks list [--columns <id|name|status|type|deadline|uuid>] [--id <string>] [--projectId <string>] [--clientId <string>]
timer discard
timer list [--columns <name|startTime|endTime|status|task|uuid>]
timer pause
timer resume
timer start [--name <string>] [--taskId <string>]
timer status
timer stop
transactions create --date <date> --desc <string> --amount <number> --type <income|expense> [--currency <string>] [--tags <string>] [--clientId <string>] [--projectId <string>] [--taskId <string>]
transactions list [--columns <date|desc|amount|type|currency|client|project|uuid>] [--type <income|expense>] [--projectId <string>] [--clientId <string>]

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.
  • Autocompleta palabras clave de comandos, nombres de opciones y valores de opciones — incluidas las columnas de varios valores, de modo que tasks list --columns name,<Tab> ofrece las columnas restantes.

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.
  • 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.

Artículos relacionados