aide
agent
Fail
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- fs.rmSync — Destructive file system operation in backend/src/agent/Budget.test.ts
- process.env — Environment variable access in backend/src/agent/LLM.ts
- child_process — Shell command execution capability in backend/src/agent/Reflekt.ts
- execSync — Synchronous shell command execution in backend/src/agent/Reflekt.ts
- fs.rmSync — Destructive file system operation in backend/src/agent/Tools.test.ts
- fs.rmSync — Destructive file system operation in backend/src/agent/Tools.ts
- child_process — Shell command execution capability in backend/src/server.ts
- execSync — Synchronous shell command execution in backend/src/server.ts
- process.env — Environment variable access in backend/src/server.ts
Permissions Pass
- Permissions — No dangerous permissions requested
Purpose
This tool is an autonomous AI agent designed to read, modify, and improve its own source code recursively, utilizing a continuous loop to edit files and auto-commit changes without human intervention.
Security Assessment
The overall security risk is High. By design, the agent heavily utilizes `child_process` and `execSync` to execute arbitrary synchronous shell commands on your machine. It also performs destructive file system operations (`fs.rmSync`) to delete files. While the tool accesses environment variables to fetch required API keys (which is expected), the combination of autonomous execution, unrestricted shell access, and file deletion capabilities is highly dangerous. There is an inherent risk that an AI hallucination could result in catastrophic damage to your local file system.
Quality Assessment
The project is licensed under the standard MIT license and saw repository updates very recently. However, it is clearly labeled as an experimental project. It currently has extremely low community visibility with only 5 stars, meaning it has not been widely peer-reviewed or battle-tested by a broader developer community.
Verdict
Use with extreme caution in isolated, sandboxed environments; it is absolutely not recommended for use on your primary local machine.
This tool is an autonomous AI agent designed to read, modify, and improve its own source code recursively, utilizing a continuous loop to edit files and auto-commit changes without human intervention.
Security Assessment
The overall security risk is High. By design, the agent heavily utilizes `child_process` and `execSync` to execute arbitrary synchronous shell commands on your machine. It also performs destructive file system operations (`fs.rmSync`) to delete files. While the tool accesses environment variables to fetch required API keys (which is expected), the combination of autonomous execution, unrestricted shell access, and file deletion capabilities is highly dangerous. There is an inherent risk that an AI hallucination could result in catastrophic damage to your local file system.
Quality Assessment
The project is licensed under the standard MIT license and saw repository updates very recently. However, it is clearly labeled as an experimental project. It currently has extremely low community visibility with only 5 stars, meaning it has not been widely peer-reviewed or battle-tested by a broader developer community.
Verdict
Use with extreme caution in isolated, sandboxed environments; it is absolutely not recommended for use on your primary local machine.
An AI agent that lives inside its own source code and recursively improves itself
README.md
AIDE — Autonomous Self-Improving AI Agent
AIDE is an experimental AI agent that lives inside its own source code and continuously improves itself. It operates autonomously — no human intervention required.

What It Does
- Self-modifying agent: AIDE reads, writes, edits, and deletes files in its own codebase (TypeScript backend + React frontend) to fix bugs, add features, and improve its own reasoning.
- Autonomous loop: The agent analyzes the code, plans changes, implements them, verifies compilation, and commits to Git — all on its own.
- Auto-verification: After every file edit or write, the agent runs
npx tsc --noEmitto catch TypeScript errors immediately, preventing broken code from being committed. - Persistent memory: A 3-tier context budget system keeps track of long-term, short-term, and working memory, with JSONL logs for conversation history and an
AGENT.mdfile for quick session recovery. - Live UI: A React frontend connects via WebSocket to watch the agent think, act, and update files in real time, with a tabbed HUD showing both chat messages and live thought streams.
- Toolset: The agent has access to file I/O, directory listing, regex search, command execution, and Git operations.
Architecture
backend/
src/
agent/Reflekt.ts — Agentic loop (the brain)
agent/LLM.ts — LLM provider (DeepSeek API)
agent/Budget.ts — Memory management (3-tier context budget)
agent/Tools.ts — File I/O, git, search, and command execution
server.ts — WebSocket + Express server
frontend/
src/ — React/Vite/Tailwind UI
App.tsx — Chat interface + code preview
...
Quick Start
# Clone the repository
git clone https://github.com/hibbault/aide.git
cd aide
# Install backend dependencies
cd backend && npm install && cd ..
# Install frontend dependencies
cd frontend && npm install && cd ..
# Set up your API key
cp backend/.env.example backend/.env
# Edit backend/.env and add your DeepSeek API key
# Start the backend server
cd backend && npm run dev
# In another terminal, start the frontend
cd frontend && npm run dev
How It Works
- The agent receives a task or sits idle.
- It reads relevant files, plans changes, and outputs a
<TOOL_CALL>JSON block with the tool to invoke (e.g.,edit_file,run_command). - The tool executes, and the result is fed back into the agent's context.
- After each edit, TypeScript compilation is verified automatically (
npx tsc --noEmit). - On success, changes are committed to Git with descriptive messages.
- The agent then identifies the next most impactful improvement and loops.
Safety
- The agent never commits
.envfiles, API keys, or secrets. - It never modifies
.gitignoreto track sensitive files. - All changes are versioned in Git, so mistakes can be reverted.
Status
Experimental — use at your own risk. The agent can and will modify its own source code, potentially introducing regressions. Always review commits.
License
MIT
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found