Skip to content

latere-ai/latere-cli

Repository files navigation

latere

Command-line interface for the Latere product family: one binary for Cella sandboxes, Lux model access, and Agon adversarial review.

Install

curl -fsSL https://latere.ai/install.sh | sh

The installer writes to $HOME/.local/bin by default, so normal installs do not require sudo. If that directory is not on your PATH, the installer prints the line to add to your shell profile.

Other install paths:

# Pin a version
curl -fsSL https://latere.ai/install.sh | sh -s -- v0.2.5

# System-wide install
curl -fsSL https://latere.ai/install.sh | PREFIX=/usr/local sh

# Build from source
go install github.com/latere-ai/latere-cli/cmd/latere@latest

Release binaries are attached to GitHub releases for Linux, macOS, and Windows on amd64 and arm64.

The installer resolves the latest version from the GitHub releases redirect rather than the rate-limited GitHub API, so it works from networks behind shared NAT. If version resolution still fails (restricted network or proxy), pin a version explicitly with the sh -s -- vX.Y.Z form above.

Stay up to date

latere keeps itself current. Auto-upgrade is on by default: it checks for new releases at most once a day, and the next time you run a command after a new release appears, it updates itself in place before running your command. You can also drive it manually:

latere upgrade            # install the latest release now
latere upgrade v0.2.29    # install a specific release — this is how you roll back
latere upgrade --check    # report whether a newer release exists, without installing
latere upgrade --auto off # turn auto-upgrade off
latere upgrade --auto on  # turn it back on

If an auto-upgraded release turns out to be broken, roll back with latere upgrade <previous-version> and optionally latere upgrade --auto off to stay put. Every install verifies the release archive's checksum before replacing the binary.

Auto-upgrade and the daily notice are skipped for go install/dev builds, in CI, when output is not a terminal, and when latere lives somewhere you cannot write (for example a system-wide PREFIX=/usr/local install) — there latere upgrade tells you to re-run the installer instead. Set LATERE_NO_UPDATE_CHECK=1 to silence the check entirely.

Self-update is unavailable on Windows (the running binary is locked); download the archive you want from the releases page instead.

Sign in

latere auth login

latere auth login starts the OAuth2 device-code flow against auth.latere.ai. It prints a URL and user code, waits for browser approval, then saves the token to ~/.config/latere/token.json. One sign-in unlocks every product below.

latere auth whoami
latere auth print-token
latere auth logout

# CI or dashboard-minted tokens
latere auth login --token <token>

Switching the active organization

latere auth org switch <org-uuid>   # scope the saved token to <org-uuid>
latere auth org switch --personal   # scope the saved token to the personal context

org switch uses the auth service's refresh-token grant: no device-code re-prompt, the saved refresh token is exchanged for a new access token scoped to the chosen org. The on-disk token file is rewritten in place.

Setting Purpose
--auth-url Override the auth URL for latere auth login.
LATERE_TOKEN_FILE Token file path, default ~/.config/latere/token.json.

Products

Product What it does Guide
Cella Named sandboxes (ephemeral or persistent): create, exec, shell, logs, file transfer. docs/cella.md
Lux Call language models on your identity, no key to allocate: discovery, SDK enablement, chat, usage, and serving your own local models (Ollama/vLLM/LM Studio/llama.cpp/MLX) through Lux. docs/lux.md
Agon Adversarial review of your latest Claude Code session: a proposer defends the diff, critics attack it through Lux, unresolved attacks surface. docs/agon.md
Topos Remote coding-assistant sessions on the Latere agent platform: start an interactive session, detach and reattach with state intact, approve tool calls inline, or run one prompt headless with -p. docs/topos.md
latere cella apply -f sandbox.yaml
latere lux chat --model openai/gpt-4o-mini "Say hi"
latere agon

Development

go test ./...
go run ./cmd/latere --help

License

MIT. See LICENSE.

About

The latere CLI: a single binary for the Latere product family.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages