aignermax

Autonomous Issue Agent — Git skill for Claude Code

Git community

Autonomous GitHub issue implementation using Claude Code in headless mode.

How to install Autonomous Issue Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open aignermax/autonomous-issue-agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Autonomous Issue Agent does

Autonomous GitHub issue implementation using Claude Code in headless mode.

Alternatives in Git

Contributing To Context-mode — This project is licensed under the Elastic License 2.0 (ELv2) and moves forward with your support 5.6k ★
Perfup — Autonomous performance optimization: research, PoC, benchmark, implement, review, PR 3.6k ★
Skill Copilot Provider — GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode 2.8k ★

README

Autonomous Issue Agent (AIA)

An autonomous agent that implements GitHub Issues using Claude Code.

**Works with any GitHub repository** — not limited to a specific tech stack or project type.

Implementation: Python Agent

**Recommended Implementation:** Standalone Python agent (headless subprocess)

The Python-based autonomous agent runs as a background service:

✅ Fully automated polling loop - Monitors multiple repositories 24/7
✅ Headless operation - Runs without interactive Claude Code session
✅ Multi-repository support - Process issues across different repos
✅ Session management - Resumes work across restarts
✅ Built-in tools - Semantic search and smart test runner
⚠️ No MCP support - MCP causes hangs in subprocess headless mode
ℹ️ Token usage - ~15-25k tokens per issue

**Note:** An experimental plugin implementation exists in `plugin/` but has stability issues with MCP in headless mode and is not actively maintained. The Python agent is the stable, production-ready implementation.

🛠️ AI-Powered Development Tools

Looking for standalone AI development tools? Check out [**python-dev-tools**](https://github.com/aignermax/python-dev-tools):

Semantic Search - Natural language code search using AI embeddings
Smart Test Runner - Automatically finds and runs only relevant tests

These tools can be used independently or integrated with this agent for enhanced capabilities.

How it works

GitHub Issues (label: agent-task) across multiple repos
        │
        ▼
   Agent polls every 15s (configurable)
        │
        ▼
   For each repository:
     - Check for agent-task issues
     - Clone/pull latest changes
     - Create feature branch
        │
        ▼
   Claude Code (headless):
   - Reads the entire repository
   - Understands the architecture
   -