@owlmetry/cli 0.1.9 → 0.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -7198,7 +7198,7 @@ var switchCommand = new Command("switch").description("Switch active team profil
7198
7198
  });
7199
7199
 
7200
7200
  // src/index.ts
7201
- var program2 = new Command().name("owlmetry").version("0.1.9").description("OwlMetry CLI \u2014 query metrics and manage your apps from the terminal").addOption(
7201
+ var program2 = new Command().name("owlmetry").version("0.1.11").description("OwlMetry CLI \u2014 query metrics and manage your apps from the terminal").addOption(
7202
7202
  new Option("--format <format>", "Output format").choices(["table", "json", "log"]).default("table")
7203
7203
  ).option("--endpoint <url>", "OwlMetry API server URL").option("--api-key <key>", "API key").option("--ingest-endpoint <url>", "OwlMetry ingest endpoint URL (for SDKs; defaults to API endpoint for self-hosted)").option("--team <name-or-id>", "Use a specific team profile for this command");
7204
7204
  program2.addCommand(authCommand);
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: owlmetry-cli
3
- version: 0.1.9
3
+ version: 0.1.11
4
4
  description: >-
5
5
  Install the OwlMetry CLI, sign up, and manage projects, apps, metrics,
6
6
  funnels, and events. Use when adding OwlMetry to a project, querying
@@ -116,6 +116,67 @@ OwlMetry organises resources in a `Team → Project → Apps` hierarchy:
116
116
 
117
117
  Projects group apps cross-platform: an iOS app and its backend API can share the same project, enabling unified funnel and metric analysis across both.
118
118
 
119
+ ## Discovering IDs
120
+
121
+ Always use CLI commands to get IDs — never read `~/.owlmetry/config.json` directly.
122
+
123
+ - **Team ID**: `owlmetry whoami --format json` → `.teams[].id`
124
+ - **Project ID**: `owlmetry projects --format json` → `[].id`
125
+ - **App ID**: `owlmetry apps list --format json` → `[].id` (also returns `client_key`)
126
+
127
+ ## Command Quick Reference
128
+
129
+ Copy-paste ready. All commands support `--format json` for machine-readable output. Global flags: `--endpoint <url>`, `--api-key <key>`, `--team <name-or-id>`.
130
+
131
+ ```
132
+ # Auth
133
+ owlmetry auth send-code --email <email>
134
+ owlmetry auth verify --email <email> --code <code> --format json
135
+ owlmetry whoami --format json
136
+ owlmetry switch [<name-or-slug>]
137
+ owlmetry setup --endpoint <url> --api-key <key> [--ingest-endpoint <url>]
138
+
139
+ # Projects
140
+ owlmetry projects --format json
141
+ owlmetry projects view <id> --format json
142
+ owlmetry projects create --name <name> --slug <slug> [--team-id <id>] --format json
143
+ owlmetry projects update <id> --name <name> --format json
144
+
145
+ # Apps
146
+ owlmetry apps list [--project-id <id>] --format json
147
+ owlmetry apps view <id> --format json
148
+ owlmetry apps create --project-id <id> --name <name> --platform <platform> [--bundle-id <id>] --format json
149
+ owlmetry apps update <id> --name <name> --format json
150
+
151
+ # Metrics
152
+ owlmetry metrics list --project-id <id> --format json
153
+ owlmetry metrics view <slug> --project-id <id> --format json
154
+ owlmetry metrics create --project-id <id> --name <name> --slug <slug> [--lifecycle] [--description <desc>] --format json
155
+ owlmetry metrics update <slug> --project-id <id> [--name <name>] [--status active|paused] --format json
156
+ owlmetry metrics delete <slug> --project-id <id>
157
+ owlmetry metrics events <slug> --project-id <id> [--phase <phase>] [--user-id <id>] [--since <time>] [--until <time>] --format json
158
+ owlmetry metrics query <slug> --project-id <id> [--since <date>] [--until <date>] [--app-id <id>] [--user-id <id>] [--group-by <field>] --format json
159
+
160
+ # Funnels
161
+ owlmetry funnels list --project-id <id> --format json
162
+ owlmetry funnels view <slug> --project-id <id> --format json
163
+ owlmetry funnels create --project-id <id> --name <name> --slug <slug> --steps-file <path> [--description <desc>] --format json
164
+ owlmetry funnels update <slug> --project-id <id> --steps-file <path> --format json
165
+ owlmetry funnels delete <slug> --project-id <id>
166
+ owlmetry funnels query <slug> --project-id <id> [--since <date>] [--until <date>] [--open] [--group-by <field>] --format json
167
+
168
+ # Events
169
+ owlmetry events [--project-id <id>] [--app-id <id>] [--level <level>] [--user-id <id>] [--session-id <id>] [--since <time>] [--limit <n>] --format json
170
+ owlmetry events view <id> --format json
171
+ owlmetry investigate <eventId> [--window <minutes>] --format json
172
+
173
+ # Users
174
+ owlmetry users <app-id> [--anonymous] [--real] [--search <query>] [--limit <n>] --format json
175
+
176
+ # Audit Logs
177
+ owlmetry audit-log list --team-id <id> [--resource-type <type>] [--actor-id <id>] [--action <action>] [--since <time>] --format json
178
+ ```
179
+
119
180
  ## Resource Management
120
181
 
121
182
  ### Projects
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: owlmetry-node
3
- version: 0.1.9
3
+ version: 0.1.11
4
4
  description: >-
5
5
  Integrate the OwlMetry Node.js SDK into a backend service for server-side
6
6
  analytics, event tracking, metrics, funnels, and A/B experiments. Use when
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: owlmetry-swift
3
- version: 0.1.9
3
+ version: 0.1.11
4
4
  description: >-
5
5
  Integrate the OwlMetry Swift SDK into an iOS or macOS app for analytics,
6
6
  event tracking, metrics, funnels, and A/B experiments. Use when
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@owlmetry/cli",
3
- "version": "0.1.9",
3
+ "version": "0.1.11",
4
4
  "description": "OwlMetry CLI — manage projects, apps, metrics, funnels, and events from the terminal. Includes AI skill files for agent-assisted development.",
5
5
  "type": "module",
6
6
  "license": "MIT",