psoul
A CLI-first foundation for managed Python sessions.
v0.0.x — early development. psoul is public from the first commit but the API, CLI surface, and event schema are unstable. Breaking changes may land in any release until v0.1.0.
Install
uv add psoul
Or try it without installing:
uvx psoul --help
Quick start
psoul script.py # launch a script with history
psoul ps # list sessions
psoul status <id> # inspect a session
psoul doctor # check your Python environment
Development
psoul uses uv for package management.
just provides shorthand dev commands but is
optional — the underlying uv run commands work fine on their own.
just # format, lint, type-check, and test
just format # auto-fix formatting and lint issues
just lint # lint, format check, and type-check
just test # run tests only
just snap # update inline snapshots
CI runs on Ubuntu and macOS across Python 3.12, 3.13, and 3.14.
Native support is Linux and macOS. Windows users should use WSL.
Contributing
See CONTRIBUTING.md.
License
1 maintainer
Metadata
1 maintainer
Release files for psoul 0.0.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| psoul-0.0.5.tar.gz | 159.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| psoul-0.0.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 233.9 kB
Release files / psoul-0.0.5.tar.gz
| Download URL | psoul-0.0.5.tar.gz |
|---|---|
| Size | 159.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f8c45e073d4979de62865628832d743af8e28cad06e2f3d1487dc0395fa8853d
|
|
BLAKE2b-256 checksum How to use checksums |
b6f536b7f5ceb767dbda9ce74722ec5cb64e763a4f2d27cfb27dfa7f8ef3588f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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 May 18, 2026.
Transparency logRelease files / psoul-0.0.5-py3-none-any.whl
| Download URL | psoul-0.0.5-py3-none-any.whl |
|---|---|
| Size | 74.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
afe8a0ff89ff099d639cbb57c207b57b0df865cc724ba5d0cac3bb1012a04227
|
|
BLAKE2b-256 checksum How to use checksums |
fcc20445aa49c9a8c1b01f62c02d278e5c6f2101a41ec01df476bc350e308abd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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 May 18, 2026.
Transparency log
