Skip to content

Update context with new config list fields and token owner #46

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
padak wants to merge 2 commits into from
Closed

Update context with new config list fields and token owner #46

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6964c50
Update context with new config list fields and token owner info
padak Mar 24, 2026
484343f
Add Snowflake quoting best practice and plugin install info
padak Mar 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions src/keboola_agent_cli/commands/context.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,9 @@
--project can be repeated to query multiple projects.
--component-type: extractor, writer, transformation, application
--component-id: specific component (e.g. keboola.ex-db-snowflake)
Output includes: last_modified, last_modified_by, last_change_description,
and folder (from KBC.configuration.folderName metadata -- useful for
distinguishing active vs archived transformations).
Examples:
kbagent --json config list
kbagent --json config list --project prod
Expand Down Expand Up @@ -172,6 +175,10 @@
--yes / -y Skip confirmation prompt.
--token-description Description prefix for created tokens (default: kbagent-cli).

Token names include owner identity resolved from the manage token:
"kbagent-cli [john.doe@company.com]" -- so multiple users on the same
project have uniquely identifiable tokens in the Keboola UI.

Examples:
kbagent org setup --org-id 123 --url https://connection.keboola.com --dry-run
kbagent --json org setup --org-id 123 --url https://connection.keboola.com
Expand Down Expand Up @@ -558,6 +565,17 @@
kbagent --json workspace load --project prod --workspace-id WS_ID --tables in.c-bucket.my-table
kbagent --json workspace query --project prod --workspace-id WS_ID --sql "SELECT * FROM \"my-table\" LIMIT 10"

IMPORTANT -- Snowflake quoting rules for workspace queries:
Snowflake converts unquoted identifiers to UPPERCASE. If a database,
schema, or table name contains lowercase letters, dots, or hyphens,
you MUST double-quote it. This applies to ALL identifiers:
WRONG: SELECT * FROM sap_9.my_schema.my_table
(Snowflake reads this as SAP_9.MY_SCHEMA.MY_TABLE -- not found!)
RIGHT: SELECT * FROM "sap_9"."my_schema"."my_table"
Best practice: ALWAYS double-quote database, schema, and table names
in workspace queries, even if they look like they don't need it.
Keboola workspace database/schema names are often lowercase.

16. Setting up projects -- two approaches:

a) Single project (you have a Storage API token):
Expand Down Expand Up @@ -590,6 +608,14 @@
kbagent --json sync pull --project prod
# ... edit, push, then merge via PR + Keboola UI

18. Claude Code plugin -- teach Claude how to use kbagent automatically:
Install the kbagent skill as a Claude Code plugin:
claude install-plugin https://github.com/padak/keboola_agent_cli
After installation, Claude Code will automatically know when and how
to use kbagent commands (the skill triggers on Keboola-related tasks).
The plugin provides a decision table mapping goals to commands and
references for common workflows (workspace debugging, branch lifecycle).

## Exit Codes

0 Success
Expand Down
Loading