Příkazová paleta

Příkazová paleta je klávesnicí ovládaný panel, ve kterém můžete Ceum ovládat z příkazového řádku, aniž byste opustili aplikaci. Spouští přesně stejné příkazy jako samostatný terminálový klient (@ceum/cli, instalovatelný přes npm), nad stejnou sadou nástrojů, jakou integrace MCP nabízí externím nástrojům – jedna gramatika, tři cesty dovnitř.

Liší se tím, co po vás vyžaduje. Externí nástroj se ověřuje tokenem MCP, který vytvoříte a omezíte. Paleta nikoli: běží jako vy, s vaším vlastním přístupem, takže není potřeba žádný token vytvářet ani obměňovat. Její změny se zaznamenávají v Aktivitě nástrojů vedle všeho ostatního, co se dotýká vašeho pracovního prostoru.

Otevření panelu

Stiskněte zpětný apostrof (`) kdekoli mimo textové pole. Panel vyjede zdola nahoru přes navigační lištu. Stisknutím klávesy Escape jej zavřete.

Uvnitř panelu najdete:

Vstupní pole příkazu s doplňováním tabulátorem.
Přepis vašich nedávných příkazů a jejich výstupu (posledních 100 záznamů).
Úchyt pro změnu výšky panelu.

Příkazy

Příkazy se čtou jako <zdroj> <akce>, s volbami v podobě dlouhých přepínačů:

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

Úplná sada se generuje ze serveru, takže vždy odpovídá tomu, co skutečně existuje – viz gramatika níže, nebo napište help. Co dokáže API, dokáže i paleta: nejen vypisovat, ale i vytvářet a upravovat, hromadné operace, časové záznamy, kanbanové tabule, vztahy.

Několik voleb funguje u každého příkazu:

--columns – vyberte, které sloupce tabulka zobrazí.
-o json (nebo csv, ndjson) – nezpracovaný výstup místo tabulky.
--all – projděte i za první stránku dlouhého seznamu.
--dry-run – zobrazte volání, které by příkaz provedl, aniž by je provedl.
--yes – přeskočte potvrzení, které mažící příkaz vyžaduje.

Řádky v tabulce jsou klikatelné: každý odkazuje na odpovídající položku, takže paleta slouží i jako rychlý způsob, jak se dostat hluboko do pracovního prostoru. Kliknutím na odkaz přejdete a panel se zavře.

Mazání

Příkaz, který maže, se nejprve zeptá. Vypíše, co se chystá udělat, a počká – napište y pro pokračování, cokoli jiného pro zrušení. Přidejte --yes, chcete-li otázku přeskočit.

Co paleta neumí

Dvě věci, které terminálový klient umí, a to záměrně:

Žádné soubory. --file, --input-file ani --stdin zde neexistují – panel v prohlížeči nemá souborový systém. Pro cokoli, co potřebuje vnořenou hodnotu, použijte --input '<json>', nebo pro hromadný import z tabulky terminálový klient.
Není co nastavovat z přihlašovacích údajů. --token, --url ani --profile rovněž neexistují, protože přihlašovacím údajem je vaše přihlášení.

Když některý z nich napíšete, paleta to řekne jménem, místo aby to považovala za překlep.

Získání nápovědy

help se přizpůsobí tomu, jak konkrétní jste:

help – všechny zdroje a vestavěné příkazy panelu.
help <zdroj> – akce daného zdroje, každá s jednořádkovým popisem (např. help invoices).
help <zdroj> <akce> – úplné podrobnosti k jednomu příkazu: každá volba, její datový typ a zda je povinná (např. help tasks create).

Text nápovědy pochází z popisů nástrojů na serveru, takže je v angličtině, i když zbytek aplikace není – a je to tentýž text, který v terminálu vypíše ceum --help.

Gramatika příkazů

Generováno z živé sady příkazů, takže vždy odpovídá tomu, co paleta i terminálový klient skutečně přijímají. Jeden řádek na zdroj se seznamem jeho akcí; volby zjistíte příkazem help <zdroj> <akce>.

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

Během běhu příkazu

Příkazy, které komunikují se serverem, zobrazují živý indikátor – malý otáčející se ukazatel a uplynulý čas v sekundách – dokud nedoběhnou, takže rozeznáte pomalý požadavek od zaseknutého.

Doplňování tabulátorem

Doplňování funguje stejně jako v shellu:

Jeden tabulátor – doplní nejdelší společnou předponu.
Dva tabulátory – zobrazí všechny možnosti.
Doplňuje zdroje, akce, názvy přepínačů a hodnoty přepínače tam, kde má volba pevnou sadu – takže tasks list --status <Tab> nabídne stavy.

Tipy a okrajové případy

Klikněte pro zaměření. Kliknutím kamkoli do prázdného prostoru panelu se zaměří vstupní pole příkazu, takže můžete začít psát, aniž byste museli mířit na řádek vstupu.
Je zpětný apostrof nepohodlný? Pokud rozložení vaší klávesnice ztěžuje dosah na zpětný apostrof, můžete CLI přepnout i pomocí akordového řetězce v sekci Klávesové zkratky.
Rychlý seznam je nablízku. Panel CLI vyjíždí zdola, zatímco panel Rychlý seznam vjíždí ze strany – nepřekrývají se.
Roury. Řádky tabulky lze filtrovat na místě pomocí |: tasks list | grep -E urgent, dále head, tail, sort a uniq. Běží nad tím, co se vrátilo, a nikdy neposílají druhý dotaz.
Přepis je dočasný. Zavření panelu přepis zachová; opětovné načtení stránky jej vymaže.

Na mobilu

Není k dispozici v mobilní aplikaci – spravujte z webové aplikace.