johnston

   _       _                 _                 
  (_)     | |               | |                
   _  ___ | |__  _ __  ___ _| |_ ___  _ __     
  | |/ _ \| '_ \| '_ \/ __|_   _/ _ \| '_ \    
  | | (_) | | | | | | \__ \ | || (_) | | | |   
  | |\___/|_| |_|_| |_|___/  \__\___/|_| |_|   
 /_/                                           
    Python Terminal-based AI Assistant CLI

Quick Start

Run instantly:

uvx johnston

Install globally:

uv tool install johnston

Install via script:

curl -fsSL https://raw.githubusercontent.com/p4ulbr4dl3y/johnston/main/install.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/p4ulbr4dl3y/johnston/main/install.ps1 | iex

Development

# Run tests
uv run pytest

# Run tests with coverage
uv run coverage run -m pytest
uv run coverage report -m

# Check code style
uv run ruff check .

Release files for johnston 0.29.0

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

Source distribution (sdist)

Source distribution for johnston 0.29.0
File	Size	Uploaded
johnston-0.29.0.tar.gz	539.1 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for johnston 0.29.0
File	Interpreter	ABI	Platform	Reset
johnston-0.29.0-py3-none-any.whl 573.9 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / johnston-0.29.0.tar.gz

Download URL	johnston-0.29.0.tar.gz
Size	539.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`0bb5c220ac5334d65070749afd6f1dd6f1be984f366ee95693da9061575ab4b0`
BLAKE2b-256 checksum How to use checksums	`f18c93838bbcca11c028f14791182e31e921fde696f745975a1e296773aa42e9`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/p4ulbr4dl3y/johnston
Publishing commit: github.com/p4ulbr4dl3y/johnston/tree/926cb288bf5e9f99ce4e662ef1792a5dffb3160d

Workflow

Publishing configuration: github.com/p4ulbr4dl3y/johnston/blob/926cb288bf5e9f99ce4e662ef1792a5dffb3160d/.github/workflows/release-please.yml
Publishing logs: github.com/p4ulbr4dl3y/johnston/actions/runs/33848988082/attempts/1

Artifact

Subject: johnston-0.29.0.tar.gz
SHA-256 checksum: 0bb5c220ac5334d65070749afd6f1dd6f1be984f366ee95693da9061575ab4b0 Verifying attestations

Release files / johnston-0.29.0-py3-none-any.whl

Download URL	johnston-0.29.0-py3-none-any.whl
Size	573.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2c1820956994f1a7515c6fc0075e843f17272770e560dcacb2660b1852cd5351`
BLAKE2b-256 checksum How to use checksums	`f7c33f8eed408bd8ce932e9ae6717a6aaca127616af61917351d274b022abad7`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/p4ulbr4dl3y/johnston
Publishing commit: github.com/p4ulbr4dl3y/johnston/tree/926cb288bf5e9f99ce4e662ef1792a5dffb3160d

Workflow

Publishing configuration: github.com/p4ulbr4dl3y/johnston/blob/926cb288bf5e9f99ce4e662ef1792a5dffb3160d/.github/workflows/release-please.yml
Publishing logs: github.com/p4ulbr4dl3y/johnston/actions/runs/33848988082/attempts/1

Artifact

Subject: johnston-0.29.0-py3-none-any.whl
SHA-256 checksum: 2c1820956994f1a7515c6fc0075e843f17272770e560dcacb2660b1852cd5351 Verifying attestations