How roopesh-kosuri/code-os works
CODE-OS is a local-first Electron AI IDE backed by a FastAPI service. The main user journey is to open a workspace, ask an AI agent to work on it, inspect proposed changes, approve mutations, and review verification results. Its documented capabilities also include multi-agent planning, Duo escalation, terminal execution, security scanning, semantic search, Git, and pipeline generation. The graph combines README-described behavior with relationships visible in sampled excerpts and the source index; several feature links are therefore documented rather than verified call paths.
Main entry points: team_routes.py Team workflow API · App.tsx Application shell · chat_harness.py Rony chat harness · TeamConsole.tsx Agent Console
Components 22
Desktop experience
- Application shell
src/App.tsx - IDE workspace
src/components/layout/AppShell.tsx - AI and workspace state
src/stores/aiStore.ts - Typed API client
src/lib/api.ts
AI agent workflows
- Rony chat harness
backend/app/features/ai/chat_harness.py - Agent Console
src/features/ai/console/TeamConsole.tsx - Team workflow API
backend/app/features/ai/team/team_routes.py - DAG executor
backend/app/features/ai/dag_engine.py - Job state
backend/app/features/ai/job_service.py - Guarded mutations
backend/app/features/ai/harness/mutation_pipeline.py - Change review
backend/app/features/ai/staging/staging_review_service.py
Workspace tools
- Workspace management
backend/app/features/workspaces/service.py - Terminal execution
backend/app/features/terminal/service.py - Code security scanner
backend/app/features/ai/security/scanner_service.py - Semantic retrieval
backend/app/features/ai/rag/vector_index_service.py - Repository indexing
backend/app/features/indexing/service.py - Git integration
backend/app/features/git/service.py - CI/CD generator
backend/app/features/ai/cicd/yaml_generator.py
Backend services
- Backend application
backend/app/main.py
External integrations
- AI providers
backend/app/features/ai/providers - Selected AI provider
Other components
- Developer
Connections 24
- Developer → Application shell: uses
README.md - Application shell → IDE workspace: renders
src/App.tsx - IDE workspace → Agent Console: presents
src/components/layout/AppShell.tsx - Application shell → AI and workspace state: initializes
src/App.tsx - AI and workspace state → Typed API client: requests
src/stores/aiStore.ts - Typed API client → Backend application: sends HTTP
src/lib/api.ts - Backend application → Workspace management: mounts routes
backend/app/main.py - Developer → Rony chat harness: asks for code
README.md - Rony chat harness → Guarded mutations: proposes guarded edits
- Guarded mutations → Change review: stages changes
backend/app/features/ai/staging/staging_review_service.py - Developer → Agent Console: starts team task
README.md - Agent Console → Team workflow API: submits workflow
- Team workflow API → Job state: creates job
backend/app/features/ai/team/team_routes.py - Team workflow API → DAG executor: orchestrates workflow
backend/app/features/ai/team/team_routes.py - DAG executor → Job state: updates status
backend/app/features/ai/dag_engine.py - Rony chat harness → AI providers: requests inference
- Team workflow API → AI providers: runs agents
- AI providers → Selected AI provider: calls model
- Developer → Terminal execution: runs commands
README.md - Developer → Code security scanner: requests scan
README.md - Developer → Semantic retrieval: searches code
README.md - Developer → Repository indexing: opens repository
- Developer → Git integration: uses Git
README.md - Developer → CI/CD generator: generates pipeline
README.md