datus-statsig-plugin

A Datus plugin that wraps the Statsig Console API (version 20240601) as datus statsig. It focuses on the data-analysis surface of the API: reading metrics and experiment results, authoring warehouse-native metric SQL, and driving ETL ingestion — not feature-flag / project management.

Install

pip install -e datus-statsig-plugin
datus statsig --help

Configure

Add a profile under agent.plugins.statsig in your agent.yml:

agent:
  plugins:
    statsig:
      prod:
        default: true
        api_key: ${STATSIG_CONSOLE_API_KEY}   # secret — env var reference, never a literal
        # optional:
        api_base_url: https://statsigapi.net   # Console API root (plugin appends /console/v1)
        api_version: "20240601"
        timeout: 30

Create a Console API key at console.statsig.com/api_keys. Or run the bundled statsig-setup skill for a guided setup.

Commands

datus statsig [--profile <env>] <group> <subcommand> [args...]

Output is JSON by default (--compact for one line; -o table|plain|yaml). Write commands take their body via --json '<inline>' or --json-file <path> (warehouse-connections update accepts only --json-file, since it carries credentials). Run datus statsig describe <group> <subcommand> — or add --help — to see the body template; --dry-run validates without persisting.

Rate limits: mutations are capped at ~100/10s and ~900/15min per project.

Permissions

When the agent runs these commands through its bash tool, read-only commands (and describe) auto-run; every mutation confirms under both the normal and auto permission profiles (re-running a write costs warehouse compute and consumes the mutation rate limit).

Bundled skills

• statsig — how to use the CLI for metric/experiment analysis and SQL authoring.
• statsig-setup — configure an environment profile.

Development

pip install -e 'datus-statsig-plugin[dev]'
pytest datus-statsig-plugin

The plugin never imports datus — Datus is the config broker and calls the plugin by duck typing.