Skip to main content

Wiki selection

An explicit flag wins over the environment variable, which wins over the nearest project link.
PrioritySourceExample
1Command flag--wiki acme/company-handbook
2EnvironmentALMANAC_WIKI=acme/company-handbook
3Nearest project link.almanac.yaml in the directory or an ancestor
There is no global selected wiki.

Environment variables

VariablePurpose
ALMANAC_TOKENAPI key or access token for CLI automation
ALMANAC_WIKIDefault workspace/wiki handle for wiki commands
ALMANAC_API_URL appears in the REST examples only as a shell convenience for
curl; it is not a public CLI endpoint override. Python code can pass a custom
api_url= directly when a controlled environment provides one.
.almanac.yaml
wiki: acme/company-handbook
Commit the link when a repository belongs to a wiki. Do not commit tokens. Apply these settings in Create and link a wiki or CLI automation.