Orkestia
Blog
DevKit

Install DevKit

Install ltinteg-devkit from GitHub Releases, Homebrew, or Go, then configure an API token

Requires nothing but the binary on a supported OS (Linux, macOS, Windows — amd64 and arm64). Go 1.26+ only if you build from source.

Download the archive for your OS/arch from GitHub Releases, verify checksums.txt, put ltinteg-devkit on your PATH.

# Example: linux/amd64 — replace <version>
curl -fsSL -o devkit.tar.gz \
  https://github.com/ltinteg/ltinteg-devkit/releases/latest/download/ltinteg-devkit_<version>_linux_amd64.tar.gz
tar -xzf devkit.tar.gz
sudo install -m 0755 ltinteg-devkit /usr/local/bin/
ltinteg-devkit --version

Homebrew

brew install --cask ltinteg/tap/ltinteg-devkit

go install

go install github.com/ltinteg/ltinteg-devkit@latest

--version reports dev (no embedded build info). Use a release archive when you need a stamped version.

Configure

  1. In the Orkestia app: Settings → API tokens → Create. Copy the value once.
  2. Run:
ltinteg-devkit configure

This writes ~/.config/ltinteg-devkit/config.json (override with $LTINTEG_CONFIG). Env vars always win:

Config / envPurpose
api_key / LTINTEG_API_KEYBearer token
api_base_url / LTINTEG_API_BASE_URLCore API (default https://api.orkestia.dev)
workflow_api_base_url / LTINTEG_WORKFLOW_API_BASE_URLWorkflow API (default https://workflow-api.orkestia.dev)
redirect_uuid / LTINTEG_REDIRECT_UUIDHook redirect to redirect
local_target / LTINTEG_LOCAL_TARGETForward destination (http://localhost:3000)

Never commit a populated config.json. DevKit warns if the file is group/world-readable.

A hosted broker can use api_key_file / LTINTEG_API_KEY_FILE (absolute path to a projected secret). Mutually exclusive with api_key. The file is re-read every request so rotation does not need a restart.