# Setup

> Interactive first-run setup for the TelemetryDeck analytics CLI — prompts for email/password, mints a bearer, lets the user pick an app.

- **Type:** Skill
- **Install:** `agentstack add skill-agenkin-telemetrydeck-analytics-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agenkin](https://agentstack.voostack.com/s/agenkin)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agenkin](https://github.com/agenkin)
- **Source:** https://github.com/agenkin/telemetrydeck-analytics/tree/main/skills/setup
- **Website:** https://github.com/agenkin/telemetrydeck-analytics

## Install

```sh
agentstack add skill-agenkin-telemetrydeck-analytics-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Setup

`tdq login` requires a real TTY for interactive prompts. Claude Code's Bash tool is not a TTY, so attempt the login and handle the two cases:

## Case 1 — credentials not yet stored (first run)

Running `tdq login` via Bash will fail with:

```
stdin is not a TTY — cannot prompt for email.
Run `tdq login` directly in your terminal.
```

Tell the user: **open a terminal and run `tdq login`**. Walk them through what to expect:

1. TelemetryDeck email prompt
2. Password prompt (hidden)
3. Numbered app picker — type the number next to their app and press Enter
4. A login summary is printed on success

Once they confirm it completed, run `tdq doctor` via Bash to verify the token is live.

## Case 2 — credentials already stored, only app selection needed

If email + password are already in the keychain (e.g. re-setup after switching apps), the non-TTY error will be on the app picker step. The CLI prints the app list before exiting. Read the app names and UUIDs from the error output and ask the user which app to use. Then run:

```bash
tdq login --app-id 
```

`--app-id` skips the picker entirely and works non-interactively.

## Case 3 — `$ARGUMENTS` contains a UUID

Skip the picker immediately:

```bash
tdq login --app-id $ARGUMENTS
```

## After any successful login

Run `tdq doctor` and relay the output so the user sees the end-to-end health check pass.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [agenkin](https://github.com/agenkin)
- **Source:** [agenkin/telemetrydeck-analytics](https://github.com/agenkin/telemetrydeck-analytics)
- **License:** MIT
- **Homepage:** https://github.com/agenkin/telemetrydeck-analytics

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-agenkin-telemetrydeck-analytics-setup
- Seller: https://agentstack.voostack.com/s/agenkin
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
