te-cli
Expert guidance for the cross-platform Tabular Editor CLI (the `te` binary, currently in preview) that manages Power BI / Analysis Services semantic models from the terminal on macOS, Linux, and Windows. Use when the user mentions the `te` CLI or "Tabular Editor CLI" (not the "2"), or runs a `te <command>` to scaffold, inspect, edit, validate, run BPA on, query, deploy, refresh, test, or migrate a semantic model. Not for the legacy Windows-only `TabularEditor.exe` (TE2).
npx skills add data-goblin/power-bi-agentic-development --skill te-cli --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
The skill provides expert guidance for using the cross-platform Tabular Editor CLI (the te binary) to manage Power BI / Analysis Services semantic models from the terminal. It covers when to use the CLI, how to start and authenticate, and how to perform common operations such as scaffolding, inspecting, editing, validating, running BPA, querying, deploying, refreshing, testing, and migrating models. It emphasizes using --output-format json for programmatic interactions and warns that this is not the TE2 Windows executable. It outlines the conditions under which to apply the tool (e.g., when users mention the te CLI or run te <command>), and it enumerates many concrete workflows and commands to perform with the CLI.
How it works
The guidance instructs users to:
- Run initial checks with
te --versionandte auth status, and prompt login if not authenticated. - Execute
te --helpandte <command> --helpto learn current flags. - Treat shell sessions as per-shell-state for
te connect; pass-mand-s/-don every command or setTE_SESSION. - Use
tefor model-related mutations (e.g.,te set,te add,te remove,te replace,te format,te script,te macro run) with in-memory staging unless--saveis used to persist. - Manage BPA and validation with
te bpa runandte validate, and handle DAX formatting withte format --save. - Rely on
tecommands that require deployed models (e.g.,te query,te vertipaq) to specify-s/-dor an active connection; otherwise an error occurs. - Always pass
--output-format jsonwhen driving programmatically to avoid parsing issues. - Follow the recommended quickstart and common operations to summarize, search, query, modify, and bulk-edit models.
When to use it
Use this skill when the user mentions the te CLI, the new Tabular Editor CLI, or runs a te <command> in a terminal, and when the user aims to scaffold, inspect, edit, validate, deploy, refresh, query, test, or migrate a semantic model from the terminal on macOS, Linux, or Windows. It also covers scenarios like converting TMDL/BIM/PBIP, setting up DAX regression tests, and CI/CD pipelines for validation and deployment of semantic models. It distinguishes TE3/te from the legacy TE2 Windows executable.
What it can touch
The skill notes effective use with te across local models and deployed models via -m/-s/-d flags. It does not list other tools beyond the te commands and the guidance around output formats; specific allowed-touch surfaces are implied to be the model files and the deployed endpoints accessed via te.
Caveats
- Explicitly mentions: Not the TE2 Windows-only executable. If TE2 syntax is used, route via compat layer or invoke
TabularEditor.exedirectly. - Preview limitations: Preview builds stop functioning after 2026-09-30. No license required during preview.
- Mutations are staged in memory by default and require
--saveto persist, unless interactive mode is configured. - BPA gating and default prompts can affect CI workflows; use
--forcewhere appropriate and mute interactive prompts in CI. - Secrets should not be placed on the command line; use secure methods for authentication.
# Tabular Editor CLI (`te`) To get the `te` CLI yourself (as the agent), see [references/get-te-cli.md](references/get-te-cli.md). The `te` CLI is a single self-contained binary that loads, edits, validates, deploys, refreshes, and tests semantic models against TMDL/BIM files, Power BI Desktop, and cloud workspaces (Power BI, Fabric, Azure AS, SSAS). It is built on the same TOMWrapper that powers Tabular Editor 3, so model edits behave like the desktop app. **Always pass `--output-format json`** when driving `te` programmatically. The default text/table output uses tables and ANSI styling that mangle in agent transcripts; JSON is parseable and avoids rendering issues. **Limited public preview.** Preview builds stop functioning after 2026-09-30. No license is required during preview. Issues and feedback: https://github.com/TabularEditor/CLI **Not the TE2 CLI.** This is a different product from the legacy Windows-only `TabularEditor.exe` (TE2). If the user invokes TE2 flag syntax (`-D`, `-S`, `-A`, `-B`, `-TMDL`, `-O`, `-C`, `-V`, `-G`), route it through the compat layer or invoke `TabularEditor.exe` directly. See `references/te2-migration.md`. ## When to use this skill - The user me
- When to use this skill
- When NOT to use this skill
- Critical general rules
- Verb naming (canonical long-form + Unix aliases)
- Staging model (--save / --stage / --revert)
- Quickstart
- Common operations
- Global options
- Semantic modeling checklist
- Command index
- The authoring loop
- Using te with other Power BI CLIs
- Bundled scripts
- References
te --version && te auth status # 0. check install + auth te auth login # 1. authenticate (browser); cached te init ./my-model # 2. scaffold (PowerBI mode, TMDL, compat 1702) te load ./model # 3. load + summary; then `te list`, `te list Sales` te find "Revenue" --in names -m ./model # 4. search (names | expressions | descriptions | all) te get Sales/Revenue -q expression -m ./model # 5. read a measure's DAX te bpa run --fail-on error --ci github -m ./model # 6. BPA gate te format --save -m ./model # 7. format all DAX te query "EVALUATE TOPN(5, 'Sales')" -s ws -d model # 8. query (positional or -q) te save -o ./out --serialization tmdl -m ./model # 9. save / convert (tmdl|bim|pbip|database.json)
What does the te-cli skill do?
Expert guidance for the cross-platform Tabular Editor CLI (the `te` binary, currently in preview) that manages Power BI / Analysis Services semantic models from the terminal on macOS, Linux, and Windows. Use when the user mentions the `te` CLI or "Tabular Editor CLI" (not the "2"), or runs a `te <command>` to scaffold, inspect, edit, validate, run BPA on, query, deploy, refresh, test, or migrate a semantic model. Not for the legacy Windows-only `TabularEditor.exe` (TE2).
How do I install it?
Run `npx skills add data-goblin/power-bi-agentic-development --skill te-cli --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From data-goblin/power-bi-agentic-development, a repository with 833 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
