Organization context and environment variables

Organization selection

Priority	Source	Example
1	Command flag	`--organization acme`
2	Environment	`ALMANAC_ORGANIZATION=acme`
3	Nearest project link	`.almanac.yaml` in the directory or an ancestor
4	Active signed-in Organization	The Organization selected during sign-in
5	Sole Membership	Used only when exactly one Organization is available

If none of these produces one Organization, the command fails and asks for an explicit choice. Almanac never selects the first Membership.

Variable	Purpose
`ALMANAC_TOKEN`	API key or access token for CLI automation
`ALMANAC_ORGANIZATION`	Default Organization ID or slug
`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

organization: acme

Commit the link when a repository belongs to an Organization. Do not commit tokens. Apply these settings in Link an Organization or CLI automation.