Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
A workshop that teaches you how to build your own coding agent. Similar to Roo code, Cline, Amp, Cursor, Windsurf or OpenCode.
| Date | Stars |
|---|---|
| 2026-07-24 | 5758 |
| 2026-07-25 | 5762 |
| 2026-07-28 | 5762 |
| 2026-07-30 | 5762 |
| 2026-07-31 | 5777 |
| 2026-08-06 | 5777 |
Today
— stars today
This week
+15 stars this week
This month
— stars this month
Momentum
15.0
growth rate 0.26%/day
# 🧠 Build Your Own Coding Agent via a Step-by-Step Workshop
Welcome! 👋 This workshop will guide you through building your own **AI-powered coding assistant** — starting from a basic chatbot, and adding powerful tools like file reading, shell command execution, and code searching.
You don’t need to be an AI expert. Just follow along and build step-by-step!
🌐 **Want a detailed overview?** Check out the blog post: [ghuntley.com/agent](https://ghuntley.com/agent/)
---
## 🎯 What You'll Learn
By the end of this workshop, you’ll understand how to:
- ✅ Connect to the Anthropic Claude API
- ✅ Build a simple AI chatbot
- ✅ Add tools like reading files, editing code, and running commands
- ✅ Handle tool requests and errors
- ✅ Build an agent that gets smarter with each step
---
## 🛠️ What We're Building
You’ll build 6 versions of a coding assistant.
Each version adds more features:
1. **Basic Chat** — talk to Claude
2. **File Reader** — read code files
3. **File Explorer** — list files in folders
4. **Command Runner** — run shell commands
5. **File Editor** — modify files
6. **Code Search** — search your codebase with patterns
```mermaid
graph LR
subgraph "Application Progression"
A[chat.go<br/>Basic Chat] --> B[read.go<br/>+ File Reading]
B --> C[list_files.go<br/>+ Directory Listing]
C --> D[bash_tool.go<br/>+ Shell Commands]
D --> E[edit_tool.go<br/>+ File Editing]
E --> F[code_search_tool.go<br/>+ Code Search]
end
subgraph "Tool Capabilities"
G[No Tools] --> H[read_file]
H --> I[read_file<br/>list_files]
I --> J[read_file<br/>list_files<br/>bash]
J --> K[read_file<br/>list_files<br/>bash<br/>edit_file]
K --> L[read_file<br/>list_files<br/>bash<br/>code_search]
end
A -.-> G
B -.-> H
C -.-> I
D -.-> J
E -.-> K
F -.-> L
```
At the end, you’ll end up with a powerful local developer assistant!
---
## 🧱 How It Works (Architecture)
Each agent works like this:
1. Waits for your input
2. Sends it to Claude
3. Claude may respond directly or ask to use a tool
4. The agent runs the tool (e.g., read a file)
5. Sends the result back to Claude
6. Claude gives you the final answer
We call this the **event loop** — it's like the agent's heartbeat.
```mermaid
graph TB
subgraph "Agent Architecture"
A[Agent] --> B[Anthropic Client]
A --> C[Tool Registry]
A --> D[getUserMessage Function]
A --> E[Verbose Logging]
end
subgraph "Shared Event Loop"
F[Start Chat Session] --> G[Get User Input]
G --> H{Empty Input?}
H -->|Yes| G
H -->|No| I[Add to Conversation]
I --> J[runInference]
J --> K[Claude Response]
K --> L{Tool Use?}
L -->|No| M[Display Text]
L -->|Yes| N[Execute Tools]
N --> O[Collect Results]
O --> P[Send Results to Claude]
P --> J
M --> G
end
subgraph "Tool Execution Loop"
N --> Q[Find Tool by Name]
Q --> R[Execute Tool Function]
R --> S[Capture Result/Error]
S --> T[Add to Tool Results]
T --> U{More Tools?}
U -->|Yes| Q
U -->|No| O
end
```
## 🚀 Getting Started
### ✅ Prerequisites
* Go 1.24.2+ or [devenv](https://devenv.sh/) (recommended for easy setup)
* An [Anthropic API Key](https://www.anthropic.com/product/claude)
### 🔧 Set Up Your Environment
**Option 1: Recommended (using devenv)**
```bash
devenv shell # Loads everything you need
```
**Option 2: Manual setup**
```bash
# Make sure Go is installed
go mod tidy
```
### 🔐 Add Your API Key
```bash
export ANTHROPIC_API_KEY="your-api-key-here"
```
---
## 🏁 Start with the Basics
### 1. `chat.go` — Basic Chat
A simple chatbot that talks to Claude.
```bash
go run chat.go
```
* ➡️ Try: “Hello!”
* ➡️ Add `--verbose` to see detailed logs
---
## 🛠️ Add Tools (One Step at a Time)
### 2. `read.go` — Read Files
Now ClExcerpt of 7,550 characters
Read on GitHub
Geoffrey Huntley · Australia
10
1
1
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:80931bfd2caacbed, readme:coding assistant, name:coding agent, desc:coding agent
matched fp:80931bfd2caacbed, topic:tutorial