Skip to main content

authswap

authswap is a Rust command-line tool for switching local Codex auth profiles and optionally syncing those profiles through WebDAV.

Features

  • Interactive account picker for local Codex profiles.
  • Account add, switch, refresh, and delete actions inside the interactive UI.
  • WebDAV sync from the interactive UI.
  • Sanitized config.toml sync that excludes machine-local project sections.
  • PyPI wheel packaging for users who do not have Rust installed.

Commands

authswap

authswap reads and writes the standard Codex auth layout:

~/.codex/auth.json
~/.codex/config.toml
~/.codex/accounts/*.auth.json
~/.codex/accounts/registry.json

Install From PyPI

pip install authswap
authswap

Published wheels include the compiled authswap binary, so end users do not need Rust, Node.js, or npm when a compatible wheel is available.

WebDAV Sync

authswap supports custom WebDAV services. Press w in the account picker to configure the server URL and credentials, test the connection, and push or pull account data. When no local accounts exist, the first-run dialog also offers WebDAV so accounts can be restored without signing in first.

The settings file is stored at ~/.codex/authswap.json with private file permissions.

These files contain active credentials. Sync only to a trusted WebDAV server.

Usage Limits

The interactive account picker shows cached 5-hour and weekly limit usage from ~/.codex/accounts/registry.json. Press r on the selected account to request fresh usage from Codex. Press t to refresh all accounts, with 100ms between requests. Both actions update the local cache.

Limit columns show the remaining percentage and the remaining time until reset, for example 28% 1h 20m.

Press s in the account picker to configure whether authswap restarts codex app-server after switching accounts. The setting is off by default and is saved in ~/.codex/authswap.json.

Metadata

Release files for authswap 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for authswap 1.0.3
File Size Uploaded Provenance
authswap-1.0.3.tar.gz 51.7 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for authswap 1.0.3
File
authswap-1.0.3-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details
authswap-1.0.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
authswap-1.0.3-py3-none-win32.whl Python 3 none Windows x86-32 Details
authswap-1.0.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
authswap-1.0.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl Python 3 none Linux glibc 2.17+ x86-32 Details
authswap-1.0.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl Python 3 none Linux glibc 2.17+ ARMv7l Details
authswap-1.0.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
authswap-1.0.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details

Total release size: 17.4 MB

Release files / authswap-1.0.3.tar.gz

Download URL authswap-1.0.3.tar.gz
Size 51.7 kB
Tags Source
SHA-256 checksum
How to use checksums
cdb16e96be30bc6503fe3902d4e69e2913d8af1604b7e238980f13a3d8e892a5
BLAKE2b-256 checksum
How to use checksums
ce86a4b2c08a8168e6c88b075ad0c33a0a61de73408cf7e2aeddc4a988fc2256
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-win_arm64.whl

Download URL authswap-1.0.3-py3-none-win_arm64.whl
Size 2.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
477580efefcf6c20516c5250cc2b9c57ea22afa015c6f459a45e4278924936be
BLAKE2b-256 checksum
How to use checksums
88ea30b9ec108864e3bf816ad805e0db2b71a49a8fc06a207960079680c8eaec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-win_amd64.whl

Download URL authswap-1.0.3-py3-none-win_amd64.whl
Size 2.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
b7f13cb51897868127d0d2eb6547f902c4f01e15caa56fca17362ccbc0e9dad8
BLAKE2b-256 checksum
How to use checksums
1a86ac2395a1bee2cafa1f17f092ccbbd281e634707a85bb34f70bf8ae1c71cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-win32.whl

Download URL authswap-1.0.3-py3-none-win32.whl
Size 1.9 MB
Tags Python 3 Windows x86-32
SHA-256 checksum
How to use checksums
10a8cc5585a7420b767f9e76e376df27ce1a43e2e3d6dd720f626b1245fa43cb
BLAKE2b-256 checksum
How to use checksums
891a2de0b8ec7daa5b0d288c4b9b0c84265b3c87e50f9de006e1e490e1727fc1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL authswap-1.0.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 2.3 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
95d4bdbcb8ad435a8ed8fe93e7ced6f2d8d012a070bd5878ece0b64ee769189c
BLAKE2b-256 checksum
How to use checksums
9b55760dde0c1391db67e6b146b6bce579055a56007bddfdd02bf9a9e0f008de
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl

Download URL authswap-1.0.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl
Size 2.4 MB
Tags Linux glibc 2.17+ x86-32 Python 3
SHA-256 checksum
How to use checksums
d122a5a8da98bd11cf336ff6cd184a4f3ce59abca0051655191a4eb5faf8fd1a
BLAKE2b-256 checksum
How to use checksums
7439121e798e3c401a2e725951a1b5cf87e80ee87a8cf97b4bff5861f10ac6d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

Download URL authswap-1.0.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Size 2.0 MB
Tags Linux glibc 2.17+ ARMv7l Python 3
SHA-256 checksum
How to use checksums
7cb1e77880ede2873c5c766e70142d11764f07cefe90f23265237c1f24726d56
BLAKE2b-256 checksum
How to use checksums
9b7781dcf801408297d6f98dd5787ba3e022a0a9c6329a43b85986572a0abc30
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL authswap-1.0.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 2.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
6b5ba2bf28a6cbda645cc682d88cc264e41b9db9276f8d8bed1c750b6dcd7f43
BLAKE2b-256 checksum
How to use checksums
35f8c8489ab46c716c84deb603497f17d6b09f484ce2f5beacfba17f65aa1fea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Release files / authswap-1.0.3-py3-none-macosx_11_0_arm64.whl

Download URL authswap-1.0.3-py3-none-macosx_11_0_arm64.whl
Size 2.2 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
4b3d0866238b16482ed9b3e1a7febdec67378e2a7e1ac468000ef51701b53618
BLAKE2b-256 checksum
How to use checksums
0897516e8433754a159f72cbc07e5668cc4356fdebd20459811220bc7d874728
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

Security for authswap 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 9 files in this release have been uploaded with provenance metadata.

Select from 9 files

Attestation for authswap-1.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page