Argus: Open-source AI coding assistant with built-in code review

Argus, an open-source AI coding assistant, was released featuring a four-role architecture (PM, SE, AP, C) that autonomously executes coding tasks with built-in code review and approval. The tool uses a unified core with shared memory and role-based prompt switching to ensure code quality through a five-phase workflow including independent final approval.

Argus: The AI coding assistant with PM/SE/AP/C roles – never gets stuck, never forgets. Vibe Coding Platform — A desktop coding assistant powered by a four-role AI Agent architecture PM / SE / AP / C that understands your intent and executes coding tasks autonomously, with a built-in independent approver to ensure code quality. One Core, Multiple Roles Argus features a unified core architecture with shared memory and role-based prompt switching: ┌─────────────────────────────────────────────────────────────┐ │ Argus V2 Core │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ ArgusCore Unified Brain │ │ │ │ │ │ │ │ SharedMemory ← Full-context visibility │ │ │ │ ├── user: "Create hello.go" │ │ │ │ ├── pm: "This is a coding task" │ │ │ │ ├── se: "write file + exec" │ │ │ │ └── ap: "Approved" │ │ │ │ │ │ │ │ PromptKit Role Switching │ │ │ │ ├── PM Hat: Analyze requirements │ │ │ │ ├── SE Hat: Generate & execute code │ │ │ │ └── AP Hat: Review & approve results │ │ │ └─────────────────────────────────────────────────────┘ │ │ ↓ │ │ ┌──────────────────┐ ┌──────────────────────────────┐ │ │ │ Executor Hands │ │ CMonitor Watchdog │ │ │ │ │ │ │ │ │ │ write file │ │ - Timeout detection │ │ │ │ exec │ │ - Hang recovery │ │ │ │ read │ │ - Idle alerts │ │ │ └──────────────────┘ └──────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ Complete Pipeline: USR Input → PM Analysis → SE Execution → PM Code Review → AP Final Approval OA 5-Phase Workflow: ┌─────────────────────────────────────────────┐ │ 👤 USR │ │ You - Provide Requirements │ └──────────────┬──────────────────────────────┘ │ Natural Language Input ▼ ┌─────────────────────────────────────────────┐ │ 🎯 PM │ │ Phase 1: Analyze Requirements │ │ • Understands your requirements │ │ • Breaks down tasks & plans execution │ │ • Communicates plan with you │ └──────────────┬──────────────────────────────┘ │ Task Assignment ▼ ┌─────────────────────────────────────────────┐ │ 💻 SE │ │ Phase 2: Execute Code │ │ • Generates code │ │ • Writes/edits files │ │ • Executes commands │ │ • Self-testing verification │ └──────────────┬──────────────────────────────┘ │ SE Complete → Handover to PM ▼ ┌─────────────────────────────────────────────┐ │ 🎯 PM │ │ Phase 3: Code Review Second PM Pass │ │ • Reviews SE's work output │ │ • Uses tools to verify correctness │ │ • Approves or requests fixes │ └──────────────┬──────────────────────────────┘ │ PM Review Passed ▼ ┌─────────────────────────────────────────────┐ │ 🔍 AP │ │ Phase 4: Final Approval OA │ │ • Independent Code Review uninfluenced │ │ • QA Verification runs compile/test │ │ • Veto Power AP says no → task not done │ │ • Up to 3 rounds of tool calls │ └─────────────────────────────────────────────┘ ▲ ┌──────────────┴──────────────────────────────┐ │ 📊 C │ │ Background Monitor │ │ • Monitors PM/SE health status │ │ • Detects Git changes + auto-commit │ │ • Identifies stalls and alerts │ │ • PM→AP handover timeout fallback │ │ • Read-only — never acts autonomously │ └─────────────────────────────────────────────┘ | Role | Prefix | Intelligence | Responsibility | |------|--------|-------------|----------------| | 👤 USR | USR | Human | Provides requirements, makes decisions | | 🎯 PM | PM | AI LLM | Task planning, routing, quality control | | 💻 SE | SE | AI LLM | Code generation, file operations, command execution | | 🔍 AP | AP | AI LLM | Independent approval, QA verification, veto power | | 📊 C | Sys C | Mechanical | Health monitoring, change detection, handover fallback | --- 🔥 Core Features ✅ Implemented Capabilities 1️⃣ Four-Role AI Collaboration Unique - Natural language interaction : Chat with PM in Chinese/English; PM automatically breaks down tasks for SE - @mention routing : Use @PM , @SE , @AP to direct messages to specific agents - Triple quality assurance : - PM Code Review mandatory review of SE output, verified with tools - AP Independent Approval uninfluenced by PM, personally runs compile/test - SE Self-test Verification must pass before submission - AP Veto Power : If AP rejects, the task cannot be closed — SE must rework 2️⃣ SSE Streaming Output - Real-time visibility into AI thinking process : Token-by-token display - Event-driven push : pm started → se started → writing file → executing → done - Heartbeat keep-alive mechanism : Automatic disconnect recovery 3️⃣ Complete Task Lifecycle Management - Four-state state machine : idle → running → done → approved - Anti-infinite-loop mechanism : PM review max 10 rounds, SE execution threshold - Crash recovery system : SQLite persistence + task memory recovery 4️⃣ Robust Stability Assurance - Rate limiting & circuit breaker protection : Prevents API overload and cascading failures - C monitoring system : 30s health checks, Git change detection, progressive timeouts, handover fallback - Path security sandbox : File operations restricted to working directory 5️⃣ Rich Integration Capabilities - Multi-model support : OpenAI-compatible API Qwen, DeepSeek, GLM, GPT, Claude, etc. - Multi-config management : Switch API providers anytime - IM multi-channel integration : DingTalk bidirectional, Stream mode , Enterprise WeChat/Feishu interface reserved - Git integration : View changes, manual commits, SE output verification 6️⃣ User Experience - Modern GUI : Wails desktop app no CLI/TUI - Role-differentiated display : Color-coded messages USR/PM/SE/Sys C/Sys SE - Monaco editor : VS Code's editor with syntax highlighting - Embedded terminal : xterm.js terminal - File tree browser : Sidebar project navigation - Draggable windows : Freely arrange panels - Internationalization : Chinese/English interface - Multi-level notifications : Silent / Popup / Emergency IM push - Dark theme 7️⃣ Security & Permission Control - Three-tier decision authority : Auto / Ask / Block - IM switch guard : No accidental messages - Message deduplication : Frontend + backend filtering - Auto-backup : Before file modification, backup to .argus/backups/ - Global panic recovery : Goroutine panic protection --- 🚀 Quick Start Download Pre-built Binary Recommended For the quickest experience, download the latest argus-desktop.exe from the Releases https://github.com/ArgusTek/argus/releases page. No build required — just run the exe. Build from Source Prerequisites - Go 1.22+ - Node.js 18+ - Wails CLI : go install github.com/wailsapp/wails/v2/cmd/wails@latest - OS : Windows primary; macOS/Linux builds may work but are untested bash go version go1.22.0+ node --version v18.0.0+ wails doctor should pass all checks build.bat Clone git clone https://github.com/ArgusTek/argus.git cd argus Install frontend deps cd frontend && npm install && cd .. Configure AI API see Configuration section Build frontend cd frontend && npm run build && cd .. Build Go app wails build Run ./build/bin/argus-desktop.exe ⚠️ After modifying frontend code, you must run npm run build first, then wails build . Configure in the app Settings panel, or copy and edit the template: cp config/config.example.json config/config.json { "apiConfigs": { "id": "1", "name": "Qwen Turbo", "provider": "qwen", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "sk-your-api-key-here", "modelName": "qwen-turbo", "isDefault": true } } See config/config.example.json for the full configuration template. Settings → IM Integration, or copy and edit: cp config/dingtalk.example.json config/dingtalk.json { "enabled": true, "clientId": "your-dingtalk-app-client-id", "clientSecret": "your-dingtalk-app-client-secret" } See config/dingtalk.example.json for the full template. | Input Example | Effect | |---|---| Help me write a Hello World | Send to PM default , PM analyzes then assigns to SE for execution | @PM analyze this project's architecture | Explicitly send to PM | @SE fix the bug at line 20 in main.go | Directly ask SE to execute fix task | @AP review the current changes | Request AP to perform independent review | | Shortcut | Action | |---|---| Ctrl+Enter | Send message | Ctrl+L | Clear chat history | Ctrl+S | Save current file | Esc | Stop current task | 👤 User: Create a Go REST API ↓ 🎯 PM: I'll break this down: 1. Create main.go with HTTP server framework 2. Add /health endpoint 3. Add /api/users endpoint @SE please start with task 1 ↓ 💻 SE: Creates main.go, writes HTTP server code @PM Task 1 complete, file created ↓ 🎯 PM: Reviews main.go using read file/exec tools ✓ Passed @SE please continue with task 2 ↓ 💻 SE: Adds /health endpoint @PM Task 2 complete ↓ 🎯 PM: Reviews again ✓ All passed @AP Task verified, please perform final quality approval ↓ 🔍 AP: Independent Code Review + runs compile/test ✅ Project approved ↓ 👤 User: Received completion notification REST API is ready 📁 Project Structure click to expand argus/ ├── main.go Wails application entry point ├── app.go Core business logic & API bindings ├── terminal.go Terminal management ├── http server.go HTTP API server ├── wails.json Wails configuration ├── build.bat One-click build script ├── go.mod / go.sum Go dependencies │ ├── cmd/ CLI tools testing/debugging │ ├── argus/ Main launcher │ ├── pm/ Standalone PM test │ ├── se/ Standalone SE test │ └── test/ Integration tests │ ├── config/ Configuration files │ ├── config.example.json API configuration template │ └── dingtalk.example.json DingTalk configuration template │ ├── internal/ │ ├── ai/ AI client & prompts │ │ ├── client.go OpenAI-compatible API client │ │ ├── pm prompt.go PM system prompt & processor │ │ ├── se prompt.go SE system prompt & processor │ │ ├── se prompt test.go SE prompt tests │ │ └── ap prompt.go AP approval prompt & processor │ ├── chat/ Chat management │ │ ├── manager.go Unified ChatManager PM/SE/AP/C orchestration │ │ ├── router.go @mention message router │ │ ├── sse bridge.go SSE streaming bridge │ │ └── sse bridge test.go SSE bridge tests │ ├── monitor/ Background monitoring │ │ └── c monitor.go C monitor health, git, alerts, handover fallback │ ├── memory/ Memory & context system │ │ ├── manager.go SQLite-backed memory store │ │ ├── compressor.go Context compression │ │ ├── context.go Context builder │ │ ├── session.go Session management │ │ └── working.go Working memory │ ├── executor/ Command executor │ │ └── executor.go Secure command execution with sandboxing │ ├── pm/ PM executor │ │ └── executor.go Task management │ ├── se/ SE executor │ │ └── executor.go Code generation & file operations │ ├── board/ Task board Kanban │ │ └── board.go Board state management │ ├── dingtalk/ DingTalk integration │ │ ├── dingtalk.go Bot client │ │ └── stream.go Stream mode handler │ ├── limiter/ Rate limiting & safety │ │ ├── ratelimit.go API rate limiter │ │ ├── circuit breaker.go Circuit breaker │ │ └── logger.go Request logger │ ├── git/ Git operations │ │ └── git.go Git integration status, diff, commit │ ├── i18n/ Internationalization │ │ └── i18n.go Locale management │ └── types/ Shared type definitions │ └── types.go │ ├── frontend/ Vue 3 frontend │ ├── src/ │ │ ├── App.vue Root component │ │ ├── main.ts Vue entry point │ │ ├── style.css Global styles │ │ ├── components/ UI components │ │ │ ├── ChatPanel.vue Chat interface │ │ │ ├── EditorArea.vue Monaco editor │ │ │ ├── FileTreeWindow.vue File browser │ │ │ ├── TerminalWindow.vue xterm.js terminal │ │ │ ├── GitWindow.vue Git status panel │ │ │ ├── SettingsDialog.vue Settings modal │ │ │ ├── StatusBar.vue Bottom status bar │ │ │ └── ... 22+ components │ │ └── composables/ │ │ └── useDraggable.ts Drag & drop │ ├── wailsjs/ Auto-generated Wails bindings │ ├── package.json │ └── vite.config.ts │ └── build/ Build output gitignored └── bin/ └── argus-desktop.exe Windows only macOS/Linux builds possible but untested Test coverage : low, mostly manual testing Solo project : one maintainer, so response time varies Discussions : https://github.com/ArgusTek/Argus/discussions https://github.com/ArgusTek/Argus/discussions — Q&A, ideas, chat Issues : https://github.com/ArgusTek/Argus/issues https://github.com/ArgusTek/Argus/issues — bug reports, feature requests We welcome all forms of contribution Whether it's code, documentation, bug reports, or feature suggestions. - Fork this repository - Create a feature branch git checkout -b feature/amazing-feature - Commit your changes git commit -m 'Add amazing feature' - Push to the branch git push origin feature/amazing-feature - Create a Pull Request - Check Good First Issue /argustek/Argus/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22 for beginner-friendly tasks - Feel free to open an issue for any bug report or feature request This project is licensed under the MIT License - see the LICENSE /argustek/Argus/blob/main/LICENSE file for details. Built with ❤️ by a solo developer One actor, multiple roles, brilliant performance