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 1.0.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 1.0.0
File	Size	Uploaded
johnston-1.0.0.tar.gz	753.2 kB	Sep 16, 2026	Details

Built distribution (wheel)

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

Total release size: 1.6 MB

Release files / johnston-1.0.0.tar.gz

Download URL	johnston-1.0.0.tar.gz
Size	753.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`d6b307a485fad2e66320a8ad659d7de05f54c2f5c9b687f6910f4bd714d7c115`
BLAKE2b-256 checksum How to use checksums	`8e2cfd3ed3578b748d08ec4254663a16d373cdd6d718afe3e1e6bf20bfb279d5`
Upload date	Sep 16, 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/9b94efb46fc5780ae38df60dc239275f8ae15ddd

Workflow

Publishing configuration: github.com/p4ulbr4dl3y/johnston/blob/9b94efb46fc5780ae38df60dc239275f8ae15ddd/.github/workflows/release-please.yml
Publishing logs: github.com/p4ulbr4dl3y/johnston/actions/runs/35147441486/attempts/1

Artifact

Subject: johnston-1.0.0.tar.gz
SHA-256 checksum: d6b307a485fad2e66320a8ad659d7de05f54c2f5c9b687f6910f4bd714d7c115 Verifying attestations

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

Download URL	johnston-1.0.0-py3-none-any.whl
Size	860.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`411d5a92606fc8b6609bdfe687a18db7c6bfa523780e678cf7cd869f4f17940d`
BLAKE2b-256 checksum How to use checksums	`e856baa140f7ea01b2099047566bd5b27aac35c226c6b83c5d65cc4213e50242`
Upload date	Sep 16, 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/9b94efb46fc5780ae38df60dc239275f8ae15ddd

Workflow

Publishing configuration: github.com/p4ulbr4dl3y/johnston/blob/9b94efb46fc5780ae38df60dc239275f8ae15ddd/.github/workflows/release-please.yml
Publishing logs: github.com/p4ulbr4dl3y/johnston/actions/runs/35147441486/attempts/1

Artifact

Subject: johnston-1.0.0-py3-none-any.whl
SHA-256 checksum: 411d5a92606fc8b6609bdfe687a18db7c6bfa523780e678cf7cd869f4f17940d Verifying attestations