wiki(cli): correct config file path — ~/.noetl/config.yaml (was .toml) The CLI persists context state as YAML at ``~/.noetl/config.yaml`` (per ``repos/cli/src/config.rs:105``), not TOML. Fixes all references across: - Home.md - context-model.md (including the storage-location diagram) - context-list-use-delete.md (``context use`` persistence) - global-context-flag.md (``--context`` read-but-not-write semantics) - auth-login.md (post-login state diagram + verify section) The Duffel smoke test against GKE this session surfaced the discrepancy: the awk-based extractor in operations/notes.md was pointing at the wrong file. Refs noetl/ai-meta#22

kadyapam committed May 28, 2026

wiki(cli): clarify auth login token caching — no export needed The "export NOETL_SESSION_TOKEN=..." line printed after a successful ``noetl auth login`` confuses first-time operators who think they must run the export for subsequent CLI calls to work. They don't: the CLI saves the token onto the context file (``Saved: context '<name>'``) and reads it from there. - auth-login.md: new "After a successful login — do I need to export the token?" section with verify steps, when the env var actually matters, and a diagram of state-after-login. - connecting-to-a-cluster.md: short callout pointing back to the full explanation so people working through the gateway path see it inline. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

kadyapam committed May 28, 2026

wiki(cli): document context model, init/update/port-forward, global --context, auth login PKCE hints, exit code 77 Covers the CLI changes shipped in noetl/cli v2.15.0 - v2.17.0 (PRs #13, #14, #16, #17): - context init --from-gateway: bootstrap a context by reading the gateway's GET /api/runtime/contract auth0 block, with operator confirmation + warning when no block is exposed. - context update: patch a context's fields in place; empty string clears Auth0 / kube fields without dropping the cached session token. - context port-forward: managed kubectl tunnel with --detach / --stop / --status, PID file at ~/.noetl/port-forwards/<ctx>.pid, TcpListener bind probe before spawn so stray kubectl from another shell fails fast. - noetl --context <name>: global per-command override mirroring kubectl --context. - auth login --browser-pkce pre-flight: prints the redirect URI + Auth0 dashboard URL so operators can verify the callback is allowlisted before the browser opens. - Exit code 77: dedicated "gateway session expired" code for scripts. Home.md rebuilt as a hub linking the per-command pages; _Sidebar.md adds nav. Adds connecting-to-a-cluster.md mirroring the three supported connection paths (gateway / port-forward / direct). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

kadyapam committed May 28, 2026