Skip to main content

elan-cli

The command line a developer deploys an agent with. Installs the elan command.

uv tool install elan-cli        # or: pipx install elan-cli

Requires Python 3.12 or newer.

Getting started

elan login                      # device-code sign-in against the platform
elan init --tenant acme --project agents
elan env                        # build the project's venv
elan validate                   # say no here, where saying no is free
elan deploy
elan invoke invoice-triage --text "What do I owe on INV-9?"

elan login reaches the production API by default. Point it elsewhere with elan login --api https://…, or set ELAN_API.

What it covers

Group Commands
Signing in login, logout, whoami
Project setup init, new {agent,workflow}, projects {ls,create}
Local development env, adk, validate
Shipping deploy, status, logs, rollback
Operating agents, invoke, doctor, destroy
Secrets secret {set,ls,rm}
Files files {ls,get,put,rm}
Wallets wallet {ls,show,create,credit,adjust,freeze,unfreeze,statement}

elan <command> --help for the flags.

Where it keeps things

Configuration is a plain JSON file at ~/.config/elan/config.json, mode 0600, holding only public values — the API URL, the issuer, the client id. Override the directory with ELAN_HOME, or the API with ELAN_API.

Credentials never go in a file. The refresh token is stored in the OS keyring under the service name elan-cli. The CLI will not fall back to writing one to disk; if keyring cannot be reached it says so and stops.

Per-project state lives in .elan/ beside your elan.yaml, and is git-ignored.

Exit codes

0 it worked
1 it ran, and the answer was no — a refused deploy, a failed validation
2 it could not run — no project, no credential, no network

Errors print as error: … on stderr with no traceback.

Documentation

The full command reference and the platform guides are at https://openelan.ai/app/docs.

Licence

Apache-2.0. See LICENSE.

Metadata

Release files for elan-cli 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for elan-cli 0.1.3
File Size Uploaded Provenance Actions
elan_cli-0.1.3.tar.gz 68.3 kB Without provenance Details for elan_cli-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for elan-cli 0.1.3
File Interpreter ABI Platform Actions
elan_cli-0.1.3-py3-none-any.whl Python 3 none any Details for elan_cli-0.1.3-py3-none-any.whl

Total release size: 148.7 kB

Release files / elan_cli-0.1.3.tar.gz

Download URL elan_cli-0.1.3.tar.gz
Size 68.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cdb8de1a689b1add6cc508a316dd501d967ff93432cf7b9fed523800ab385d92
BLAKE2b-256 checksum
How to use checksums
3f4d5b6a869a582d3692e20c1df09bfc7d99f890439c7ba5d38baff9f2c6b5ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / elan_cli-0.1.3-py3-none-any.whl

Download URL elan_cli-0.1.3-py3-none-any.whl
Size 80.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
130ccd9c55f559e06d3708f1fabe36a059fbf46fdba1a5577328bc1d5b9bc05a
BLAKE2b-256 checksum
How to use checksums
f94eed288c8a2254a185f784c478c5b41b0d578d1ca8a0c041216a95733c2f88
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for elan-cli 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page