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: 5d7962f

Run: 21258081965

	Env	❌FAIL	🟨KNOWN	💚RECOVERED	🙈SKIP	✅pass	🙈skip	Time
🟨	aws linux		7	1	6	411	701	23:29
🟨	aws windows		7	1	6	413	699	22:16
❌	aws-ucws linux	4	3	8	5	596	574	108:29
❌	aws-ucws windows	4	3	8	5	598	572	92:35
💚	azure linux			2	8	411	700	21:15
💚	azure windows			2	8	413	698	19:57
❌	azure-ucws linux	5	1	4	7	591	573	89:42
❌	azure-ucws windows	5	1	4	7	593	571	81:42
💚	gcp linux			2	8	400	706	21:00
💚	gcp windows			2	8	402	704	18:03

21 interesting tests: 7 KNOWN, 5 SKIP, 5 FAIL, 4 RECOVERED

	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	🟨K	🟨K	💚R	💚R
🟨	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions	🟨K	🟨K	💚R	💚R	🙈S	🙈S	🙈S	🙈S	🙈S	🙈S
🟨	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=direct	🟨K	🟨K	💚R	💚R
🟨	TestAccept/bundle/resources/permissions/jobs/destroy_without_mgmtperms/without_permissions/DATABRICKS_BUNDLE_ENGINE=terraform	🟨K	🟨K	💚R	💚R
💚	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:42	aws-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
7:04	aws-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
6:46	aws-ucws windows	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
6:44	aws-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
6:12	aws-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
5:54	aws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:48	gcp linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:44	aws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:43	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:43	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:40	aws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:37	aws-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
5:32	gcp windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:30	gcp windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:22	aws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:20	gcp linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:18	azure-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:15	azure linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:15	aws-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:05	azure windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
5:05	azure-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
5:02	azure-ucws windows	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
4:54	azure-ucws linux	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
4:33	azure windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
4:32	azure-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
4:17	azure-ucws linux	TestAccept/bundle/invariant/no_drift/DATABRICKS_BUNDLE_ENGINE=direct/INPUT_CONFIG=database_instance.yml.tmpl
4:14	azure-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
3:53	azure-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=terraform
3:38	azure-ucws windows	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
3:14	gcp windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
3:13	gcp linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
3:09	gcp linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
3:08	azure-ucws linux	TestAccept/bundle/resources/synced_database_tables/basic/DATABRICKS_BUNDLE_ENGINE=direct
3:07	gcp windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
2:46	aws linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:43	aws windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:42	aws linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
2:39	aws-ucws windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:37	azure linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
2:34	aws-ucws windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
2:28	aws-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=terraform
2:23	azure linux	TestAccept
2:22	aws-ucws linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:19	gcp linux	TestAccept
2:18	azure-ucws linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=direct
2:14	azure windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:14	azure-ucws linux	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:13	aws-ucws windows	TestAccept/bundle/resources/clusters/deploy/update-after-create/DATABRICKS_BUNDLE_ENGINE=direct
2:10	azure-ucws windows	TestAccept/bundle/resources/apps/inline_config/DATABRICKS_BUNDLE_ENGINE=terraform
2:10	aws windows	TestAccept/bundle/resources/apps/inline_config/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.

pietern · 2026-01-22T10:22:05Z

go.mod

 	github.com/BurntSushi/toml v1.6.0 // MIT
 	github.com/Masterminds/semver/v3 v3.4.0 // MIT
-	github.com/charmbracelet/bubbles v0.21.0 // MIT
+	github.com/briandowns/spinner v1.23.2


This was removed in f3a45c0.

Can you use either cmdio.NewSpinner() or the bubbles spinner?

This is still around.

pietern · 2026-01-22T10:24:38Z

libs/git/github.go

+// ParseGitHubURL extracts the repository URL, subdirectory, and branch from a GitHub URL.
+// Input: https://github.com/user/repo/tree/main/templates/starter
+// Output: repoURL="https://github.com/user/repo", subdir="templates/starter", branch="main"
+func ParseGitHubURL(url string) (repoURL, subdir, branch string) {


FYI @shreyas-goenka

Not sure if we can/should use this for bundle init calls.

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

unifying through these commands

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

pietern reviewed Jan 22, 2026

View reviewed changes

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

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

MarioCadenas added 9 commits January 22, 2026 15:20

chore: fixup

311b375

chore: fixup

005cd0d

chore: fixup

133b0a5

chore: fixup

df25daa

chore: fixup

3255dd6

chore: fixup

defa9df

chore: fixup

1d11454

chore: fixup

47f3169

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

chore: fixup

7912b70

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

chore: fixup

4a2dbf1

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

chore: fixup

7f5c25e

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

chore: fixup

414ecc8

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

chore: fixup

c5ba8e8

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

chore: fixup

8251dbf

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

chore: fixup

5d7962f

MarioCadenas deployed to test-trigger-is January 22, 2026 17:23 — 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!

pietern Jan 22, 2026

Uh oh!

pietern Jan 22, 2026

Uh oh!

pietern Jan 22, 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!

pietern Jan 22, 2026

Choose a reason for hiding this comment

Uh oh!

pietern Jan 22, 2026

Choose a reason for hiding this comment

Uh oh!

pietern Jan 22, 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