Skip to content
Agent

ngx-renamer Development Agent

by chriskoch

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to set up the "ngx-renamer Development Agent" agent in my project.
Repository: https://github.com/chriskoch/ngx-renamer

Please read the repo to find the agent definition file, then:
1. Download it to the correct location (.claude/agents/ or project root)
2. Include any companion files or templates it references
3. Explain what the agent does and how to invoke it

Description

AI coding agent for ngx-renamer, a Paperless NGX document title generator

Project Overview

Tech Stack: • Python 3.8+ • OpenAI API (GPT-4o, GPT-4o-mini) with structured outputs • Anthropic Claude API (Claude 3.5 Sonnet) with tool calling • Ollama API (local LLM support) with JSON schema validation • PyYAML for configuration • pytest for testing • Docker for deployment Project Structure: ` ngx-renamer/ ├── change_title.py # Main entry point ├── modules/ │ ├── base_llm_provider.py # Abstract base class for LLM providers │ ├── openai_titles.py # OpenAI integration │ ├── claude_titles.py # Anthropic Claude integration │ ├── ollama_titles.py # Ollama integration │ ├── paperless_ai_titles.py # Paperless API orchestrator │ ├── logger.py # Centralized logging configuration │ ├── constants.py # Constants and schemas │ ├── exceptions.py # Custom exception hierarchy │ ├── llm_factory.py # Provider factory with registry pattern │ ├── paperless_client.py # Paperless NGX API client │ └── providers/ # Provider plugin directory │ └── __init__.py # Provider registry and auto-discovery ├── scripts/ │ ├── init-and-start.sh # Docker entrypoint │ ├── setup-venv-if-needed.sh # Venv initialization │ └── post_consume_wrapper.sh # Post-consume hook ├── tests/ │ ├── conftest.py # Test fixtures │ ├── fixtures/ # Test data (YAML configs) │ └── integration/ # Integration tests ├── settings.yaml # Configuration file ├── requirements.txt # Runtime dependencies └── requirements-dev.txt # Development dependencies `

AGENTS.md

You are an expert Python developer working on ngx-renamer, an AI-powered document title generator for Paperless NGX. Your role is to maintain, test, and improve the codebase while following established conventions.

Create virtual environment

python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

Install dependencies

pip install -r requirements.txt requirements-dev.txt

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 2mo ago
Active
AdoptionUnder 100 stars
43 ★ · Niche
DocsMissing or thin
Undocumented

GitHub Signals

Stars43
Forks3
Issues0
Updated2mo ago
View on GitHub
GPL-3.0 License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code
Claude.ai