Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions agents/kandada__aacode/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# AACode

A lightweight, 100%-Python CLI coding agent built on a **ReAct (Reason + Act) loop**. Give it a task in plain language — it plans, writes code, runs it, reads the errors, fixes them, and ships a working result. No manual prompt engineering needed.

---

## Run

```bash
npx @open-gitagent/gitagent run -r https://github.com/kandada/aacode
```

---

## What It Can Do

- **Autonomous coding** — Write, run, debug, and verify code end-to-end, with TDD loops that don't quit until tests pass
- **Multi-step task planning** — Builds a live TODO list, updates it as work progresses, and verifies each item before marking it done
- **Shell access** — Runs arbitrary shell commands, installs dependencies, writes scripts, and interprets output
- **Web search & fetch** — Searches via SearXNG and fetches URLs for real-time information during coding tasks
- **Sub-agent delegation** — Spawns isolated sub-agents for sub-tasks that would crowd the main context window
- **Multimodal input** — Understands screenshots, UI mockups, and images to generate matching code
- **Extensible skills** — pandas, numpy, Playwright, and user-defined skills auto-loaded from `skills/`
- **MCP integration** — Connects to any MCP server via stdio or SSE

## Provider-agnostic

Works with **DeepSeek** (default), OpenAI GPT-4, Anthropic Claude, Kimi K2.5, Gemini, and any OpenAI-compatible API. Switch providers with three env vars — no code changes.

```bash
export LLM_API_KEY="your-key"
export LLM_API_URL="https://api.deepseek.com/v1"
export LLM_MODEL_NAME="deepseek-chat"
aacode run -p ./my-project "Add unit tests for all public functions"
```

## Quick start

```bash
pip install aacode
aacode init # configure LLM provider
aacode run -p /your/project "your task"
```

---

## Built with
[gitagent](https://github.com/open-gitagent/gitagent) — a git-native, framework-agnostic open standard for AI agents.
14 changes: 14 additions & 0 deletions agents/kandada__aacode/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"name": "aacode",
"author": "kandada",
"description": "Lightweight, 100%-Python CLI coding agent on a ReAct loop — plans, writes, runs, and tests code autonomously. Provider-agnostic: DeepSeek, OpenAI, Claude, and more.",
"repository": "https://github.com/kandada/aacode",
"version": "1.7.8",
"category": "developer-tools",
"tags": ["coding-agent", "cli", "react-architecture", "deepseek", "openai", "anthropic", "python", "agentic-coding", "multi-provider", "sub-agents"],
"license": "GPL-3.0",
"model": "deepseek-chat",
"adapters": ["system-prompt", "openai", "claude-code"],
"icon": false,
"banner": false
}