Metadata-Version: 2.4
Name: neuralmint-cli
Version: 0.1.0
Summary: A toolbox of 24 CLI utilities for developers, ops, and crypto
Author: NeuralMint
License-Expression: MIT
Project-URL: Homepage, https://github.com/nousresearch/neuralmint-cli
Project-URL: Source, https://github.com/nousresearch/neuralmint-cli
Project-URL: Tracker, https://github.com/nousresearch/neuralmint-cli/issues
Keywords: cli,tools,crypto,developer-tools,utilities
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# neuralmint-cli

A toolbox of **24 CLI utilities** bundled into a single pip-installable package.
Runs any tool via the `neuralmint` command.

## Installation

```bash
pip install neuralmint-cli
```

Or install from source:

```bash
git clone https://github.com/nousresearch/neuralmint-cli.git
cd neuralmint-cli
pip install -e .
```

## Usage

```bash
# List all available tools
neuralmint --list

# Run a specific tool
neuralmint port-scanner scanme.nmap.org --ports 1-1000

# Get help for a specific tool
neuralmint ssl-checker --help

# Run via module
python -m neuralmint --list
```

Subcommands use hyphens (`port-scanner`) but map to Python modules with underscores (`port_scanner`).

## Available Tools

### Crypto & Blockchain
| Tool | Description |
|------|-------------|
| `chain-balance` | Check wallet balances across multiple blockchain networks |
| `crypto-news` | Fetch latest cryptocurrency news headlines |
| `crypto-price-alert` | Monitor crypto prices and trigger alerts |
| `crypto-sentiment` | Reddit sentiment analysis for crypto projects |
| `ens-resolver` | Resolve ENS (Ethereum Name Service) domains |
| `gas-checker` | Check current gas fees on Ethereum and other EVM chains |
| `liquidity-pool-analyzer` | Analyze DeFi liquidity pools |
| `rebalance` | Calculate portfolio rebalancing targets |
| `rug-check` | Quick risk assessment for token contracts |
| `solana-stake-checker` | Check Solana staking accounts |
| `token-info` | Fetch token metadata and supply info |
| `wallet-tracker` | Track wallet transactions and history |

### Developer & Ops Tools
| Tool | Description |
|------|-------------|
| `cron-parser` | Parse cron expressions to human-readable format |
| `csv-to-json` | Convert CSV files to JSON/NDJSON |
| `json-validator` | Validate and pretty-print JSON files |
| `link-checker` | Check for broken links in markdown files |
| `mac-vendor` | Look up MAC address vendor (built-in OUI database) |
| `markdown-toc` | Generate table of contents from markdown headings |
| `password-gen` | Generate secure passwords |
| `port-scanner` | TCP port scanner with service name lookup |
| `qr-gen` | Generate QR codes from text or URLs |
| `ssl-checker` | SSL/TLS certificate inspection and validation |
| `weather-cli` | Current weather and forecast from command line |

### Data & Finance
| Tool | Description |
|------|-------------|
| `currency-converter` | Real-time currency conversion using exchangerate.host |

## Development

```bash
# Install in development mode
pip install -e .

# Run a tool
neuralmint --list
neuralmint weather-cli --help
```

## License

MIT
