Delta CLI
Delta CLI is a command line interface for the Delta service.
This repository contains the Delta command router, version output, and browser-based CLI authentication.
Features
- Built-in help via
delta --helpand per-command--help - Version output via
delta versionanddelta --version - OAuth login with Authorization Code + PKCE
- One-shot
127.0.0.1:8400callback server or an optional Console callback handoff - Session storage in
~/.trampoline-ai/delta/auth.jsonwith owner-only permissions - Automatic bearer authentication for service API commands
Requirements
- Python 3.13+
- uv
Installation
From this directory, install the CLI in editable mode:
uv tool install -e .
You can also run the CLI directly during development:
uv run --with-editable . delta --help
uv run --with-editable . delta version
Authentication Setup
The CLI uses a public OAuth application. Do not use secret keys for interactive CLI user login.
The local session is stored in ~/.trampoline-ai/delta/auth.json. Delta creates the
containing directory with mode 0700 and writes the credential file atomically with
mode 0600.
Create an OAuth application in the same auth project as ../console:
- Default redirect URI:
http://127.0.0.1:8400/callback - Console callback URI for
--manual-callback:https://cloud.avalanche.run/oauth/callback - Public client: enabled
- PKCE required: enabled
- Scopes:
profile email offline_access user:org:read
A Clerk administrator must register the applicable redirect URI before its login mode can succeed.
The production issuer, public OAuth client ID, and callback port are built in. Sign in without configuration:
delta login
For another deployment, override the public auth configuration explicitly:
export DELTA_AUTH_ISSUER_URL="https://your-auth-issuer.example.com"
export DELTA_AUTH_CLIENT_ID="your_oauth_client_id"
For local development in this monorepo, the CLI can also derive the issuer from
DELTA_AUTH_PUBLISHABLE_KEY.
Command Overview
delta version
Shows the installed Delta CLI version.
delta auth login
Signs in to Delta through your browser.
delta login
The CLI uses the registered callback port 8400. Pass --callback-port 0 for a
random loopback port when another provider supports RFC 8252 loopback redirects.
Use --no-browser to print the sign-in URL instead of opening it:
delta auth login --no-browser
Use the Console callback when the browser cannot reach the local loopback listener:
delta auth login --manual-callback
Manual callback sign-in requires Delta CLI 0.1.6 or newer. Older CLI releases cannot complete this handoff; upgrade the CLI and start sign-in again if the Console reports that an upgrade is required.
Complete sign-in in the browser, select Copy response at the Console callback page, then paste only that response into Delta's hidden terminal prompt. Never copy, paste, log, or share the raw browser callback URL. The response is bound to the in-memory PKCE sign-in attempt; do not paste it into logs or chat.
delta auth status
Shows whether you are signed in.
delta auth whoami
Shows the signed-in account.
delta auth logout
Signs out of Delta.
delta --help
Shows available commands and global options.
Portable Avalanche workspaces
Capture one or more local directories as typed ava.Workspace run inputs:
delta runs create demo-flow \
--workspace source=./input-tree \
--workspace config=./config-tree
Each field name must be unique across --workspace and JSON inputs. Delta
captures the directory with Avalanche's workspace manifest codec and uploads the
manifest through the run-scoped artifact path; workflow code receives
ava.Workspace when its declared input field uses that annotation. Manifests
are limited to 48 MiB; the CLI rejects oversized trees from directory metadata
before reading their file contents.
Materialize terminal workspace trees into a new local directory:
delta runs output run_01KCVST2FP4QC5NKZNN5NS0Z2W --output-dir ./downloaded
The destination must not already exist. Workspace values are written as
workspace-0001, workspace-0002, and so on in deterministic result order.
Mixed ava.File references remain in the result envelope. Without
--output-dir, runs output continues to print that standard Avalanche result
document unchanged.
Service API commands automatically load and refresh the signed-in session from
~/.trampoline-ai/delta/auth.json. An explicit --token wins, then a nonblank
DELTA_TOKEN, then the saved session; the user TOML configuration rejects plaintext
tokens.
The API enforces the selected Clerk organization and its role permissions. The signed-in user must belong to the requested organization, and that role must include the Delta action used by the service command.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file trampoline_delta-0.1.7.tar.gz.
File metadata
- Download URL: trampoline_delta-0.1.7.tar.gz
- Upload date:
- Size: 181.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9693354e479a6ffcb8f322dbb53d3f03767efbe115ff34c99da2cf4965ba120e
|
|
| MD5 |
ae707c927485b307c76c30ec08965a4a
|
|
| BLAKE2b-256 |
bdb6bd257f7cb5d0922c491a93b050b643b6edf27d3aa67e4b33fd7d129917f2
|
Provenance
The following attestation bundles were made for trampoline_delta-0.1.7.tar.gz:
Publisher:
release.yml on Trampoline-AI/trampoline-ai.delta
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
trampoline_delta-0.1.7.tar.gz -
Subject digest:
9693354e479a6ffcb8f322dbb53d3f03767efbe115ff34c99da2cf4965ba120e - Sigstore transparency entry: 2579731088
- Sigstore integration time:
-
Permalink:
Trampoline-AI/trampoline-ai.delta@d8a3a4c953ccb2000cc7220c26d07a0dcb9569c5 -
Branch / Tag:
refs/tags/v0.1.7 - Owner: https://github.com/Trampoline-AI
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d8a3a4c953ccb2000cc7220c26d07a0dcb9569c5 -
Trigger Event:
push
-
Statement type:
File details
Details for the file trampoline_delta-0.1.7-py3-none-any.whl.
File metadata
- Download URL: trampoline_delta-0.1.7-py3-none-any.whl
- Upload date:
- Size: 160.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c9dc866fbd226e8b7b0ab4ce48d059529c71cba75c91b3ec00cbd9ba49d1fbd5
|
|
| MD5 |
f35b20341c7a3a2537c97e4278592f3a
|
|
| BLAKE2b-256 |
680653065a537549382625b795d1924a635138fb64406f3e5f7283a0f15fd328
|
Provenance
The following attestation bundles were made for trampoline_delta-0.1.7-py3-none-any.whl:
Publisher:
release.yml on Trampoline-AI/trampoline-ai.delta
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
trampoline_delta-0.1.7-py3-none-any.whl -
Subject digest:
c9dc866fbd226e8b7b0ab4ce48d059529c71cba75c91b3ec00cbd9ba49d1fbd5 - Sigstore transparency entry: 2579731092
- Sigstore integration time:
-
Permalink:
Trampoline-AI/trampoline-ai.delta@d8a3a4c953ccb2000cc7220c26d07a0dcb9569c5 -
Branch / Tag:
refs/tags/v0.1.7 - Owner: https://github.com/Trampoline-AI
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d8a3a4c953ccb2000cc7220c26d07a0dcb9569c5 -
Trigger Event:
push
-
Statement type:
