Loading repository data…
patil-shubham-dev / repository
An open-source, self-hostable AI operating system and development workspace. Powered by Electron and React 19, it features multi-agent orchestration, full Model Context Protocol (MCP) support, native filesystem access, and an extensible tool ecosystem for autonomous software development.
Your AI operating system for development — a desktop coding assistant with multi-agent orchestration, browser automation, terminal integration, and deep code intelligence.
git clone https://github.com/agenticos/agenticos.git
cd agenticos
npm install
npm run dev
npm run cli -- --print "Explain the event system"
echo "Hello" | npm run cli -- --stdin
npm run cli -- --file prompt.txt --json
| Metric | Count |
|---|---|
Source files (src/) | ~350 |
Test files (tests/) | ~100 across 31 categories |
| Runtime subdirectories | 34 (too many — needs regrouping) |
| Stores (Zustand) | 28 files |
| Lib root files | 53 files + 11 subdirectories (mixed) |
| Workspace components | 29 files in flat directory |
| Vibecoder docs | 26 files in flat directory |
| Top-level config files | 17 files |
| Size | File |
|---|---|
| 58.7 KB | components/workspace/code-workspace.tsx |
| 52.8 KB | pages/install-wizard.tsx |
| 50.6 KB | components/workspace/explorer/WorkspaceExplorer.tsx |
| 49.2 KB | runtime/ExecutionSessionManager.ts |
| 47.5 KB | pages/code-canvas.tsx |
heap-iter-*.heapsnapshot) — should be gitignored or deleted.runtime/ should be grouped into domains (engine, communication, governance, lifecycle, etc.).lib/ has 53 root files alongside 11 subdirectories; domain files like git.ts coexist with git/WorktreeSandbox.ts.config/ directory.code-workspace.tsx (58.7 KB) should be split.tsx extension listed twice in electron-builder.config.cjs fileAssociations.electron-builder.config.cjs uses CommonJS while the rest of the project is ESM ("type": "module").src/
├── main/ # Electron main process (IPC, window management, services)
├── preload/ # Context bridge (preload script)
└── renderer/ # React application
├── core/ # Kernel, routing, error boundaries
├── components/ # UI components organized by domain
├── pages/ # Route pages
├── runtime/ # AI execution engine (agents, tools, memory, context, streaming)
├── stores/ # Zustand state stores (28 stores)
├── lib/ # Utilities and services
└── types/ # TypeScript type definitions
packages/
├── providers/ # Provider transport layer
├── shared/ # Shared types and utilities
└── ui/ # Shared UI components
tests/ # 880+ tests across 31 categories
User Input → RuntimeOS → AgentExecutor → Tools → File System / Browser / Terminal
↓ ↓
ExecutionSessionManager ← ExecutionEvent protocol
↓
StreamManager → TimelineStore → React UI
| Category | Technology |
|---|---|
| Desktop | Electron 42 |
| UI | React 19, Tailwind CSS 4, Radix UI, Framer Motion |
| Language | TypeScript 6 (strict mode) |
| State | Zustand |
| Editor | Monaco Editor |
| Terminal | xterm.js + node-pty |
| Browser | Playwright Core (CDP) |
| Testing | Vitest 3 |
| Build | Vite 6 + electron-vite + electron-builder |
| AI | Multi-provider (OpenAI, Anthropic, MCP) |
| Command | Description |
|---|---|
npm run dev | Development mode with hot reload |
npm run build | TypeScript check + production build |
npm test | Run all tests (vitest) |
npm run typecheck | TypeScript strict type checking |
npm run lint | ESLint code quality |
npm run dist | Build distribution packages |
npm run cli | Headless CLI mode |
880+ passing tests across 68 test files.
npm test # Full suite
npx vitest run tests/agent-system # Agent tests
npx vitest run tests/reliability # Reliability tests
npx vitest run tests/browser # Browser tests
npx vitest run tests/memory # Memory tests
| Operation | p50 | p95 | p99 |
|---|---|---|---|
| Search (1k files) | 0.4ms | 5.1ms | 17.3ms |
| Search (10k files) | 2.7ms | 10.7ms | 83.5ms |
| Search (50k files) | 7.3ms | 22.9ms | 30.6ms |
Production Readiness Score: 82%
| Category | Score |
|---|---|
| Agent System | 93% |
| Reliability | 90% |
| Architecture | 85% |
| Code Intelligence | 85% |
| UX | 86% |
| Security | 60% |
| Scalability | 62% |
See CONTRIBUTING.md for guidelines on code of conduct, development workflow, commit conventions, and pull request process.
MIT — see LICENSE.
Built with Electron, React, TypeScript, and the open-source community.
Selected from shared topics, language and repository description—not editorial ratings.
clawboo /
An open-source studio for teams of AI agents, from marketing squads to dev teams to research crews. Deploy a team, then watch them delegate and collaborate live. Self-hosted, one command.