Metadata-Version: 2.4
Name: psoul
Version: 0.0.4
Summary: A CLI-first foundation for managed Python sessions.
Project-URL: Homepage, https://github.com/oxenfree999/psoul
Project-URL: Repository, https://github.com/oxenfree999/psoul
Project-URL: Issues, https://github.com/oxenfree999/psoul/issues
License-Expression: MIT
License-File: LICENSE
Keywords: cli,console,lifecycle,process,python,repl,session,shell,subprocess,supervisor,terminal
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Shells
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: platformdirs>=4.0
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: psutil>=6.0
Requires-Dist: ptyprocess<1,>=0.7.0; sys_platform != 'win32'
Requires-Dist: pygments>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: structlog>=24.1
Requires-Dist: tomlkit>=0.14
Requires-Dist: typer>=0.12
Provides-Extra: gpu
Requires-Dist: nvidia-ml-py>=12.0; extra == 'gpu'
Description-Content-Type: text/markdown

# 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

```bash
uv add psoul
```

Or try it without installing:

```bash
uvx psoul --help
```

## Quick start

```bash
psoul                # interactive REPL with history
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](https://docs.astral.sh/uv/) for package management.
[just](https://just.systems/) provides shorthand dev commands but is
optional — the underlying `uv run` commands work fine on their own.

```bash
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, macOS, and Windows across Python 3.12, 3.13, and 3.14.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## License

[MIT](LICENSE)
