Skip to content
Keboola Docs

CLI

kbagent, the Keboola command-line interface — an AI-friendly CLI to manage projects, configs, jobs, storage, flows, and dev branches across your whole organization, driven by you or your coding agent.

kbagent is Keboola’s command-line interface: one tool to manage all your Keboola projects from the terminal — browse and edit configurations, run and monitor jobs, work with Storage, build flows, sync configs as local files, and drive development branches — across many projects and stacks at once. It’s built to be equally comfortable in your hands and in an AI coding agent’s, with structured JSON output and built-in safety controls.

Terminal window
# install
curl -LsSf https://raw.githubusercontent.com/keboola/cli/main/install.sh | sh
# connect a project
kbagent project add --project prod --url https://connection.keboola.com --token YOUR_TOKEN
# explore
kbagent doctor
kbagent job list --limit 5
kbagent search "customer_id"

Everything the UI does — and a lot the UI doesn’t — is a command away, scriptable, and safe to hand to an agent.

The pages read in order, from first run to deep reference:

  1. Get started — install, connect a project, run your first commands (a guided walkthrough).
  2. Concepts — how kbagent works: the connection model, multi-project, dev branches, GitOps sync, and the safety firewall.
  3. How-to guides — task recipes: onboard an org, dev-branch workflow, GitOps sync, audits, CI/CD tokens, encryption.
  4. Use with AI agents — the Claude Code plugin, kbagent context, and sandboxing an agent.
  5. Command reference — every command group, global flags, JSON output, and error codes.
  6. Web UI — the optional local browser dashboard.
ToolUse it for
kbagent CLIScripting and multi-project operations from your terminal; giving an agent safe, sandboxed control.
MCP serverLetting an AI client call Keboola tools directly over MCP.
AI KitCoding-assistant plugins for building Keboola components and apps.
KaiThe in-product AI assistant.

Next: Get started with kbagent →

Ask Kai

Ask anything about Keboola — I'll search the docs and cite the pages I use.