ry
A command augmentation framework that wraps and enhances existing CLI tools without breaking their native behavior.
Features
- Command Augmentation: Enhance existing CLI tools with validation, safety checks, and workflows
- Clean Architecture: Modular design with single-responsibility components
- Type-Safe Processing: Recursive template processing with proper type dispatch
- Token-Based Safety: Time-limited tokens for dangerous operations
- Library System: Reusable command definitions with metadata
- Direct Execution: No shell escaping for safety
Installation
uv tool isntall ry-tool
This installs the ry command globally.
Quick Start
# List available libraries
ry --list
# Get help for a library
ry git --ry-help
# Execute augmented command
ry git commit -m "feat: new feature"
# Show execution plan (dry run)
ry --ry-run git commit -m "test"
Production Libraries
- git - Enhanced git workflow with review tokens and commit validation
- uv - Python package management with automated version workflows
- changelog - Simple changelog management following Keep a Changelog
- ry-lib - Library development and management tools
- site-builder - Static documentation site generator
Library System
Example: Git Enhancement
version: "2.0"
name: git
type: augmentation
target: /usr/bin/git
commands:
commit:
flags:
m/message: string
augment:
before:
- python: |
# Validation logic
relay: native
Token-Based Safety
Critical operations require preview and token verification:
# Preview changes
ry git diff --staged # → Generates REVIEW_TOKEN
# Execute with token
REVIEW_TOKEN=xxx ry git commit -m "message"
Project Structure
ry-tool/
├── src/ry_tool/ # Core implementation
├── docs/
│ ├── libraries/ # Production libraries
│ └── ARCHITECTURE.md # Technical documentation
├── examples/ # Example libraries
└── CLAUDE.md # AI assistant guidance
Development
# Run linter
ruff check src/ry_tool/ --fix
# Build distribution
uv build
# Create a new library
ry ry-lib create <name> <type>
# Validate libraries
ry ry-lib validate --all
Documentation
- Architecture Guide - Technical details and design
- Library Development - Creating custom libraries
- Examples - Working examples
- Style Guide - Output formatting standards
License
MIT
Metadata
Release files for ry-tool 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ry_tool-1.3.0.tar.gz | 25.6 kB | Without provenance | Details for ry_tool-1.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ry_tool-1.3.0-py3-none-any.whl | Python 3 | none | any | Details for ry_tool-1.3.0-py3-none-any.whl |
Total release size: 57.0 kB
Release files / ry_tool-1.3.0.tar.gz
| Download URL | ry_tool-1.3.0.tar.gz |
|---|---|
| Size | 25.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b23dbc5051b05860119c8d468f947ca611033f97b1df0c45d63c365c27ee566
|
|
BLAKE2b-256 checksum How to use checksums |
ebd126be0ff57d26571a58e5c05e186b365b9efe8da9e5fe6171946b7a3f9498
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.15
|
Release files / ry_tool-1.3.0-py3-none-any.whl
| Download URL | ry_tool-1.3.0-py3-none-any.whl |
|---|---|
| Size | 31.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e3efe79c7b90d075ecdbc1579ffb1d7b53e5c3f63a4a659eef25618c83575fb
|
|
BLAKE2b-256 checksum How to use checksums |
075336f5311e9d85778a5f0ae9ef7ee1a80b07014f090de6116932c1d3c01075
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.15
|
Security for ry-tool 1.3.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.