# mdiri-ai/soduwork

> SoduWork is an AI-native engine for teams and their agents, where a request ends when the person who asked signs off. Teams self-host it and use a web admin console, a desktop client and a central Hub to assign work to AI agents and review what they deliver. The core idea is that an agent does the work, a separate AI review checks it against acceptance criteria, and the requester approves the result. Its primary language is JavaScript, with Python on the server side.

Source: https://github.com/mdiri-ai/soduwork
Indexed: commit 62fc760 on 2026-11-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: JavaScript
- Stars: 6,671 at index time
- License: MIT
- Code health: 7.6/10, Good
- Last commit: 2026-11-20
- Contributors: 51

## How it works

Work enters through the desktop client in the client directory, whose Electron main process in client/main.js handles accounts, agent sessions, plugins and files behind the app window. The server in hub-backend/app/main.py is the Hub, and the hub-backend module decides which Runner or local agent carries out each task. A Runner connects to the Hub over a WebSocket, gives each dispatch an ID so the same task is never taken twice, and runs each harness in its own subprocess. The hub-frontend directory holds the web admin console, where administrators manage organizations, accounts, models and plugins. The tools directory holds the scripts that start SoduWork from a source checkout, and start.py at the root is the entry point for local use.

- client/app/app.js: entry point
- client/examples/jiyong-notes/app.js: entry point
- client/examples/jiyong-robot/app.js: entry point
- client/main.js: entry point
- hub-backend/app/main.py: entry point
Modules: client, hub-backend, hub-frontend, tools, skills, ops, root. 4,487 files, 716,595 lines, 35,360 symbols.

## Code health

- Score: 7.6/10 (Good)
- Trend: 7.6 on 2026-11-19, 7.6 on 2026-11-20
- Rank: #103 of 4,000+ indexed repos
- Hotspots: client/main/conversation/account-sync.js, client/api.js, hub-backend/quality_manifest.py, client/components/workspace/workspace-chat-list.js, client/components/panels/panels-models.js
- Lowest file: client/components/workspace/workspace-sidebar-state.js
- Dead code: 222 findings

## Maintenance

- Last commit 2026-11-20, first commit 2026-10-29, 632 commits
- 51 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/mdiri-ai/soduwork/security

## More

- Page: https://repowise.dev/repo/mdiri-ai/soduwork
- Ask this codebase: https://repowise.dev/repo/mdiri-ai/soduwork/chat
- Docs: https://repowise.dev/repo/mdiri-ai/soduwork/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/mdiri-ai/soduwork
