🤖 AgenticAgents (OllamaForge) v2.7.0

The Sovereign Multi-Agent Software Factory for VS Code

AgenticAgents is a state-of-the-art multi-agent orchestration engine that transforms a single natural language prompt into a complete, production-ready codebase. It shifts the paradigm from simple "chat assistants" to a fully autonomous software factory that runs on your hardware or in the cloud.

🌩️ Total Architectural Freedom

100% Local Sovereignty: Run entirely offline using Ollama. Your code never leaves your machine.
Scale to the Cloud: Seamlessly connect to Ollama Cloud (Groq, Fireworks, OpenRouter) to leverage massive 405B+ models for complex reasoning.
Hybrid Intelligence: Mix and match. Use a high-reasoning Cloud model as your Architect (Master) and agile local models as your Builders (Workers).

🏗️ Master/Worker Syndicate Architecture

Inspired by high-performance engineering teams, AgenticAgents utilizes a hierarchical model that outpaces traditional linear chat bots.

🧠 The Master Agent (The Architect)

The Master is the persistent brain of the mission. It maintains global project state, plans the mission, and delegates work.

Autonomous Discovery: Recursively explores your codebase and researches documentation via websearch.
Zero-Loss Succession: When context limits are hit, it writes a Testament and spawns a Successor with zero memory loss.
Unified Registry: All metadata, roadmaps, and logs are consolidated in a clean .agenticagents directory.

👷 The Worker Agents (The Builders)

Workers are specialized, short-lived agents spawned to own specific files or technical tasks.

Massive Parallelism: Spawns concurrent workers with rolling replenishment. Each worker can process up to 5 files simultaneously, optimizing efficiency so that 3 workers can handle up to 15 files at once!
Hardened Specialized Tools: Dedicated handlers for Python, Java, Maven, npm, and Shell with strict whitelisting.
Self-Healing Loop: Uses the problems tool to detect VS Code build errors and fix them autonomously.

🎯 Three Specialized Mission Modes

Mode	Strategy	Phase Flow
ASK	Analytical Discovery	Discovery → Iterative Research → Direct Answer
FAST	Direct Implementation	Workspace Analysis → Immediate Implementation
PLAN-BUILD	Phased Orchestration	Discovery → Technical Roadmap (`todo.md`) → Parallel Building

🚀 Professional-Grade Capabilities

🧠 Autonomous Agent Succession

Never hit a context limit again. When the Master Agent's short-term memory (context window) hits 80%, it triggers Zero-Loss Succession. It writes a comprehensive "testament" of the project state, terminates itself, and spawns a fresh successor with full context, ensuring infinite, unbroken build loops for massive applications.

⏲️ True Temporal Rollback

Did the AI take a wrong turn? Hover over any query and click Cancel or Modify. The forge instantly reverts all filesystem creations, edits, and deletions back to the precise moment before that query was issued—purging agent memory and resetting the timeline perfectly.

🛡️ Hardened Execution Security

Security is baked in. The built-in shell tool features a Strict Command Whitelist. Agents are restricted to safe, development-focused operations (like npm, tsc, git). Dangerous operations like rm -rf and direct file CRUD via bash/PowerShell are actively blocked.

🔄 Dynamic Interjection & Pivot

Don't wait for completion. Send Interjective Guidance mid-workflow. The Master Agent will immediately abort its current thought process to pivot based on your feedback. The feedback appears as "Pending Guidance" until the AI acknowledges it.

👁️ Intelligent Vision Translation

Drop a UI mockup or whiteboard sketch into the chat. The Vision Integration automatically activates during planning to interpret the designs and translate them mathematically into React, Vue, or raw HTML/CSS.

🌐 Real-Time Knowledge Retrieval

Agents don't just guess outdated APIs. Integrated websearch and webfetch tools allow them to rapidly browse the latest official documentation or research StackOverflow solutions in real-time before writing code.

📊 Seamless Change Management

Pending Changes Sidebar: Review a continuous list of every file change (create, edit, delete).
Bi-directional Diff Sync: Approve or revert changes with full diff visibility natively in VS Code. Closing the diff tab auto-resolves the change UI state instantly.

⚡ Massive Worker Parallelism

The core engine dynamically spins up Worker Agents to handle file editing in the background while the master continues thinking. A single worker natively tracks up to 5 file streams concurrently, allowing 3 parallel workers to manage up to 15 files at once.

🛠️ How to Launch a Mission

Open the Forge: Press Ctrl+Shift+A or click the sidebar icon.
Define the Goal:

"Refactor this React app to use clean architecture and add a gRPC backend in Go."
Review the Discovery: Watch the Master explore your files and design screenshots.
Approve the Roadmap: The agents start building according to the .agenticagents/todo.md.
Monitor the Factory: Watch the Agent Monitor track tool calls and file edits in real-time.
Finalize: Review changes in the Pending Changes UI and approve the final build.

👨‍💻 Connect with the Architect

Built with ❤️ by Marouan BLELLETTA.
Interested in collaborating, reporting bugs, or hiring?

_{100% Privacy | 100% Autonomous | 100% Engineering}