@3a5y2k/paperless-search-skill
v1.0.1
Published
Paperless-ngx document search skill for OpenCode. Includes agent, scripts, and SKILL.md for intelligent document research.
Downloads
202
Maintainers
Readme
Paperless Search Skill for OpenCode
Intelligent document search in Paperless-ngx with OpenCode. Includes agent, scripts, and SKILL.md.
Install
npx @3a5y2k/paperless-search-skillOr add to your project's opencode.json:
{
"skills": {
"paths": ["node_modules/@3a5y2k/paperless-search-skill/skills"]
}
}Setup
After installation:
# 1. Copy config template
cp paperless/config.json.example paperless/config.json
# 2. Edit with your credentials
nano paperless/config.json
# 3. Run setup (tests connection, builds cache)
bash paperless/init.shUsage
Via OpenCode
Use the /research command:
/research Finde alle Rechnungen von 2024Via CLI
bash paperless/search.sh "Suchbegriff"
bash paperless/search.sh "Stromrechnung" "2024-01-01" "2024-12-31"What's Included
| File | Purpose |
|---|---|
| skills/paperless-search/SKILL.md | Skill definition for OpenCode |
| agents/research_agent.md | Research agent (subagent mode) |
| scripts/init.sh | Setup script (config, connection test, cache) |
| scripts/cache.sh | Cache loader for tags, correspondents, groups |
| scripts/search.sh | CLI search wrapper |
| config.json.example | Credentials template |
Files NOT Installed (gitignored)
paperless/config.json— Your credentials (create from example)paperless/.cache/— Runtime cache (auto-generated)
Requirements
- OpenCode
jq(apt install jqorbrew install jq)curl- Paperless-ngx instance with API token
License
MIT
