# Ocr CLI

> Extract text from images using OCR (Optical Character Recognition)

- Skill: `javimosch/ocr-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/ocr-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/ocr-cli/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/ocr-cli

---

# ocr-cli Plugin

Extract text from images using OCR (Optical Character Recognition). Powered by rapidocr-onnxruntime for accurate, local text extraction without API keys.

**Repository:** https://github.com/javimosch/ocr-cli

## Installation

For detailed installation guidance, see the [ocr-cli repository](https://github.com/javimosch/ocr-cli).

**Quick install:**
```bash
# Plugin is already available in supercli
sc plugins install ocr-cli
```

**Requirements:**
- Python 3.10+
- uv package manager  
- xclip for clipboard support: `sudo apt install xclip`

## Features
- Extract text from clipboard images (Linux/X11)
- Extract text from image files (PNG, JPG, etc.)
- Local processing - no API keys required
- High accuracy using rapidocr-onnxruntime

## Usage

### Extract text from clipboard
```bash
ocr clipboard extract
```

### Extract text from file (direct CLI)
```bash
~/ai/supercli-clis/ocr-cli/bin/ocr-cli --file /path/to/image.png
```

## Notes
- First run may take a few seconds to download OCR models (~100MB)
- Works best with clear, high-contrast images
- Supports common image formats (PNG, JPG, etc.)