SeekAPI CLI

Deploy and manage workers on SeekAPI from the terminal.

Install

Depuis npm (quand publié) :

npm install -g seekapi-cli

Distribution privée (sans publier) — pour partager avec un associé :

1. Pack .tgz (recommandé) : dans ce dossier, exécuter npm run build && npm pack. Cela crée seekapi-cli-0.1.0.tgz. Envoyer ce fichier (email, lien, clé USB). L’associé installe avec :

   npm install -g ./seekapi-cli-0.1.0.tgz

2. Depuis le repo Git : si le dépôt est accessible (GitHub privé, GitLab, etc.) :

   npm install -g git+https://github.com/votre-org/lambda-only-mvp-docs.git#main:cli

   (remplacer l’URL et la branche/ref si besoin ; :cli pointe vers le sous-dossier.)

3. Dossier local : copier le dossier cli/ (après npm install et npm run build), puis :

   cd chemin/vers/cli && npm install -g .

Or run from the repo (after npm install and npm run build):

node dist/index.js --help

Commands

Login

Save your API key so you don't need to pass it every time. The key is stored in ~/.seekapi/config.json (permissions 600).

seekapi-cli login
# Prompts for API key (input hidden)

seekapi-cli login --api-key YOUR_KEY
seekapi-cli login --api-key YOUR_KEY --base-url https://api.seek-api.com

You can also set SEEKAPI_API_KEY and run seekapi-cli login to use it.

Default base URL is https://api.seek-api.com (production). Existing configs that still point to the legacy backend ALB URL are migrated automatically at runtime.

List workers

seekapi-cli worker ls
# or
seekapi-cli w ls

Deploy a worker

From a worker directory that contains worker.yaml (with worker_id):

cd path/to/your/worker
seekapi-cli worker deploy

Or specify the directory and worker ID:

seekapi-cli worker deploy --path ./my-worker --worker-id my-worker-id

Options:

• -p, --path <dir> — Worker directory (default: current directory)
• --worker-id <id> — Worker ID (default: read from worker.yaml)
• --no-poll — Trigger deploy and exit without waiting for completion
• --poll-interval <seconds> — Poll deployment status every N seconds (default: 10)

The deploy command:

1. Creates a zip of the worker directory (excludes .git, .DS_Store)
2. Gets a presigned upload URL from the API
3. Uploads the zip to S3
4. Triggers the deployment
5. Polls until the deployment succeeds or fails (unless --no-poll)

On failure, build logs are printed.

Requirements

• Node.js 18+
• A SeekAPI account and API key (from the dashboard after email verification)

Config file

After seekapi-cli login, config is stored at:

• Unix / macOS: ~/.seekapi/config.json
• Windows: %USERPROFILE%\.seekapi\config.json

Contents: { "apiKey": "...", "baseUrl": "https://..." }. Do not share this file.