shiba-dev-tools 0.4.0

Developer tools in a CLI

shiba-dev-tools

Developer tools in a CLI.

Features

• Configuration Management: JSON-based config system with atomic writes, file locking, and global storage
• GitHub Integration: Manage pull requests and comments from the command line
• Notebook Management: Organize and manage development notes with category-based organization
• Cross-Platform: Works on Windows, macOS, and Linux with platform-aware directory handling
• Type-Safe: Fully typed with pyright for better IDE support
• Global Data Storage: Configs and notebooks stored globally (~/.sdt/) for multi-project use

Installation

From PyPI (Recommended)

pip install shiba-dev-tools

From Source (Development)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install
git clone https://github.com/leeaaron629/shiba-dev-tools.git
cd shiba-dev-tools
make install

Usage

After installation, the sdt command will be available. All data is stored globally in:

• macOS/Linux: ~/.sdt/
• Windows: %LOCALAPPDATA%/sdt/
• Custom location: Set SDT_HOME environment variable

# View all commands
sdt --help

# Configuration management (stored in ~/.sdt/configs/)
sdt cfg create
sdt cfg set github.token ghp_xxxxx
sdt cfg set settings.timeout 60
sdt cfg get settings.timeout
sdt cfg edit  # Open config in $EDITOR

# GitHub integration
sdt gh prs                          # List open PRs for default user
sdt gh prs --user octocat           # List PRs for specific user
sdt gh prs --id 123                 # Show PR comments (JSON format)
sdt gh prs -i 123 --format rich     # Show PR with colorful formatting
sdt gh prs --id 123 --format plain  # Plain text format

# Notebook management (stored in ~/.sdt/notebooks/)
sdt nb                              # List categories
sdt nb work                         # List notes in "work" category
sdt nb work standup --write "..."   # Write a note
sdt nb work standup                 # Read a note
sdt nb work standup --edit          # Edit in $EDITOR
sdt nb work --delete                # Archive category

Requirements

• Python 3.10+
• uv package manager (for development)

Development

See CONTRIBUTING.md for development setup, testing, and release process.

Quick Start

# Install dependencies
make install

# Run tests with coverage
make test

# Run linting (ruff + pyright)
make lint

# Format code
make format

# Build the package
make build

Code Quality

This project uses:

• ruff for linting and formatting
• pyright for type checking
• pytest for testing with coverage

# Run all checks
make lint

# Auto-format code
make format

Project Structure

shiba-dev-tools/
├── .github/workflows/      # CI/CD workflows
├── dev_tools/              # Main source package
│   ├── main.py            # Root CLI app
│   ├── config.py          # Configuration management
│   ├── github.py          # GitHub integration
│   ├── notebook.py        # Notebook management
│   ├── paths.py           # Platform-aware path resolution
│   └── ...
├── dev_tools_tests/       # Test package
├── pyproject.toml         # Project configuration
├── Makefile               # Development commands
└── README.md              # This file

Data Storage

All application data is stored in a global directory:

~/.sdt/                     # Global SDT directory
├── configs/               # Configuration files
│   └── config.json       # Default config
└── notebooks/             # Note storage
    ├── {category}/       # Note categories
    │   └── {slug}.txt    # Individual notes
    └── .archive/         # Archived categories

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Changelog

See CHANGELOG.md for release history.