ae-metadata
CLI domain metadata routes to the analysis capability gateway (/api/cli/analysis/v1/...), using auth header cli-token.
Parallel to ae-analysis. Use this skill for gateway-backed metadata detail and data-table/dimension-table operations; use ae-analysis for metadata list/search, metrics, virtual create, and batch edit.
Global AE CLI Rules
| Parameter |
Description |
--format <json|table> |
Output format. Default JSON. |
--jq <expr> |
jq filter on JSON output. |
--host <url> |
Override active AE host, e.g. ae-cli metadata data-table list --host <url> .... |
--validate |
Optional: fix params only (/validate). Alone while iterating complex qp / payload — then run. Do not stack with --dry-run. |
--dry-run |
Optional: confirm ready to run (/dry-run). Alone for risk/output preview. Do not stack with --validate. |
Output and errors:
- Success: JSON envelope (default). May include optional
_notice.host_compat.
- Failure:
{ "ok": false, "error": { "type", "message", "hint" } }, non-zero exit.
- CRITICAL — Host compat (do this first): After each
ae-cli run, check stderr and _notice.host_compat. If either is present, open the user reply with a short ⚠️ version warning and quote the npm i -g / npx skills add (or update-cluster) lines verbatim, then present the business result. Soft tip; ok: true can still carry the notice.
Safety:
- Read-only commands can run directly after IDs/names are verified.
- Ordinary writes (
data-table *-write, property-bindings-update, dimension-table bind/create) execute without --yes. Delete commands are high-risk-write: dry-run first, summarize impact, wait for explicit confirmation, then execute with --yes.
- Before any command, read the matching
references/<name>.md (filename = command with spaces → underscores, e.g. metadata data-table list → metadata_data_table_list.md).
- Never invent
project_id, event/property names, input_file_id, or data_table_id. Discover names via ae-analysis and data table IDs via metadata data-table list.
metadata data-table download is an async artifact command: plain invocation submits, --wait waits, and --output <file> waits then streams atomically. Resume with analysis run wait; local interruption never cancels the remote run.
When to Use
Switch to ae-metadata when the user needs:
- Metadata data-table list/get/create/update/delete/download
- For local uploads, switch to
ae-analysis and use analysis input-file upload with a discovered purpose.
- Bind an existing data table to a property, or create a CSV dimension table and bind it
Stay on ae-analysis for: metadata event/property detail, metadata event/property/metric list/search, metric CRUD, batch metadata, virtual create, project config, tracking plans.
Command Format
ae-cli metadata <resource> <action> [options]
ae-cli metadata property <dimension-table-action> [options]
- Commands and flags use kebab-case:
data-table, dimension-table, --project-id, --data-table-id.
- Gateway
input body fields remain snake_case (project_id, event_name, …); ae-cli maps flags automatically.
PROJECT_ID_GATE
Same rules as ae-analysis: reuse verified project context in one conversation; otherwise ae-cli project info list (or ae-analysis skill) to resolve project_id.
Commands (10)
| User command |
Capability id |
Reference |
metadata data-table list |
metadata.data_table.list |
metadata_data_table_list.md |
metadata data-table get |
metadata.data_table.get |
metadata_data_table_get.md |
metadata data-table csv-write |
metadata.data_table.csv_write |
metadata_data_table_csv_write.md |
metadata data-table sql-write |
metadata.data_table.sql_write |
metadata_data_table_sql_write.md |
metadata data-table csv-delete |
metadata.data_table.csv_delete |
metadata_data_table_csv_delete.md |
metadata data-table sql-delete |
metadata.data_table.sql_delete |
metadata_data_table_sql_delete.md |
metadata data-table download |
metadata.data_table.download |
metadata_data_table_download.md |
metadata data-table property-bindings-update |
metadata.data_table.property_bindings_update |
metadata_data_table_property_bindings_update.md |
metadata property bind-existing-dimension-table |
metadata.property.bind_existing_dimension_table |
metadata_property_dimension_table_bind_existing.md |
metadata property create-and-bind-csv-dimension-table |
metadata.property.create_and_bind_csv_dimension_table |
metadata_property_dimension_table_create_and_bind_csv.md |
Quick Verification
ae-cli metadata --help
ae-cli metadata data-table list --help
ae-cli metadata data-table list --project-id 1 --dry-run
ae-cli analysis input-file purpose list --project-id 1
Related Skills
ae-analysis: analysis-meta event get / analysis-meta property get for detail, and analysis-meta event list / analysis-meta property list to discover names.
1---2name: ae-metadata3description: AE/TE metadata capability-gateway CLI: metadata data-table management and property dimension-table binding. Metadata CLI routes through the analysis gateway. Input-file upload and event/property detail belong to ae-analysis.4---56# ae-metadata78CLI domain **`metadata`** routes to the analysis capability gateway (`/api/cli/analysis/v1/...`), using auth header **`cli-token`**.910Parallel to **`ae-analysis`**. Use **this skill** for gateway-backed metadata detail and data-table/dimension-table operations; use **`ae-analysis`** for metadata list/search, metrics, virtual create, and batch edit.1112## Global AE CLI Rules1314| Parameter | Description |15|---|---|16| `--format <json\|table>` | Output format. Default JSON. |17| `--jq <expr>` | jq filter on JSON output. |18| `--host <url>` | Override active AE host, e.g. `ae-cli metadata data-table list --host <url> ...`. |19| `--validate` | Optional: fix params only (`/validate`). Alone while iterating complex `qp` / payload — then run. Do not stack with `--dry-run`. |20| `--dry-run` | Optional: confirm ready to run (`/dry-run`). Alone for risk/output preview. Do not stack with `--validate`. |2122Output and errors:23- Success: JSON envelope (default). May include optional `_notice.host_compat`.24- Failure: `{ "ok": false, "error": { "type", "message", "hint" } }`, non-zero exit.25- **CRITICAL — Host compat (do this first):** After each `ae-cli` run, check stderr and `_notice.host_compat`. If either is present, open the user reply with a short ⚠️ version warning and **quote the `npm i -g` / `npx skills add` (or update-cluster) lines verbatim**, then present the business result. Soft tip; `ok: true` can still carry the notice.2627Safety:28- Read-only commands can run directly after IDs/names are verified.29- Ordinary writes (`data-table *-write`, `property-bindings-update`, dimension-table bind/create) execute without `--yes`. Delete commands are `high-risk-write`: dry-run first, summarize impact, wait for explicit confirmation, then execute with `--yes`.30- **Before any command**, read the matching `references/<name>.md` (filename = command with spaces → underscores, e.g. `metadata data-table list` → `metadata_data_table_list.md`).31- Never invent `project_id`, event/property names, `input_file_id`, or `data_table_id`. Discover names via `ae-analysis` and data table IDs via `metadata data-table list`.32- `metadata data-table download` is an async artifact command: plain invocation submits, `--wait` waits, and `--output <file>` waits then streams atomically. Resume with `analysis run wait`; local interruption never cancels the remote run.3334## When to Use3536Switch to **`ae-metadata`** when the user needs:3738- Metadata data-table list/get/create/update/delete/download39- For local uploads, switch to `ae-analysis` and use `analysis input-file upload` with a discovered purpose.40- Bind an existing data table to a property, or create a CSV dimension table and bind it4142Stay on **`ae-analysis`** for: metadata event/property detail, metadata event/property/metric list/search, metric CRUD, batch metadata, virtual create, project config, tracking plans.4344## Command Format4546```bash47ae-cli metadata <resource> <action> [options]48ae-cli metadata property <dimension-table-action> [options]49```5051- Commands and flags use **kebab-case**: `data-table`, `dimension-table`, `--project-id`, `--data-table-id`.52- Gateway `input` body fields remain **snake_case** (`project_id`, `event_name`, …); ae-cli maps flags automatically.5354## PROJECT_ID_GATE5556Same rules as `ae-analysis`: reuse verified project context in one conversation; otherwise `ae-cli project info list` (or `ae-analysis` skill) to resolve `project_id`.5758## Commands (10)5960| User command | Capability id | Reference |61|---|---|---|62| `metadata data-table list` | `metadata.data_table.list` | [metadata_data_table_list.md](references/metadata_data_table_list.md) |63| `metadata data-table get` | `metadata.data_table.get` | [metadata_data_table_get.md](references/metadata_data_table_get.md) |64| `metadata data-table csv-write` | `metadata.data_table.csv_write` | [metadata_data_table_csv_write.md](references/metadata_data_table_csv_write.md) |65| `metadata data-table sql-write` | `metadata.data_table.sql_write` | [metadata_data_table_sql_write.md](references/metadata_data_table_sql_write.md) |66| `metadata data-table csv-delete` | `metadata.data_table.csv_delete` | [metadata_data_table_csv_delete.md](references/metadata_data_table_csv_delete.md) |67| `metadata data-table sql-delete` | `metadata.data_table.sql_delete` | [metadata_data_table_sql_delete.md](references/metadata_data_table_sql_delete.md) |68| `metadata data-table download` | `metadata.data_table.download` | [metadata_data_table_download.md](references/metadata_data_table_download.md) |69| `metadata data-table property-bindings-update` | `metadata.data_table.property_bindings_update` | [metadata_data_table_property_bindings_update.md](references/metadata_data_table_property_bindings_update.md) |70| `metadata property bind-existing-dimension-table` | `metadata.property.bind_existing_dimension_table` | [metadata_property_dimension_table_bind_existing.md](references/metadata_property_dimension_table_bind_existing.md) |71| `metadata property create-and-bind-csv-dimension-table` | `metadata.property.create_and_bind_csv_dimension_table` | [metadata_property_dimension_table_create_and_bind_csv.md](references/metadata_property_dimension_table_create_and_bind_csv.md) |7273## Quick Verification7475```bash76ae-cli metadata --help77ae-cli metadata data-table list --help78ae-cli metadata data-table list --project-id 1 --dry-run79ae-cli analysis input-file purpose list --project-id 180```8182## Related Skills8384- **`ae-analysis`**: `analysis-meta event get` / `analysis-meta property get` for detail, and `analysis-meta event list` / `analysis-meta property list` to discover names.
thinkingaiagenticengine