CLI
Projects
Create, list, and manage projects from the CLI.
Projects group related apps under one product. Metrics and funnels are defined at the project level so they span all apps in the project.
List projects
owlmetry projectsLists all projects accessible to the authenticated team.
View a project
owlmetry projects view <id>Shows project details including its apps.
| Argument | Description |
|---|---|
<id> | Project UUID |
Create a project
owlmetry projects create --name <name> --slug <slug> [--team-id <id>] [--retention-events <days>] [--retention-metrics <days>] [--retention-funnels <days>]| Flag | Required | Description |
|---|---|---|
--name <name> | Yes | Display name for the project |
--slug <slug> | Yes | URL-friendly identifier (must be unique within the team) |
--team-id <id> | No | Team UUID. Defaults to the active team from config. |
--retention-events <days> | No | Days to retain events (default: 120) |
--retention-metrics <days> | No | Days to retain metric events (default: 365) |
--retention-funnels <days> | No | Days to retain funnel events (default: 365) |
Slugs must be lowercase alphanumeric with hyphens (e.g., my-app).
owlmetry projects create --name "My App" --slug my-app --retention-events 90Update a project
owlmetry projects update <id> [--name <name>] [--color <hex>] [--retention-events <days>] [--retention-metrics <days>] [--retention-funnels <days>]| Argument / Flag | Required | Description |
|---|---|---|
<id> | Yes | Project UUID |
--name <name> | No | New project name |
--color <hex> | No | Project color as #RRGGBB hex (e.g. #22c55e). A color is auto-assigned on creation; use this to override. |
--retention-events <days> | No | Days to retain events. Pass null to reset to default. |
--retention-metrics <days> | No | Days to retain metric events. Pass null to reset to default. |
--retention-funnels <days> | No | Days to retain funnel events. Pass null to reset to default. |
At least one flag must be provided.
owlmetry projects update 550e8400-... --name "My Renamed App"
owlmetry projects update 550e8400-... --retention-events 60 --retention-metrics 180
owlmetry projects update 550e8400-... --retention-events null # Reset to defaultDeleting projects
The CLI does not expose a projects delete command. Project deletion is user-only — agent API keys receive a 403 from the delete endpoint. To delete a project, use the web dashboard while signed in as a user.
JSON output
All project commands support --format json for machine-readable output:
owlmetry projects --format json
owlmetry projects view <id> --format json