Skip to main content

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

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)

Source distribution for ry-tool 1.3.0
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)

Table of built distributions (wheels) for ry-tool 1.3.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page