atlas favorites#

file version: 10 July 2026

Overview#

atlas favorites manages favorite directory shortcuts. Favorites are stored server-side in your user preferences and shared across atlas invocations.

@alias and @alias/subpath path expansion works everywhere a path is accepted, both interactive and batch. For example:

atlas ls @home/data
atlas stage @archive/2026/q2/*.tar

This works after atlas favorites add /users/alice --alias home.

Usage#

atlas favorites [flags]
atlas favorites [command]

Commands#

Command

Description

list

List all favorites (default)

add

Add a favorite; alias defaults to the basename

delete

Remove a favorite by alias or path

Examples#

atlas favorites list
atlas favorites add /hsm/arch/project
atlas favorites add /users/alice --alias home
atlas favorites add /data/projects/atlas
atlas favorites delete @home
atlas favorites delete /data/projects/atlas

Global Flags#

Flag

Description

--ca-cert string

Path to CA certificate for server verification

--format string

Machine-readable output format (json or csv); omit for the default human-readable output

-L, --lang string

Interface language (en, de)

--no-color

Disable color output

-P, --plaintext

Use plaintext (non-TLS) connection

-s, --server string

ATLAS server address; defaults to ACLI_SERVER, then the stored session, /etc/atlas/atlas.conf, and finally localhost:7449

--tls-skip-verify

Skip TLS certificate verification; enabled by default for self-signed setups