A CLI and TUI Python session supervisor with batteries included.
Project description
psoul
A CLI and TUI Python session supervisor with batteries included.
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 version # print installed version
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.
uv sync --group dev --group test
just # run lint fixes + tests
just test # run tests only
just lint # check lint + formatting (CI-style)
just fix # auto-fix lint + format
just snap # update inline snapshots
just check # lint + test without modifying files
CI runs on Ubuntu, macOS, and Windows across Python 3.12, 3.13, and 3.14.
Contributing
See CONTRIBUTING.md.
License
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file psoul-0.0.1.tar.gz.
File metadata
- Download URL: psoul-0.0.1.tar.gz
- Upload date:
- Size: 21.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bcfd46b5c578e55220a21347934b5f293bbfc0b4fe2bf318a57a23108cff77ec
|
|
| MD5 |
301db9c85032151d3e0d6d017f0f01d7
|
|
| BLAKE2b-256 |
db346082a62d941cca406ca3b8e1c84fb15841fd1fd700c6348d5f15d58634f4
|
Provenance
The following attestation bundles were made for psoul-0.0.1.tar.gz:
Publisher:
publish.yml on oxenfree999/psoul
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
psoul-0.0.1.tar.gz -
Subject digest:
bcfd46b5c578e55220a21347934b5f293bbfc0b4fe2bf318a57a23108cff77ec - Sigstore transparency entry: 1187666263
- Sigstore integration time:
-
Permalink:
oxenfree999/psoul@764753a525862467762ce0a6300605e5f2a62b02 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/oxenfree999
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@764753a525862467762ce0a6300605e5f2a62b02 -
Trigger Event:
push
-
Statement type:
File details
Details for the file psoul-0.0.1-py3-none-any.whl.
File metadata
- Download URL: psoul-0.0.1-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
df690a16b103635c2ab591c008408f156d4708a7fb1d795dd2d2d522da555251
|
|
| MD5 |
050c10fd276b48fa0d34efc075750f75
|
|
| BLAKE2b-256 |
cf02f25cf59c974b4b28bd64ea53ba23aab6b6041480264535bed83eaaab5dd7
|
Provenance
The following attestation bundles were made for psoul-0.0.1-py3-none-any.whl:
Publisher:
publish.yml on oxenfree999/psoul
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
psoul-0.0.1-py3-none-any.whl -
Subject digest:
df690a16b103635c2ab591c008408f156d4708a7fb1d795dd2d2d522da555251 - Sigstore transparency entry: 1187666266
- Sigstore integration time:
-
Permalink:
oxenfree999/psoul@764753a525862467762ce0a6300605e5f2a62b02 -
Branch / Tag:
refs/tags/v0.0.1 - Owner: https://github.com/oxenfree999
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@764753a525862467762ce0a6300605e5f2a62b02 -
Trigger Event:
push
-
Statement type:
