$npx -y skills add omnigentx/jarvis --skill jarvis-knowledgeKnowledge base for the Jarvis AI Assistant codebase. Use when understanding project structure, finding files to modify, or adding new features.
| 1 | # Jarvis Codebase Knowledge |
| 2 | |
| 3 | ## GitHub Repositories |
| 4 | |
| 5 | | Repo | URL | Access | |
| 6 | |------|-----|--------| |
| 7 | | **Upstream** (source of truth) | https://github.com/omnigentx/jarvis | Public read-only | |
| 8 | | **Your fork** (agents push here) | https://github.com/<your-username>/jarvis | Full access — commit, push, create PR | |
| 9 | |
| 10 | > 🧪 **Experimental**: Agents push to your personal fork for self-improvement, never to upstream. |
| 11 | |
| 12 | ## High-Level Architecture |
| 13 | |
| 14 | ``` |
| 15 | jarvis/ |
| 16 | ├── backend/ ← FastAPI + fast-agent (Python 3.11+) |
| 17 | │ ├── server.py ← Entry point |
| 18 | │ ├── agent.py ← Agent definitions |
| 19 | │ ├── routes/ ← API endpoints |
| 20 | │ ├── services/ ← Business logic |
| 21 | │ ├── core/ ← Infrastructure (DB, auth, logging) |
| 22 | │ ├── tools/ ← Custom MCP tool servers |
| 23 | │ ├── fast-agent/ ← Framework submodule (spawn system) |
| 24 | │ ├── team_templates/ ← Team definitions (agile_team.yaml) |
| 25 | │ └── .fast-agent/ ← Skills, agent cards, sessions |
| 26 | ├── frontend/ ← Vue 3 + Vite + Tailwind v4 |
| 27 | └── .github/workflows/ ← CI/CD |
| 28 | ``` |
| 29 | |
| 30 | ## Key Patterns |
| 31 | |
| 32 | | Pattern | Location | Description | |
| 33 | |---------|----------|-------------| |
| 34 | | Static agents | `agent.py` | Jarvis, PersonalAgent, IoTAgent, etc. | |
| 35 | | Dynamic agents | `.fast-agent/agent_cards/*.md` | Hot-reload at startup | |
| 36 | | Team agents | `team_templates/agile_team.yaml` | Spawned at runtime | |
| 37 | | Inter-agent email | `message_bus.py` + `email_server.py` | Async messaging | |
| 38 | | Meetings | `meeting_room_server.py` | Real-time turn-taking | |
| 39 | | SSE pipeline | spawn events → bridge → SSE/SQLite | Real-time UI updates | |
| 40 | |
| 41 | ## Tech Stack |
| 42 | |
| 43 | - **Backend**: Python, FastAPI, fast-agent, SQLAlchemy, SQLite |
| 44 | - **Dashboard**: Vue 3, Vite, Tailwind v4, Pinia |
| 45 | - **Deploy**: Docker Compose, GitHub Actions CI/CD |
| 46 | - **LLM**: OpenAI-compatible via CLIProxyAPI (key rotation + load balancing) |
| 47 | |
| 48 | ## References |
| 49 | |
| 50 | | Topic | File | |
| 51 | |-------|------| |
| 52 | | Full project tree + spawn architecture | [DETAILED_STRUCTURE.md](references/DETAILED_STRUCTURE.md) | |