# Argus: Open-source AI coding assistant with built-in code review > Source: > Published: 2026-06-14 15:56:12+00:00 **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*