{"id":45498470,"url":"https://github.com/mauhpr/agentlint-plugin","last_synced_at":"2026-04-08T01:02:41.062Z","repository":{"id":339075307,"uuid":"1160371124","full_name":"mauhpr/agentlint-plugin","owner":"mauhpr","description":"Claude Code plugin for AgentLint — real-time quality guardrails for AI coding agents","archived":false,"fork":false,"pushed_at":"2026-04-02T18:14:36.000Z","size":52,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T06:23:07.793Z","etag":null,"topics":["ai-agents","claude-code","claude-code-plugin","guardrails","hooks","linting","python"],"latest_commit_sha":null,"homepage":"https://github.com/mauhpr/agentlint","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mauhpr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-17T21:28:50.000Z","updated_at":"2026-04-02T18:14:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mauhpr/agentlint-plugin","commit_stats":null,"previous_names":["mauhpr/agentlint-plugin"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/mauhpr/agentlint-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauhpr%2Fagentlint-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauhpr%2Fagentlint-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauhpr%2Fagentlint-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauhpr%2Fagentlint-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mauhpr","download_url":"https://codeload.github.com/mauhpr/agentlint-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauhpr%2Fagentlint-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31535203,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","claude-code-plugin","guardrails","hooks","linting","python"],"created_at":"2026-02-22T18:04:14.767Z","updated_at":"2026-04-08T01:02:41.045Z","avatar_url":"https://github.com/mauhpr.png","language":"Shell","readme":"# agentlint — Claude Code Plugin\n\nReal-time guardrails for AI coding agents — code quality, security, and infrastructure safety. 63 rules across 8 packs covering all 17 Claude Code hook events.\n\n## Prerequisites\n\nInstall the `agentlint` Python package:\n\n```bash\npip install agentlint\n```\n\n## Binary resolution\n\nThe plugin automatically resolves the `agentlint` binary at runtime — no PATH configuration needed. It probes, in order: PATH lookup, `~/.local/bin` (pipx), `uv tool` install location, and `python -m agentlint`. This works regardless of how you installed the package.\n\nIf auto-resolution still fails, run `agentlint setup` to register hooks with an absolute path instead.\n\n## Troubleshooting\n\n**Hooks not firing?** Verify the plugin is installed: `claude plugin list`\n\n**`agentlint: command not found`?** The binary resolver couldn't locate agentlint.\nInstall it (`pip install agentlint`) or run `agentlint setup` to embed an absolute\npath in your hooks.\n\n**Timeouts?** PreToolUse hooks have a 5s timeout. If your project is very large,\nconsider using `severity: relaxed` in `agentlint.yml`.\n\n## Install from GitHub\n\nAdd the marketplace and install:\n\n```bash\nclaude plugin marketplace add mauhpr/agentlint-plugin\nclaude plugin install agentlint@agentlint\n```\n\n## Install Locally\n\n```bash\nclaude --plugin-dir /path/to/agentlint-plugin\n```\n\n## Vision\n\nThe short-term problem is code quality: secrets, broken tests, force-pushes, debug artifacts. AgentLint solves that today.\n\nThe longer-term question is harder: what does it mean for an agent to operate safely on real infrastructure? The **autopilot pack** is the first experiment in that direction — opt-in, explicitly experimental, built in the open.\n\n## What it does\n\nAgentLint hooks into all 17 Claude Code lifecycle events. The key events:\n\n- **PreToolUse** — Intercepts Bash, Edit, and Write calls. Blocks secrets, `.env` commits, force-pushes, destructive commands, unsafe shell execution, SQL injection, and more. Validates commit messages. With the security pack enabled, also blocks Bash file writes and network exfiltration.\n- **PostToolUse** — Checks written files for size limits, tracks edit drift, detects dead imports, warns on error handling removal, and flags unnecessary async. Tracks session token budget.\n- **UserPromptSubmit** / **SubagentStop** / **Notification** — Passthrough events for future rule expansion.\n- **Stop** — Generates an end-of-session quality report with debug artifact detection, TODO scanning, token budget summary, circuit breaker status, and adversarial self-review prompt.\n\n### Circuit Breaker (Progressive Trust)\n\nWhen a blocking rule fires repeatedly (3+ times), it automatically degrades from ERROR → WARNING → INFO → suppressed — preventing false-positive loops from blocking agents. Security-critical rules (`no-secrets`, `no-env-commit`) are exempt and always block. Auto-resets after 5 clean evaluations or 30 minutes. Fully configurable per-rule.\n\n## Rule packs\n\n| Pack | Rules | Auto-activates when |\n|------|-------|---------------------|\n| **universal** | 17 | Always active |\n| **quality** | 4 | Always active |\n| **python** | 6 | `pyproject.toml` or `setup.py` exists |\n| **frontend** | 8 | `package.json` exists |\n| **react** | 3 | `react` in package.json dependencies |\n| **seo** | 4 | SSR/SSG framework (Next.js, Nuxt, Gatsby, Astro, etc.) detected |\n| **security** | 3 | Opt-in (add `security` to packs) |\n| **autopilot** | 18 | Opt-in, ⚠️ experimental (add `autopilot` to packs) |\n\nSee [agentlint documentation](https://github.com/mauhpr/agentlint) for the full rule reference.\n\n## Configuration\n\nAfter installing, create `agentlint.yml` in your project:\n\n```bash\nagentlint init\n```\n\nSee [agentlint documentation](https://github.com/mauhpr/agentlint) for full configuration options.\n\n## Agents\n\nSpecialized agents for multi-step operations:\n\n- `/agentlint:security-audit` — Scan your codebase for security vulnerabilities, hardcoded secrets, and unsafe patterns\n- `/agentlint:doctor` — Diagnose configuration issues, verify hook installation, suggest optimal pack settings\n- `/agentlint:fix` — Auto-fix common violations (debug artifacts, accessibility, dead imports) with confirmation\n\n## Commands\n\n- `/agentlint:lint-status` — Show active rules and session violations\n- `/agentlint:lint-config` — Show or edit AgentLint configuration\n- `agentlint list-rules` — List all available rules (use `--pack security` to filter)\n- `agentlint status` — Show version, severity mode, active packs, rule count, and session activity\n- `agentlint doctor` — Diagnose common misconfigurations\n- `agentlint import-agents-md` — Import conventions from AGENTS.md into AgentLint config\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauhpr%2Fagentlint-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmauhpr%2Fagentlint-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauhpr%2Fagentlint-plugin/lists"}