{
  "markdown": "# Sensei 🥋\n\n### The AI Cyber Mentor for Hackers\n\n**Sensei** is a CLI tool powered by Google Gemini, designed to assist penetration testers, CTF players, and cybersecurity students directly from their terminal.\n\n## 🌟 Features\n\n- **Context Aware:** Understands standard tools (Nmap, Metasploit, Burp).\n- **Stealth & Ethics:** Warns about OpSec failures.\n- **Terminal Beauty:** Rich markdown rendering.\n- **Project Agnostic:** Works on any Linux distro (Kali, Blackfin, Ubuntu).\n\n## 🚀 Installation\n\n```bash\ngit clone https://github.com/mjcc30/sensei.git\ncd sensei\nuv sync\nuv run main.py ask how do I scan for SMB vulnerabilities?\n```\n\n## 🤖 Usage\n\nSet your API Key once:\n\n```bash\nexport GEMINI_API_KEY=\"your_key_here\"\n```\n\n**Quick Question:**\n\n```bash\n# No quotes needed!\nuv run main.py ask how do I use nmap stealthily?\n```\n\n**Interactive Mode:**\n\n```bash\nuv run app/main.py chat\n```\n\n## 🔌 MCP Integration (Model Context Protocol)\n\nSensei exposes its tools (like Nmap) via a standard MCP Server. This allows other AI assistants (Claude Desktop, Gemini Advanced) to use Sensei's capabilities.\n\n**Run the Server:**\n\n```bash\nuv run app/server.py\n```\n\n_(This starts a stdio JSON-RPC server)_\n\n**Claude Desktop Configuration:**\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"sensei\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"/path/to/sensei/app/server.py\"]\n    }\n  }\n}\n```\n\n## ⚙️ Configuration & Customization\n\nSensei uses a default persona (\"Helpful Mentor\"). You can customize or override these prompts (e.g., for specialized research or Red Teaming) by creating a `prompts.yaml` file.\n\n1.  Copy the example:\n    ```bash\n    cp prompts.example.yaml prompts.yaml\n    ```\n2.  Edit `prompts.yaml` to define your own System Prompts for each agent (Novice, Researcher, Master).\n3.  **Note:** `prompts.yaml` is ignored by Git to protect your custom methodology or sensitive instructions.\n\n## 🔬 Architecture (v2 - The Swarm)\n\nSensei uses a **Multi-Agent Orchestrator**:\n\n1.  **Router:** Analyzes your query (Simple vs Complex).\n2.  **Specialists:** Delegates to the best agent (Novice, Researcher, or Master).\n3.  **A2A Bus:** Asynchronous internal communication.\n",
  "bytes": 2198,
  "sha": "aec199e268cafa731049e69914bb1d5f3cdaf028e4e0fc22d1c9ba8fa91c5b31",
  "repo_slug": "mjcc30/sensei",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mjcc30_sensei_ffa399d2/readme"
}