CLI

Install the Kestroll CLI to search, upload, and message the agent from your terminal.

Install

Run the install script in a terminal. It detects your OS and architecture, then installs the kestroll binary to ~/.local/bin.

curl -fsSL https://kestroll.com/install.sh | sh
View install script

Authentication

Sign in through your browser or with an organization API key.

To log in via browser:

kestroll login

To authenticate without a browser, create an API key in Settings → API Keys, then set it in your environment. The token takes precedence over a saved browser login. Keep it out of source control and command output.

export KESTROLL_TOKEN=kest_...
kestroll me

Unset KESTROLL_TOKEN to stop using it. Thekestroll logout command does not revoke an API key; revoke it from Settings → API Keys instead.

Commands

kestroll login — sign in via your browser
kestroll me — show the current user and organization
kestroll logout — sign out and clear local credentials
kestroll tools sessions create — create a current tools session for tools call commands
kestroll tools call search --input '{"query":"<query>"}' — search your org's assets through the tools interface
kestroll upload <local-path> [kestroll-path] — upload a file or folder
kestroll download <kestroll-path> [local-path] — download an asset; add --recursive for a folder
kestroll agent "<message>" — send a message to a Kestroll agent and print its reply
kestroll update — check for and install the latest CLI release

Example:

kestroll tools sessions create
kestroll tools call search --input '{"query":"Mbappe interview"}'
kestroll upload ./clip.mp4
kestroll agent "Make a rough cut of clip.mp4"