How herra-atlas/project-m works
Project M is a visual Windows macro-authoring and automation app. Users create or import a node graph, save it as a per-macro folder, then run it; the Rust engine dispatches graph nodes that drive keyboard, mouse, pixel, script, and IPC actions. A parallel AI workflow chats with an OpenAI-compatible model and turns proposed changes into confirmation-gated macro actions. The README documents storage, force-stop, and auto-update capabilities; some backend command wiring and UI details were not fully excerpted, so uncertain links are omitted or marked unverified.
Main entry points: App.tsx App shell · main.rs Tauri commands · CreateWithAiModal.tsx AI chat and approvals · EditorPage.tsx Graph editor
Components 20
Macro authoring
- App shell
src/App.tsx - Graph editor
src/components/editor/EditorPage.tsx - Node canvas
src/components/editor/EditorCanvas.tsx - Node rendering
src/components/editor/Node.tsx - Node palette
src/components/editor/NodePalette.tsx
AI assistant
- AI chat and approvals
src/components/CreateWithAiModal.tsx - Fence parser
src/components/ai/protocol.ts
Macro runtime
- Macro graph data
src-tauri/src/macro_data.rs - Graph engine
src-tauri/src/engine.rs - Node dispatcher
src-tauri/src/nodes/mod.rs - Input and vision
src-tauri/src/input.rs - Script and IPC nodes
src-tauri/src/nodes
Storage and integrations
- Tauri commands
src-tauri/src/main.rs - Macro folders
src-tauri/src/macros_fs.rs - AHK IPC
src-tauri/src/ahk_ipc.rs - Runtime logs
src/components/LogsPanel.tsx - Update client
src/components/useUpdater.ts
Other components
- User
- Chat model
- GitHub Releases
Connections 24
- User → App shell: uses
README.md - App shell → Graph editor: mounts
src/App.tsx - Graph editor → Node canvas: renders
src/components/editor/EditorPage.tsx - Node canvas → Node rendering: renders
src/components/editor/EditorCanvas.tsx - Graph editor → Node palette: renders
src/components/editor/EditorPage.tsx - User → AI chat and approvals: describes macro
README.md - AI chat and approvals → Chat model: streams chat
src/components/CreateWithAiModal.tsx - AI chat and approvals → Fence parser: parses fences
src/components/CreateWithAiModal.tsx - AI chat and approvals → Tauri commands: invokes commands
src/components/CreateWithAiModal.tsx - Chat model → AI chat and approvals: returns draft
README.md - Graph editor → Tauri commands: runs macro
- App shell → Tauri commands: invokes commands
src/App.tsx - Tauri commands → Graph engine: starts and stops
src-tauri/src/main.rs - Tauri commands → Macro folders: manages macro files
src-tauri/src/main.rs - Graph engine → Macro graph data: loads graph
src-tauri/src/engine.rs - Graph engine → Node dispatcher: dispatches nodes
src-tauri/src/engine.rs - Node dispatcher → Input and vision: performs input and scans
src-tauri/src/nodes/mouse_drag.rs - Node dispatcher → Script and IPC nodes: routes node types
src-tauri/src/nodes/mod.rs - Script and IPC nodes → AHK IPC: sends IPC
- User → App shell: requests force stop
README.md - App shell → Tauri commands: requests stop
src/App.tsx - App shell → Runtime logs: opens runtime logs
src/App.tsx - App shell → Update client: checks updates
README.md - Update client → GitHub Releases: checks releases
README.md