@ductape/cli

Terminal interface for Ductape — same transport as the Workbench (encrypted sdk-proxy / db-proxy / graph-proxy).

Install

cd cli
npm install
npm run build

Global ductape command (optional)

npm link installs into npm’s global prefix. If you see EACCES on /usr/local/lib/node_modules, that prefix is owned by root (common with the system Node installer). Use one of these:

Option A — run without linking (no sudo)

npm exec ductape -- login
npm exec ductape -- resources storage list
# or: node dist/index.js login

Option B — user-owned global prefix (recommended for npm link)

mkdir -p ~/.npm-global
npm config set prefix "$HOME/.npm-global"
# Add to ~/.zshrc (or ~/.bashrc):
#   export PATH="$HOME/.npm-global/bin:$PATH"
source ~/.zshrc
cd cli && npm link
ductape --help

Do not use sudo npm link; it mixes root-owned globals with your normal user.

Quick start

ductape install
ductape login                    # uses `cloud` profile (https://api.ductape.app)
# Local platform (UI + API on your machine):
ductape profiles use local
ductape start
ductape login --profile local

# Workbench UI locally, cloud API (no local backend):
ductape start --remote --build
ductape login
ductape init --link
ductape resources storage list
ductape generate snippet storage upload -l typescript -o upload.ts

Command overview

ductape login|logout|whoami|install
ductape profiles list|use <name>
ductape workspaces list|current|use   # interactive picker on login/link/use
ductape products list|get|create|update|delete
ductape apps list|get|create|update|delete|import
ductape init|link|unlink
ductape start|stop|status   # status explains proxy 502 when backend is down
ductape resources <type> <verb>   # CRUD via sdk-proxy (interactive prompts or -f JSON)
ductape cloud connections list|create|get|update|complete|validate|delete
ductape cloud resources list|import|provision …
ductape db <verb>                 # db-proxy runtime
ductape graph <verb>              # graph-proxy runtime
ductape secrets <verb>
ductape generate payload|snippet …
ductape completion bash|zsh

Documentation

Full reference: docs/docs/cli/

Tests

npm test

Changelog

See CHANGELOG.md.