pxtx

Command-line client for pxtx, the pretalx issue tracker. Talks to the REST API over HTTP; pairs equally well with a human at the keyboard and a claude-code instance.

Install

pip install pxtx

Configure

Create ~/.config/pxtx/config.toml:

url = "https://tracker.pretalx.com"
token = "pxtx_..."
# Repo assumed when a GitHub reference is specified without a repo (e.g. GH-42).
default_repo = "pretalx/pretalx"

Any of these can also be supplied via environment variables: PXTX_URL, PXTX_TOKEN, PXTX_DEFAULT_REPO, PXTX_CONFIG (path override).

Commands

pxtx issue new --title "..." [--priority sollte] [--effort 2-6h] [--milestone 25.1]
pxtx issue list [--status open,wip] [--mine] [--priority will,sollte]
pxtx issue show PX-47 [--comments]
pxtx issue close PX-47 [--wontfix]
pxtx issue comment PX-47 "message"    # or --stdin
pxtx take PX-47                       # assignee=you, status=wip
pxtx pr PX-47 <ref>                   # link a GitHub PR (idempotent)
pxtx milestone list
pxtx activity log [PX-47] [--since 1h]

Append --json (as a top-level flag, e.g. pxtx --json issue show PX-47) to get the raw API response instead of a human-readable summary.

Actor

The server records an actor alongside every API action (activity log, comment authorship). When run inside a claude-code session (CLAUDECODE=1), the CLI auto-derives claude-<git-branch> and sends it as X-Pxtx-Actor on every request, so a single shared API token can still attribute work to the right agent. Outside claude-code the header is omitted and the server falls back to the token name. Override explicitly with --actor NAME before the subcommand:

pxtx --actor rixx issue list --mine

--mine and pxtx take both use this resolved actor.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pxtx-0.8.0.tar.gz (24.0 kB view details)

Uploaded Jul 29, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pxtx-0.8.0-py3-none-any.whl (13.3 kB view details)

Uploaded Jul 29, 2026 Python 3

File details

Details for the file pxtx-0.8.0.tar.gz.

File metadata

Download URL: pxtx-0.8.0.tar.gz
Upload date: Jul 29, 2026
Size: 24.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pxtx-0.8.0.tar.gz
Algorithm	Hash digest
SHA256	`22b93971ef4cd14742c312f51bfbdcf0376bcac7b0f2c5a3901ad9e808693e84`
MD5	`e22fcaa2a6820ecb402b969684665839`
BLAKE2b-256	`adcfe2fdfa4a6f33d73f48ccca1848ea07f3a5cb61e4de9da2f2566808d75a01`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pxtx-0.8.0.tar.gz:

Publisher: cli-release.yml on pretalx/pxtx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pxtx-0.8.0.tar.gz
- Subject digest: 22b93971ef4cd14742c312f51bfbdcf0376bcac7b0f2c5a3901ad9e808693e84
- Sigstore transparency entry: 2279860151
- Sigstore integration time: Jul 29, 2026
Source repository:
- Permalink: pretalx/pxtx@262a1e0ec3955c2fc97424d3bf74a75593909326
- Branch / Tag: refs/tags/v0.8.0
- Owner: https://github.com/pretalx
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: cli-release.yml@262a1e0ec3955c2fc97424d3bf74a75593909326
- Trigger Event: push