tpk_cli 0.3.0
tpk_cli: ^0.3.0 copied to clipboard
TesterPayKit command-line client. Designed for agentic use — every command supports --json output and --token for non-interactive flows.
Changelog #
All notable changes to the TesterPayKit CLI (tpk_cli) are documented here.
The format is based on Keep a Changelog, and this package adheres to Semantic Versioning.
0.3.0 - 2026-10-21 #
Added #
tpk --version(andtpk version/tpk --json version) — print the installed CLI version.tpk update(aliasupgrade) — self-update from pub.dev viadart pub global activate tpk_cli.
Both were listed under 0.2.0 before, but landed one day after that release was published — the 0.2.0 on pub.dev does not contain them.
Removed #
tpk registerandtpk login --email … --password …. Both called endpoints the API dropped with the move to passwordless magic-link sign-in, so they only ever returned 404.tpk loginis the device-auth flow (approve in the web console); agents and CI pass a token with the global--tokenflag.
Changed #
- Dependencies:
args^2.7.0,http^1.6.0,lints^6.1.0,test^1.33.0. - README: install from pub.dev (
dart pub global activate tpk_cli), note that an invite-only TesterPayKit account is required, documenttpk_mcp. Newexample/example.md. - Doc comments no longer contain raw
<…>(dartdoc read them as HTML); the package now has its ownanalysis_options.yamlonpackage:lints/recommended.yaml, the baseline pub.dev scores against. pubspec.yamlno longer pointsrepositoryat a GitHub repo that doesn't contain the source.
0.2.0 - 2026-07-07 #
Added #
- Terminal dogfood loop — become a tester and file bugs from the CLI:
tpk tester login --project <id|bundle> [--code NAME]mints an anonymous per-project tester (idempotent on{project, code}; default codeCLI-<HOSTNAME>) and stores it in a parallel tester slot in~/.tpk, alongside any coordinator login.tpk bug report --title … --severity …files a bug as that tester, auto-starting a session. Options:--description,--type,--category,--screen,--step(repeatable),--session.tpk tester logoutclears just the tester session;tpk logoutnow leaves the tester session intact (parallel identities).
- Admin-provisioned named testers —
tpk tester create --email … [--name …] [--status …](admin login required) creates a managed tester up-front so a known person can sign in via magic-link without the self-signup → pending → approve flow.
0.1.0 - 2026-06-03 #
Added #
tpkexecutable — agentic command-line client for the TesterPayKit service. Every command supports--jsonoutput and--tokenfor non-interactive / CI / agent flows (envs, sessions, bugs, bug context with navigation flow).tpk_mcpexecutable — read-only MCP (Model Context Protocol) server over stdio JSON-RPC, exposing the same coordinator data (envs, sessions, timelines, bugs, bug context) to MCP-capable agents.- Talks to the API over HTTP only; no Flutter or TesterPayKit SDK dependency.