feat: Appkit cli commands #4247

MarioCadenas · 2026-01-11T10:43:37Z

Changes

Overview

This PR adds new AppKit development commands to databricks apps, making them first-class citizens alongside the auto-generated Apps API commands. The implementation follows the same pattern established by the pipelines commands.

New Command Structure

databricks apps now has three command groups:

Group	Commands	Description
Available Commands	`deploy`, `dev-remote`, `init`, `logs`, `run-local`, `validate`	Custom development commands
Management Commands	`create`, `delete`, `get`, `list`, `start`, `stop`, etc.	Auto-generated API commands
Permission Commands	`get-permissions`, `set-permissions`, etc.	Permission management

Key Features

databricks apps init - Initialize new AppKit projects from templates with interactive prompts, but also allowing full prompt override via flags.
databricks apps dev-remote - Run local Vite dev server with WebSocket bridge to remote app (this command already exists, but now has some improvements like deriving the project from the folder and reconnecting).
databricks apps validate - Run validation of the app running type checking, linting and building.
databricks apps deploy - Dual-mode deployment:
- Bundle mode (when databricks.yml exists): Validates → Deploys bundle → Runs app
- API mode: Standard API deployment with APP_NAME argument

Directory Structure

cmd/apps/                    # Custom commands
├── apps.go                  # Commands() + ManagementGroupID
├── init.go                  # Initialize projects
├── dev.go                   # Dev-remote command
├── deploy_bundle.go         # Bundle-aware deploy
├── logs.go                  # App logs
├── run_local.go               # Run locally
└── validate.go             # Validate the project compiles

cmd/workspace/apps/          # Auto-generated + overrides
├── apps.go                  # SDK commands
├── overrides.go             # Imports cmd/apps, groups commands
└── errors.go                # Error handling

libs/apps/                   # Shared libraries
├── features/                # Feature definitions
├── prompt/                  # Interactive prompts
├── validation/              # Project validation
└── vite/                    # Vite bridge

Why

Tests

eng-dev-ecosystem-bot · 2026-01-14T09:24:55Z

Commit: 565b25a

Run: 21269112509

	Env	❌FAIL	🟨KNOWN	🔄flaky	💚RECOVERED	🙈SKIP	✅pass	🙈skip	Time
🟨	aws linux		3		5	6	411	701	21:30
🟨	aws windows		3		5	6	413	699	19:24
❌	aws-ucws linux	4	3		8	5	596	574	93:11
❌	aws-ucws windows	4	3		8	5	598	572	95:09
💚	azure linux				2	8	411	700	19:10
💚	azure windows				2	8	413	698	21:15
❌	azure-ucws linux	5	1	1	4	7	590	573	87:42
❌	azure-ucws windows	5	1	1	4	7	592	571	80:39
💚	gcp linux				2	8	400	706	19:26
💚	gcp windows				2	8	402	704	17:56

22 interesting tests: 8 RECOVERED, 5 SKIP, 5 FAIL, 3 KNOWN, 1 flaky

	Test Name	aws linux	aws windows	aws-ucws linux	aws-ucws windows	azure linux	azure windows	azure-ucws linux	azure-ucws windows	gcp linux	gcp windows
🟨	TestAccept	🟨K	🟨K	🟨K	🟨K	💚R	💚R	🟨K	🟨K	💚R	💚R
🙈	TestAccept/bundle/deployment/bind/alert	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/bundle/generate/alert	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
❌	TestAccept/bundle/invariant/no_drift	🙈s	🙈s	❌F	❌F	🙈s	🙈s	❌F	❌F	🙈s	🙈s
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=alert.yml.tmpl			❌F	❌F			❌F	❌F
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=cluster.yml.tmpl			✅p	✅p			❌F	❌F
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_catalog.yml.tmpl			❌F	❌F			❌F	❌F
❌	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=synced_database_table.yml.tmpl			❌F	❌F			❌F	❌F
🙈	TestAccept/bundle/resources/alerts/basic	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/bundle/resources/alerts/with_file	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🙈	TestAccept/bundle/resources/permissions	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🟨	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions	🟨K	🟨K	🟨K	🟨K	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🟨	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions/DATABRICKS_BUNDLE_ENGINE=direct	🟨K	🟨K	🟨K	🟨K
💚	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/with_permissions/DATABRICKS_BUNDLE_ENGINE=terraform	💚R	💚R	💚R	💚R
💚	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions	💚R	💚R	💚R	💚R	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
💚	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=direct	💚R	💚R	💚R	💚R
💚	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=terraform	💚R	💚R	💚R	💚R
🔄	TestAccept/bundle/resources/quality_monitors/change_table_name	🙈s	🙈s	✅p	✅p	🙈s	🙈s	🔄f	🔄f	🙈s	🙈s
💚	TestAccept/bundle/resources/synced_database_tables/basic	🙈S	🙈S	💚R	💚R	🙈S	🙈S	💚R	💚R	🙈S	🙈S
💚	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct			💚R	💚R			💚R	💚R
💚	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform			💚R	💚R			💚R	💚R
💚	TestAccept/ssh/connection	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R	💚R

Top 50 slowest tests (at least 2 minutes):

duration	env	testname
7:04	aws-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
6:40	aws-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
6:35	aws-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
6:25	aws-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
6:13	aws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
6:09	aws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
6:03	aws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
6:01	gcp windows	TestSecretsPutSecretStringValue
6:00	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:40	aws-ucws windows	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
5:40	aws-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:31	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
5:29	gcp windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:26	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:24	gcp linux	TestAccept/ssh/connection
5:21	aws-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:19	aws linux	TestAccept/ssh/connection
5:16	aws-ucws linux	TestAccept/ssh/connection
5:12	gcp linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:10	aws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:09	aws windows	TestSecretsPutSecretStringValue
5:03	gcp linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:00	azure-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
4:59	azure linux	TestSecretsPutSecretStringValue
4:54	azure-ucws windows	TestAccept/ssh/connection
4:51	azure-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
4:44	azure windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
4:39	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
4:36	gcp linux	TestSecretsPutSecretStringValue
4:31	azure-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
4:29	azure-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
4:27	azure-ucws linux	TestAccept/ssh/connection
4:21	azure linux	TestAccept/ssh/connection
4:19	gcp windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
4:18	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
4:10	azure-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
4:10	azure-ucws windows	TestSecretsPutSecretStringValue
4:04	azure-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
3:55	aws linux	TestSecretsPutSecretStringValue
3:53	azure windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
3:48	azure-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
3:31	azure windows	TestSecretsPutSecretStringValue
3:15	aws-ucws windows	TestAccept/ssh/connection
3:13	gcp windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
3:11	gcp linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
3:09	aws windows	TestAccept/ssh/connection
3:08	gcp windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
3:07	gcp windows	TestAccept/ssh/connection
3:05	gcp linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
3:04	azure-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct

experimental/dev/cmd/app/import.go

cmd/apps/import.go

experimental/apps-mcp/templates/appkit/generic/client/index.html

experimental/apps-mcp/templates/appkit/generic/databricks.yml.tmpl

experimental/dev/cmd/app/app.go

experimental/dev/cmd/app/deploy.go

fjakobs · 2026-01-14T10:49:50Z

experimental/dev/cmd/app/prompt.go

@@ -0,0 +1,419 @@
+package app


check with @pietern. He wants to unify CLI UX.

unifying through these commands

chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: fixup chore: validate command chore: fixup chore: remove import command chore: fixup

MarioCadenas force-pushed the appkit-cli-commands branch 3 times, most recently from 04f4c88 to 6e23dec Compare January 14, 2026 09:01

MarioCadenas temporarily deployed to test-trigger-is January 14, 2026 09:01 — with GitHub Actions Inactive

fjakobs requested changes Jan 14, 2026

View reviewed changes

MarioCadenas temporarily deployed to test-trigger-is January 14, 2026 13:33 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 14, 2026 13:36 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 14, 2026 17:14 — with GitHub Actions Inactive

MarioCadenas mentioned this pull request Jan 14, 2026

chore: add generic template databricks/appkit#57

Merged

MarioCadenas force-pushed the appkit-cli-commands branch from d552cd0 to f0b22d5 Compare January 14, 2026 17:43

MarioCadenas temporarily deployed to test-trigger-is January 14, 2026 17:44 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 15, 2026 17:59 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 15, 2026 18:04 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 15, 2026 18:44 — with GitHub Actions Inactive

MarioCadenas force-pushed the appkit-cli-commands branch from 9cbff3d to 38cc5a4 Compare January 15, 2026 18:59

MarioCadenas temporarily deployed to test-trigger-is January 15, 2026 18:59 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 15, 2026 19:04 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 08:38 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 08:44 — with GitHub Actions Inactive

MarioCadenas force-pushed the appkit-cli-commands branch from 748d4c1 to bc617fb Compare January 16, 2026 09:00

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 09:01 — with GitHub Actions Inactive

MarioCadenas force-pushed the appkit-cli-commands branch from bc617fb to 26f3f28 Compare January 16, 2026 09:21

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 09:22 — with GitHub Actions Inactive

MarioCadenas force-pushed the appkit-cli-commands branch from 26f3f28 to 037121a Compare January 16, 2026 09:42

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 09:43 — with GitHub Actions Inactive

MarioCadenas force-pushed the appkit-cli-commands branch from 037121a to 9ca1219 Compare January 16, 2026 09:45

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 09:46 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 10:02 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 16, 2026 10:10 — with GitHub Actions Inactive

MarioCadenas had a problem deploying to test-trigger-is January 22, 2026 14:19 — with GitHub Actions Failure

MarioCadenas force-pushed the appkit-cli-commands branch from 1f9b1ec to 47f3169 Compare January 22, 2026 14:20

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 14:21 — with GitHub Actions Inactive

MarioCadenas requested a review from pietern January 22, 2026 14:21

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 14:23 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 14:32 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 14:55 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 15:11 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 15:17 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 15:32 — with GitHub Actions Inactive

MarioCadenas temporarily deployed to test-trigger-is January 22, 2026 17:23 — with GitHub Actions Inactive

MarioCadenas added 16 commits January 23, 2026 00:48

chore: fixup

2f6dea0

chore: fixup

332567b

chore: fixup

152a307

chore: fixup

c729540

chore: fixup

b12bae0

chore: fixup

c93ea50

chore: fixup

291c98f

chore: fixup

4632311

chore: fixup

ddf15d1

chore: fixup

1664eb0

chore: fixup

867d283

chore: fixup

e6236f0

chore: fixup

5961a8d

chore: fixup

77172cf

chore: fixup

565b25a

MarioCadenas force-pushed the appkit-cli-commands branch from 5d7962f to 565b25a Compare January 22, 2026 23:48

MarioCadenas deployed to test-trigger-is January 22, 2026 23:49 — with GitHub Actions Active

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Appkit cli commands #4247

feat: Appkit cli commands #4247

MarioCadenas commented Jan 11, 2026 •

edited

Loading

Uh oh!

eng-dev-ecosystem-bot commented Jan 14, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fjakobs Jan 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

feat: Appkit cli commands #4247

Are you sure you want to change the base?

feat: Appkit cli commands #4247

Conversation

MarioCadenas commented Jan 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Overview

New Command Structure

Key Features

Directory Structure

Why

Tests

Uh oh!

eng-dev-ecosystem-bot commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

fjakobs Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

MarioCadenas commented Jan 11, 2026 •

edited

Loading

eng-dev-ecosystem-bot commented Jan 14, 2026 •

edited

Loading