Node.js Agentic Issue Resolver

This repository provides a robust, autonomous developer agent built with the GitHub Copilot SDK.

The Node.js Issue Resolver is a CLI-based agent that bridges the gap between high-level task descriptions and actual codebase modifications. It leverages the Copilot SDK to reason about problems, explore project structures, and apply fixes automatically.

---

🌟 Why this sample?

This project solves that by implementing a Resilient Tooling strategy:

• It guides the agent to use write_file for full-content updates, ensuring 100% stability.
• It provides a robust event listener to monitor tool execution and reasoning in real-time.
• It is fully optimized for Node.js (v18 to v24+) and ESM environments.

---

🚀 Key Features

• Autonomous Problem Solving: The agent analyzes your request, identifies relevant files, and determines the best course of action.
• Intelligent File Handling: Specifically optimized to avoid string-matching failures by favoring write_file for modifications.
• Real-Time Observability: Streams the agent's "thinking process" (message deltas) and tool execution logs directly to your terminal.
• Modern Tech Stack: Built with TypeScript and tsx for high-performance execution on Linux/WSL and macOS.

---

🛠 Prerequisites

1. GitHub Copilot CLI: Must be installed and authenticated.

   npm install -g @github/copilot-cli
   copilot -i login

2. Node.js: Version 18.x or higher (Node 22+ recommended).
3. Subscription: An active GitHub Copilot subscription.

---

📦 Setup

1. Clone the repository:

   git clone [https://github.com/Impesud/nodejs-copilot-issue-resolver.git](https://github.com/Impesud/nodejs-copilot-issue-resolver.git)
   cd nodejs-copilot-issue-resolver

2. Install dependencies:

   npm install

---

🕹 Usage

Run the agent by providing a task description in quotes. The agent will explore the directory and apply changes autonomously.

npm start "Update the description in package.json to 'AI-Powered Agentic Sample' and bump version to 0.1.1"

🤝 Contributing

Contributions are welcome! Please refer to AGENTS.md for detailed technical guidance on how AI agents (and humans) can contribute to this project.

License: MIT — Copyright (c) 2026 Impesud