Skip to main content

Where did this value come from?

A value can come from a source, a put or a template, and the cascade can find it in any directory above you. When a value surprises you, you can look at each part on its own.

Add a colon and one of these to a namespace's name:

ask forto see
team:putonly the values that were put
git:sourceonly the values sources made
prompt:templatethe templates themselves, not worked out
git:cachewhat the daemon knows about each value

These views are called facets. Each one has the same shape as the namespace, so you can read a whole facet or one value in it:

$ comb get team:put
name=checkout
$ comb get prompt:template
where={{ git.branch ~ ' · ' if git.branch }}{{ team.name }}
$ comb get git:source.branch
main

What the daemon knows​

:cache answers "how old is this, and what keeps it fresh?":

$ comb get git:cache.branch
age_ms=26326
source=source(head)
watch.0=.git/HEAD
…

git.branch was made 26 seconds ago by git's head source, and is made again when .git/HEAD changes.

Every layer at once​

comb status --tree shows each value with every layer behind it: which put, source or template could answer, in the order the cascade tries them.

That's the whole of comb: one tree of named values, each found by going up from where you are, each made by a source, a put or a template.

Where next​