Skip to main content
The CLI keeps a local session pointed at an image. This quickstart uses contree-cli 0.9.4 and ubuntu:latest to save a file in one operation and read it in the next.
1

Install and authenticate

Create an API key and copy the project ID as described in Set up access, then install CLI 0.9.4:
contree auth prompts for the API key without echoing it, then for the project ID, and saves a local profile. Values supplied through flags or environment variables skip the corresponding prompt. contree auth ls probes the profile. Continue when its status is ok.For non-interactive profile registration, set the CLI-specific project variable before running auth:
The CLI reads these values when registering the profile. Later CLI commands use the saved profile.
2

Find and select an image

List available Ubuntu images and note the immutable UUID in the first column:
Select ubuntu:latest in a unique local session:
A tag is convenient for discovery, but it can move. Record the resolved image UUID when reproducibility matters.
3

Save and reuse a file

CLI runs retain changes and advance the session unless -D or --disposable is present. Choose the retained mode by omitting that flag before submitting the first command:
Expected output from the second command:
Each command starts fresh compute. The session carries the selected image, working directory, staged files, and history; it does not keep the previous VM or process running.
4

Verify disposable behavior

Use -D for a command whose filesystem changes must not advance the session:
The second command exits successfully because the previous disposable run did not change the session image.

​
Continue