@kezlahd/atlas-cli

Terminal client for the Atlas creative-team platform. Pull/push doc templates, manage files and gear, all from the CLI. Sibling to @kezlahd/atlas-mcp for MCP-based AI editing.

Install

npm install -g @kezlahd/atlas-cli

Or run once via npx:

npx @kezlahd/atlas-cli whoami

Local monorepo dev (inside the atlas repo):

pnpm --filter @kezlahd/atlas-cli build
pnpm --filter @kezlahd/atlas-cli link --global

Setup

1. In the Atlas web UI: pick your workspace → Settings → API keys → Mint token. Copy the plaintext.
2. Run atlas login:

atlas login --token atlas_pat_… --workspace acme-inc

Config lands at ~/.atlas/config.json (0600 perms on POSIX). Env vars – ATLAS_TOKEN, ATLAS_WORKSPACE, ATLAS_API_URL – override the file when set.

Commands

Every command supports --json for scripting.

atlas whoami                                            [--json]
atlas doc list                                          [--kind template|freeform] [--limit N] [--cursor C] [--json]
atlas doc pull      <docId> [-o path]                   [--json]
atlas doc push      <docId> [-i path] [--force]         [--json]
atlas doc revisions <docId>                             [--json]
atlas doc restore   <docId> <revisionId> [--yes]        [--json]
atlas files list                                        [--limit N] [--cursor C] [--json]
atlas files upload   <local-path> [--yes]               [--json]
atlas files download <path> [-o out]                    [--json]
atlas files url      <path>                             [--json]
atlas files rename   <path> --new-name <name>           [--json]
atlas files alt      <path> --text <alt>                [--json]
atlas files delete   <path> [--yes]                     [--json]
atlas gear list                                         [--limit N] [--cursor C] [--json]
atlas gear add    --name X [--brand Y] [--qty N]        [--json]
atlas gear update <id> [--name X] [--brand Y] [--qty N] [--json]
atlas gear delete <id> [--yes]                          [--json]
atlas gear import <csv-path> [--mode replace|append]    [--json]

The pull/push loop

atlas doc pull 3f8a12e4          # writes 3f8a12e4.doc.json + hidden .3f8a12e4.doc.meta.json
$EDITOR 3f8a12e4.doc.json        # edit
atlas doc push 3f8a12e4          # sends If-Match – refuses to overwrite concurrent web edits

If someone edits the same doc in the web UI while you're offline, push returns 409 with a friendly hint to re-pull. --force overrides at your own risk.

Pagination

Every list command supports cursor-based pagination:

atlas doc list --limit 20                                 # first page
atlas doc list --limit 20 --cursor <next_cursor_from_previous>   # next page

Debug

ATLAS_DEBUG=1 atlas … prints stack traces on errors.

Related packages

• @kezlahd/atlas-mcp – MCP server that exposes the same endpoints to Claude Code and other MCP-aware AI agents.

Source for both packages lives in the Atlas monorepo.

License

MIT