ADK CLI v1.18.0-beta.4

v1.18.0-beta.3

Highlights

• Complete Dev Console redesign — topbar navigation, icon rail, command palette, global Dev/Prod environment switcher

• Full CLI-first tooling — new commands (adk check, adk status, adk logs, adk traces, adk workflows), JSON output, non-interactive mode

• Bot Secrets and environment-specific configuration variables

• Conversation lifecycle management — nudge and expiration support

• Custom component support for webchat via LLMz bridge

---

New CLI Commands & Flags

Command	Description
adk check	Offline project validation — catch config and schema errors before deploying
adk status	Project info: name, primitives, integrations (--format json for structured output)
adk logs [error|warning]	Query dev server logs, build output, and errors (--summary for condensed JSON)
adk traces [filters...]	Query trace spans for debugging conversations and workflows
adk workflows list	Discover available workflows
adk workflows inspect <name>	Get workflow input schema
adk workflows run <name> '<payload>'	Execute a workflow
adk chat --single "<message>"	Send a single message and exit (great for scripting and AI agents)
adk dev --non-interactive	Run dev server without interactive TTY (CI/agent-friendly)
adk init --format json	Non-interactive project creation with JSON input

• --format json added to adk status, adk logs, adk check, adk chat, adk traces, adk workflows for machine-readable output

• Centralized CLI logger with structured JSON support (#371)

• MCP tools deprecated as thin CLI pass-throughs — CLI commands are now the primary interface (#330)

Dev Console

Navigation overhaul:

• Sidebar replaced with compact topbar navigation with grouped views (Chat, Components, Test, Data, Observe, Config)

• Icon rail — always-visible vertical rail showing active group's sub-items

• Remembers last visited sub-view per group for quick navigation

• Agent Info moved to a modal — accessible from anywhere via ADK logo

⠀

Command Palette (⌘K):

• Recent pages, full page search, and quick commands

• Toggle theme, open bots in Botpress Cloud, copy Bot ID/Workspace ID

• Forward search queries to agent(0) copilot

• Production-aware — dev-only pages disabled in Prod mode

⠀

Global Environment Switcher (Dev ↔ Prod):

• Toggle via top-right badge or ⇧⌘E keyboard shortcut

• All views target the production agent when in Prod mode

• Dev-only views disabled with visual indicators; auto-redirect on dev-only pages

• Purple "Production Mode" pill as clear visual indicator

• Environment state synced with server, persists across reloads

⠀

New pages & views:

• Integration Hub — official Botpress integration hub component for browsing, configuring, and managing integrations

• RAG Search — redesigned with toolbar, KB filtering, and resizable split-pane layout

• Knowledge Base Finder — file drawer with search and document preview

• Files — Finder-style file browser with folder categories (All, KB, System, Webchat)

• Event Triggering — fire and replay integration events directly from the Triggers page

⠀

Visual polish:

• Warm Stone light theme for dark/light consistency

• Restyled toaster notifications

• resizable panel handles

• Skeleton shimmer loading states

• Motion transitions throughout

• Per-page error boundaries

⠀

Runtime

• Conversation lifecycle management — nudge and expiration support (#377)

• Custom component support — bridge CustomComponent with LLMz chat component system for webchat (#389, #367)

• Workflow notify — workflows can send events back to conversations via step.notify() (#349)

• action.asTool() — convert any Action to a Tool with a single method call (#295)

• Knowledge base .search() — KB instances own their search method directly (#299)

• Typed Eval class — replaces defineEval, supports multiple evals per file (#288)

• Streaming agent steps — real-time step execution streaming (#347)

• State mutation capture — trace state values and changes in agent steps (#281)

⠀

Bot Secrets & Environment Config

• Bot secrets fully wired through the ADK — configure secrets per environment (#392)

• Environment-specific configuration variables — set different config values for Dev vs Prod (#416)

• Build-time secret warnings now validate against the correct active environment (#409)

⠀

adk init Improvements

• File-based agent templates — choose from pre-built templates during init (#293)

• Auto-install ADK skills during project creation (#362)

• Inline comments in generated agent.config.ts and index.ts files (#284, #280)

• Non-interactive JSON mode for CI pipelines (#334)

• No longer reprompts for bot name when creating a new bot (#303)

• No longer requires interactive TTY (#316)

⠀

Integration Management

• Integration Hub component in Dev Console (#391)

• adk add now accepts integration IDs (#289)

• Consistent error messages for add/remove commands (#360)

• Chat integration auto-added to dependencies.json when using adk chat (#302)

• Fixed enabled-state mismatch false positives (#352)

• Correct app host for staging bot links (#353)

⠀

Agent-Friendliness (AI Coding Assistant Support)

• All major commands support --format json for structured output

• adk dev --non-interactive for headless operation

• adk chat --single for one-shot message testing

• MCP tools deprecated in favor of CLI commands

• CLI-first tooling documentation added to CLAUDE.md (#363)

⠀

Bug Fixes

• Preserve server-side plugin config during adk deploy (#415)

• step.request() now works with custom step names (#329)

• adk chat --single properly exits after receiving response (#318)

• project.cache.json parse error on first run (#319)

• Integration config migration warning now actionable in non-interactive mode (#317)

• Keep typing indicator alive during long operations (#305)

• Show error states when webchat/conversation handler missing (#331)

• Disable conversations from unsupported channels in emulator (#327)

• Don't mark website KB source as synced when 0 URLs discovered (#384)

• Clear stale component arrays on reload (#387)

• Unified adk dev stderr/stdout output streams (#324)

• adk status action count no longer confusing (#320)

• Allow patch-version compatibility between CLI and runtime (#275)

• agent.local.json used instead of agent.json to keep credentials out of git (#279)

⠀

Internal

• Shared analytics tracking across CLI and Dev Console (#297)

• Centralized CLI logger with JSON support (#371)

• Renamed internal server/process symbols for clarity (#385)

• Externalized esbuild in CLI bundle (#388)

• Removed unused CLI demo commands (#372)

⠀

Tooling

• chore: update integration hub version (#421)

Fixes

• fix: replace esbuild with Bun.build() for component bundling (#422)

Installation

• npm: bun add -g @botpress/adk-cli
• GitHub releases: download the matching binary from botpress/adk