From a70ea1f1ea1bb9b8abd2816811991d717cd25522 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:22:15 +0000 Subject: [PATCH] docs: document agent-friendly datumctl login and plugin install --all-available --- datumctl/auth/logging-in.mdx | 24 ++++++++++++++++++++++++ datumctl/plugins/using-plugins.mdx | Bin 7006 -> 8339 bytes 2 files changed, 24 insertions(+) diff --git a/datumctl/auth/logging-in.mdx b/datumctl/auth/logging-in.mdx index ae884e3..446e218 100644 --- a/datumctl/auth/logging-in.mdx +++ b/datumctl/auth/logging-in.mdx @@ -53,6 +53,30 @@ It then opens an interactive picker so you can select the organization or projec From then on, commands like `datumctl get projects` act inside that context. To view or change your context later, use `datumctl ctx` and `datumctl ctx use`. +If you have access to only one organization and no projects, `datumctl` selects it for you and skips the picker. + +### Choose the context without the picker + +To skip the picker, name the context when you log in with `--project` or `--organization`. `--project` accepts a project ID or `org/project`: + +```bash +datumctl login --project acme-corp/production +``` + +If neither flag is set, `datumctl login` reads `DATUM_PROJECT` and `DATUM_ORGANIZATION` the same way. If none of your organizations or projects match the value, `datumctl` keeps your session and exits with an error that names the value. Run `datumctl ctx` to list the contexts you can use. + +### Log in without a terminal + +The picker needs an interactive terminal. Coding agents and scripts that run `datumctl` without one can still sign a person in. Without a terminal and without a named context, `datumctl login` signs you in, saves the session, and leaves the context unset. It prints this message and exits with status `0`: + +```text +Signed in. No context selected: choosing one needs an interactive terminal. +Run 'datumctl ctx use /' to pick one ('datumctl ctx' lists them), +or sign in with 'datumctl login --project ' next time. +``` + +Choose a context afterwards with `datumctl ctx use your-org-id/your-project-id`, or pass `--project` to each command. If the active context belonged to a different account, `datumctl` clears it so the account you just signed in with becomes the active one. + If context discovery fails (for example, on a restricted network), `datumctl` still saves your credentials and tells you to set a context manually with `datumctl ctx use`. Your login is not lost. diff --git a/datumctl/plugins/using-plugins.mdx b/datumctl/plugins/using-plugins.mdx index 3794f252f5e8077312276219914537e80e368a04..f4452f88acd5f48fb70f96e9c4425c4319592bd3 100644 GIT binary patch delta 1164 zcmeH@F-`+95Jjn2glG^TB&vUaEJ{UB!y!P3G3&{$quue!_7bRa2v>AD0unu<;ToI; zdy^s;KxyLY&-jo3^Zee#+mG*Jd1oDbyjcmf$DomG_|1V(zUFk~tTm zI;QKbe(y}Orw5>%Q*W>{*ylM{skbnp0gV$AkP*$Vl*9`=Z>)4#2RHbTM9wG8Yn*gR zm>F($!pOM~kAy|T0H^d3-u5;