CLI
kontext [-C <dir>] <command> [options]-C, --dir <dir> spustí kontext tak, akoby bol spustený v <dir> (funguje so všetkými príkazmi). kontext <command> --help vypíše voľby uvedené nižšie.
Návratový kód. 0 pri úspechu, 1 pri chybách, 2, keď drift --fail alebo ci --strict vypíše záznam, 3, keď drift --fail alebo ci --strict nevyriešil žiadny základ. Chybu použitia (neznáma voľba alebo chýbajúci argument) hlási parser argumentov so stavom 2.
Zavedenie
Aplikácie používajú kontext api <operation> [JSON|-] pre verzované JSON výsledky a chyby: dotazy na znalosti, extrakciu, idempotentný staging a overený export.
kontext init
Spustí scan → history → render → wire → deepen. Opakované spustenie je bezpečné.
| Voľba | Predvolene | Význam |
|---|---|---|
--no-hooks | nenainštaluje git hooky, zapamätá sa pre klon (odmietnutie zapíše len táto výslovná voľba); kontext hooks install ich neskôr pridá | |
--connect <targets> | pripojí aj klientov, oddelených čiarkou (claude,claude-hooks,cursor,opencode,agents-md) | |
--deepen | spustí čakajúce úlohy prehĺbenia cez LLM adaptér | |
--llm <adapter> | init.llm | adaptér s operáciou llm |
--jobs <n> | init.jobs (2) | paralelné volania LLM |
--max <n> | 50 | úlohy v jednom behu |
| Podpríkaz | Význam |
|---|---|
kontext init status | stav fáz a postup prehĺbenia |
kontext init next [-n <count>] [--inline] | vypíše ďalšiu úlohu (úlohy); --inline priloží úryvky súborov (na vloženie do chatového modelu) |
kontext init submit <file|-> | zapíše výsledok úlohy (JSON: task_id, summary, overview, decisions, learnings) |
kontext init skip <task> [--reason <text>] | preskočí úlohu (aj mod:<module>); znova sa neponúkne |
Každodenná práca
kontext brief
| Voľba | Predvolene | Význam |
|---|---|---|
-f, --focus <path|word> | uprednostní tieto cesty alebo témy (dá sa opakovať) | |
--budget <tokens> | brief.budget_tokens | približná veľkosť |
--format <fmt> | text | text, json (štruktúra ctx_brief: riadiaca sekcia, stav, počty, aktuálnosť, čo sa orezalo), claude-hook (SessionStart additionalContext) |
--no-adapters | vynechá sekcie brief z adaptérov |
kontext search <query…>
| Voľba | Predvolene | Význam |
|---|---|---|
-k, --kind <kind> | decision, convention, learning, incident, architecture, doc, commit (dá sa opakovať) | |
-s, --source <name> | všetky | local a/alebo názvy adaptérov (dá sa opakovať) |
-n, --limit <n> | 10 | najviac výsledkov |
--json | výsledky ako JSON | |
--adapters | pýta sa vyhľadávacích adaptérov, aj keď lokálne zásahy stačia (pozri [search]) |
kontext read <uri>
-l, --level <0|1|2> (predvolene 2). URI: kx:<id>, file:<path>[#section], git:<sha>, inbox:<id>, obyčajná cesta v repozitári alebo URI adaptéra. Text dlhší ako 32 000 znakov príde po častiach: --part <n> (1 = prvá) alebo --offset <znaky>.
kontext why <target>
target je cesta, path:line, path:start-end, SHA commitu alebo symbol/téma. -n, --limit <n> (predvolene 12) položiek na sekciu.
kontext log
| Voľba | Predvolene | Význam |
|---|---|---|
-k, --kind <kind> | decision | druh, ktorý sa vypíše |
--all | zahrnie nahradené a zamietnuté záznamy | |
-n, --limit <n> | 50 | riadky |
--json | riadky ako JSON |
Zachytávanie a commitovanie
kontext capture
| Voľba | Význam |
|---|---|
-k, --kind <kind> | decision, convention, learning (pitfall), incident (povinné) |
-t, --title <text> | krátke tvrdenie (povinné) |
-b, --body <text> / --file <path|-> / stdin | telo |
--summary <text> | jeden riadok (keď chýba, odvodí sa z tela) |
-p, --paths <a,b> | cesty alebo globy, ktorých sa týka |
--tags <a,b> | štítky |
--supersedes <id,…> | záznamy, ktoré nahrádza (plné id; nejednoznačné sa odmietne) |
--extends <id,…> | záznamy, na ktorých stavia |
--status <status> | proposed alebo accepted (rozhodnutia predvolene accepted) |
--private | nechá ho osobným (nikdy sa nepovýši) |
--promote | zapíše ho hneď do úložiska namiesto inboxu |
--review-by <YYYY-MM-DD> | kedy ho znova pozrieť (inak review_after druhu, ak je nastavené) |
--verify <príkaz> | príkaz, ktorý ho dokázal: jeden riadok, najviac 500 znakov, spúšťa ho kontext verify |
kontext challenge <id> <prečo…> [--private]
Povie, že záznam už neplatí, a prečo. Námietka čaká v lokálnom inboxe; prepare-commit ponúkne vyradenie záznamu alebo zaznamenanie náhrady, ktorá ho nahrádza.
kontext confirm <id…> [--because <text>] [--kind read|agent] | --repair | --migrate-legacy
Potvrdí, že záznamy stále platia: nastaví checked na aktuálny čas v UTC (YYYY-MM-DDTHH:MM:SSZ) v súbore každého záznamu, nič iné nezmení, pridá za každý záznam riadok do denníka overení a oboje stagne. Riadok je read, keď sú stdin aj stderr terminál, inak agent, a bulk, keď je ID viac ako päť. --kind agent zapíše pečiatku agenta; --kind read vynúti read aj bez terminálu a vypíše varovanie; terminál nie je dôkaz, že záznam čítal človek. --because uloží do denníka jednoriadkový dôvod. Odmietne neznámy alebo neaktívny záznam, záznam, ktorý ešte nie je commitnutý, a súbor s nestagnutými úpravami. Keď niektoré ID zlyhá, skončí so stavom 1.
--repair prepíše checked každého aktívneho záznamu, ktorého súbor zaostáva za jeho najnovším potvrdením v denníku (merge vzal staršiu stranu), a súbor stagne; keď niektorý prepísať nejde, skončí so stavom 1.
--migrate-legacy pridá riadok bulk pre každý aktívny záznam, ktorého jediným dôkazom je dátum checked: (druh cache, verified: false), aby čerstvosť a drift mali v denníku riadok, od ktorého počítajú. Overenými ich to nespraví.
kontext verify <id…> [--because <text>] [--json]
Spustí príkaz verify každého záznamu cez sh -c z koreňa repozitára, ale len keď je jeho text pinnutý cez kontext trust --verify; nepinnutý príkaz odmietne s untrusted_verify, príkazom, jeho SHA-256 a riadkom na pin; na termináli kontext verify príkaz ukáže a opýta sa, či ho pinnúť. Príkaz dostane povolený zoznam premenných prostredia (pozri [verify]) a po KONTEXT_VERIFY_TIMEOUT_SECS (predvolene 120) sa zastaví spolu so skupinou procesov. Do denníka ide riadok verify s výsledkom a commitom a stagne sa; keď mal súbor záznamu alebo jeho riadené cesty necommitnuté zmeny, jeho dôvod končí [dirty: <cesty>]. Vypíše výsledok a pri zlyhaní zamaskovaný koniec výstupu; --json vypíše výsledky drafts.verify. Odmietne záznam bez príkazu a neaktívny záznam. Keď príkaz zlyhá alebo je ID odmietnuté, skončí so stavom 1.
kontext drift
Záznamy, ktoré rozsah commitov nechal za sebou: aktívne záznamy, ktorých paths pokrývajú zmenené súbory, kým ich vlastný súbor sa v rozsahu neupravil ani nepotvrdil. Pozri Drift.
| Voľba | Predvolene | Význam |
|---|---|---|
--base <rev> | merge base HEAD s origin/HEAD (origin/main, origin/master), upstreamom alebo predvolenou vetvou checkout.defaultRemote, inak HEAD | začiatok rozsahu |
--head <rev> | pracovný strom | koniec rozsahu; bez neho sa počítajú aj necommitnuté a nesledované zmeny |
-k, --kind <druh> | decision, convention, learning, incident | druhy na kontrolu (opakovateľné) |
--json | výsledok entries.drift ako JSON | |
--fail | skončí so stavom 2, keď je vypísaný nejaký záznam: brána pre tímový kontrolný skript alebo CI, ktorá pokryje aj commity bez hookov (jj). Keď sa nevyriešil žiadny základ (base_source: fallback-none), drift povie prečo a --fail skončí so stavom 3 |
kontext inbox [list | show <id> | drop <id…> | verify <id> <príkaz|--clear>]
Lokálni kandidáti. list je predvolený. verify nastaví príkaz, ktorý návrh dokázal (overuje sa ako --verify pri capture); --clear ho odstráni. Povýšenie ho zachová.
kontext promote <id…> [--no-stage]
Zapíše kandidátov do úložiska a spraví git add.
kontext prepare-commit [--promote <id>]… [--drop <id>]… [--retire <id>]…
Report, ktorý agenti dostanú z ctx_prepare_commit. Keď nie je nič stagnuté, prečíta zmeny pracovného stromu voči HEAD (vrátane nesledovaných súborov) a povie to; to treba spustiť pred jj commit. --retire vyradí záznam s námietkou z tohto worktree: stav deprecated, námietka ako dôvod v poznámke ## Retired, stagnuté.
kontext distill [<súbor>…] [--claude <id|last>]… [--codex <id|last>]… [--superset [<workspace>]]
Vytiahne znalosti z vlákien agentov do inboxu; bez vlákna vypíše vlákna tohto repozitára na tomto počítači. Pozri Znalosti z vlákien agentov.
| Voľba | Predvolene | Význam |
|---|---|---|
--llm <adapter> | init.llm | adaptér s operáciou llm |
--max <n> | 5 | najviac záznamov na vlákno |
--max-parts <n> | 12 | najviac častí prepisu na vlákno |
--jobs <n> | 3 | súbežné volania modelu |
--list | vlákna len vypíše | |
--dry-run | zistenia vypíše, nič nezachytí | |
--force | spracuje vlákno --claude alebo --codex, ktoré bežalo v inom repozitári (inak ho odmietne) |
kontext check [--staged]
Zvaliduje všetky záznamy (alebo presne to, čo je stagnuté) a preskenuje ich na tajné údaje. Neparsovateľný záznam, nejednoznačný odkaz, duplicitné číslo ADR a jednostranné nahradenie (nástupca je aktívny, starý súbor stále tvrdí niečo iné) sú chyby; odkaz, ktorý je prefixom namiesto id, a neparsovateľné alebo budúce riadky denníka sú varovania. Pri chybách skončí so stavom 1.
kontext repair [--dry-run]
Dopíše chýbajúcu stranu jednostranných nahradení (status a superseded_by nahradeného záznamu, ako jednotlivé riadky) a stagne ju. --dry-run úpravy len vypíše. Stav 1, keď niektorý súbor preskočil alebo sa nedal naplánovať (nestagnuté úpravy, žiadne miesto pre status).
kontext ci [--base <rev>] [--format text|markdown] [--strict]
Pre CI job: kontext check nad všetkými záznamami plus kontext drift nad commitnutým rozsahom base..HEAD (--base má rovnaké predvolenie ako pri drift). --format markdown sa hodí do súhrnu jobu na GitHube alebo do komentára k pull requestu. Pri chybách kontroly skončí so stavom 1; s --strict aj so stavom 2, keď drift vypíše nejaký záznam, a 3, keď sa nevyriešil základ, inak je drift len varovanie (stav 0). Pozri Validácia znalostí v CI.
Git hooky
| Príkaz | Význam |
|---|---|
kontext hooks install [--hooks-dir <dir>] | nainštaluje do core.hooksPath, .git/hooks alebo <dir> |
kontext hooks uninstall [--hooks-dir <dir>] | odstráni bloky kontextu, obnoví zreťazené originály |
kontext hooks status | ktoré hooky obsahujú blok |
kontext hook <name> [args…] | vstupný bod, ktorý volajú hooky (pre-commit, prepare-commit-msg, post-commit, post-merge, post-rewrite) |
kontext hook --host claude|codex|cursor | vstupný bod pre hooky hostiteľov agentov: číta hook JSON hostiteľa zo stdin a vypíše odpoveď v jeho tvare; fail-open (pri akejkoľvek chybe kód 0 bez výstupu). kontext hook <name> bez --host ostáva vstupným bodom git hookov. Pozri Hooky |
Adaptéry
| Príkaz | Význam |
|---|---|
kontext adapters [list] | aktívne a neaktívne adaptéry aj s dôvodom |
kontext adapters test [<name>] [--query <q>] | kontrola stavu a ukážkové volanie každej operácie |
kontext adapters inspect <name> | nástroje MCP adaptéra a ich vstupné schémy |
kontext adapters add <preset> [--scope user|repo|local] [--var k=v]… [--force] | pripojí preset do vrstvy konfigurácie |
kontext presets [<name>] | vypíše presety alebo jeden z nich |
kontext trust [--yes] | dôveruje adaptérom, [vars] a project.name deklarovaným v zdieľanej konfigurácii (najprv ich ukáže); len z terminálu (stdin a stderr), inak stav 1; starý FNV pin nahradí, nikdy nepovýši. --yes vynechá otázku, nie kontrolu terminálu |
kontext trust --verify [<id>|--all] [--yes] | pinne príkazy verify, ktoré ešte nie sú pinnuté: každý vypíše a opýta sa, s <id> len jeden záznam, s --all všetky po jednom potvrdení; len z terminálu |
kontext outbox [list | flush [--quiet]] | čakajúce doručenia; doruč hneď |
kontext outbox retry | vráti eventy z dead-letter súboru (outbox.dead.jsonl) do frontu |
kontext sync [--all] | zaradí udalosti sync pre znalosti v HEAD (--all: každý záznam raz) |
Klienti a servery
| Príkaz | Význam |
|---|---|
kontext mcp | spustí MCP server na stdio |
kontext connect <target> [--write] [--hooks] [--force] | claude, claude-hooks, skills, codex, cursor, opencode, agents-md; --hooks pridá hooky hostiteľa pre claude, codex a cursor; --force nahradí skills, ktoré tím upravil |
kontext call <tool> ['<json>'] | zavolá nástroj agenta lokálne, napr. kontext call ctx_why '{"target":"src/api"}' |
Údržba
| Príkaz | Význam |
|---|---|
kontext status | identita, vrstvy konfigurácie, úložisko, index, záznamy na prehodnotenie, záznamy po termíne review_by, inbox, postup initu, adaptéry, git hooky, outbox a jeho dead letters, varovania (medzi nimi neplatný vzor redakcie) |
kontext reindex | zostaví lokálny vyhľadávací index od nuly |
Premenné prostredia
| Premenná | Význam |
|---|---|
KONTEXT_CONFIG_DIR | adresár používateľskej konfigurácie (predvolene $XDG_CONFIG_HOME/kontext alebo ~/.config/kontext) |
KONTEXT_DIR | repozitár pre kontext mcp, keď sa nespustí v ňom |
KONTEXT_SKIP=1 | hooky nerobia nič (jednorazové obídenie) |
KONTEXT_HOOKS=off | hooky hostiteľov agentov (kontext hook --host) nevypíšu nič |
KONTEXT_VERIFY_TIMEOUT_SECS | časový limit verify príkazu (predvolene 120) |
KONTEXT_TRUST_REPO_ADAPTERS=1 | dôveruje adaptérom deklarovaným v repozitári bez kontext trust (CI, sandboxy) |