Command ReferenceΒΆ

$ contree --help usage: contree [-h] [-v] [-p PROFILE] [--token TOKEN] [-u URL] [-P PROJECT] [-c CONFIG_PATH]                [-L {debug,info,warning,error,critical}]                [-f {csv,default,json,json-pretty,plain,table,toml,tsv}] [-S SESSION_KEY]                {use,ci,run,r,images,i,img,tag,t,ps,kill,show,ls,cat,cp,file,f,session,s,auth,skill,cd,env,agent,man,shell,sh}                ... ConTree CLI - command-line client for the ConTree sandbox platform. Run sandboxes, manage images, inspect filesystems, and track operations through the ConTree REST API. Authentication:   Bearer token + project ID. Default API URL:     https://api.studio.nebius.com/sandboxes/   Use `contree auth --help` to configure persistent credentials. Coding-agent bootstrap (important):   Agents should read `contree agent` before executing task commands. positional arguments:   {use,ci,run,r,images,i,img,tag,t,ps,kill,show,ls,cat,cp,file,f,session,s,auth,skill,cd,env,agent,man,shell,sh}     use (ci)            Set or show current session image     run (r)             Spawn a sandbox instance     images (i, img)     List and import images     tag (t)             Tag an image     ps                  List operations/instances     kill                Cancel an operation     show                Show operation result     ls                  List files in image     cat                 Show file content from image     cp                  Copy file from image to local path     file (f)            Manage files in session image     session (s)         Manage session branches and history     auth                Configure authentication     skill               Manage agent skills     cd                  Change working directory     env                 Manage session environment variables     agent (man)         Show manual     shell (sh)          Interactive shell mode options:   -h, --help            show this help message and exit   -v, --version         show program's version number and exit   -p PROFILE, --profile PROFILE                         Use this profile for the current command   --token TOKEN         API token (overrides config and env)   -u URL, --url URL     API base URL (overrides config and env)   -P PROJECT, --project PROJECT                         Project ID (overrides config and env)   -c CONFIG_PATH, --config CONFIG_PATH                         Config file path (default: /home/runner/.config/contree-cli/config.ini)   -L {debug,info,warning,error,critical}, --log-level {debug,info,warning,error,critical}                         Logging level (default: info)   -f {csv,default,json,json-pretty,plain,table,toml,tsv}, --format {csv,default,json,json-pretty,plain,table,toml,tsv}                         Output format (default: default)   -S SESSION_KEY, --session SESSION_KEY                         Session key override (alternative to CONTREE_SESSION) examples:   contree use tag:ubuntu:latest       set session image   eval $(contree use tag:ubuntu:latest)  set + export env var   contree run -- uname -a            run command in session image   contree run --shell -- 'echo hi'   shell mode   contree run --file ./app.py:/app.py --disposable -- python /app.py   contree run --file ./src:/app/src -- make -C /app/src   contree images --prefix=ubuntu   contree ps -q   contree show OPERATION_UUID   contree tag IMAGE_UUID latest   contree ls /etc                    list files in session image   contree cat /etc/os-release        show file from session image   contree auth                       save token (secure prompt)   contree auth switch staging   contree man                        user manual   contree agent                      coding-agent manual for users:   contree man for coding agents (required bootstrap):   1) read: contree agent   2) inspect command syntax: contree <command> --help   3) only then execute task commands before running tasks:   ensure auth exists; if missing/invalid, ask user to run `contree auth` high-signal read-only commands:   contree images | ps | show UUID | ls [PATH] | cat PATH | session | session show mutating commands (change remote or local session state):   contree use IMAGE | run -- CMD | file edit PATH | file cp SRC DEST   contree tag UUID TAG | kill UUID | cd PATH | session checkout BRANCH environment variables (advanced overrides; most users can ignore):   CONTREE_TOKEN      API bearer token (overrides config file)   CONTREE_URL        API base URL (overrides config file)   CONTREE_PROJECT    Project ID for IAM auth (overrides config file)   CONTREE_PROFILE    Active config profile (overrides config file)   CONTREE_SESSION    Explicit session name (for multi-terminal workflows).                     If unset, contree auto-generates <cwd>+<8hex> (derived from                     profile+ppid+tty); export your own for stable reuse.                     You can also pass -S/--session instead of exporting env.   CONTREE_SESSION_DB Path to session SQLite database nebius shortcuts (used by `contree auth` as fallback when flags are omitted):   NEBIUS_API_KEY     Fallback token for auth registration   NEBIUS_AI_PROJECT  Fallback project ID for IAM auth registration

Commands