# AgentShovels
> CLI tools directory for developers and AI agents

## Stats
- 893 approved CLI tools
- Categories: ai, api, automation, benchmark, build, clipboard, cloud, compression, container, conversion, data-processing, database, debug, devops, documentation, editor, file-management, file-viewer, git, http, language, linting, media, misc, monitoring, navigation, network, package-manager, productivity, search, security, shell, static-site-generator, system, terminal, testing, web

## API
- Search: POST /api/search {"query": "...", "category?": "...", "limit?": 20}
- List tools: GET /api/tools?page=1&limit=20&category=&sort=score
- Tool detail: GET /api/tools/:slug
- Track install: GET /api/tools/:slug/install
- Report usage: POST /api/report {"slug": "...", "outcome": "success|failure"} (requires API key)
- Categories: GET /api/categories

## Auth
- API keys via /settings after GitHub login
- Header: Authorization: Bearer <api-key>

## CLI
- npm install -g agentshovels
- agentshovels search <query>
- agentshovels info <slug>
- agentshovels install <slug>
- agentshovels report <slug> --outcome success