{"id":50618837,"url":"https://github.com/projectx667/redbreach-desktop","last_synced_at":"2026-06-06T09:01:07.471Z","repository":{"id":362682347,"uuid":"1259509040","full_name":"projectx667/redbreach-desktop","owner":"projectx667","description":"Advanced AI-powered orchestration platform for offensive security and penetration testing.","archived":false,"fork":false,"pushed_at":"2026-06-05T11:56:20.000Z","size":13226,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T13:19:18.469Z","etag":null,"topics":["ai","ai-agent","ai-assistant","bun","cli","electron","infosec","offensive-security","penetration-testing","pentesting","red-teaming","security","security-audit","solidjs","tui"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/projectx667.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-04T15:21:40.000Z","updated_at":"2026-06-05T11:56:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/projectx667/redbreach-desktop","commit_stats":null,"previous_names":["projectx667/redbreach-desktop"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/projectx667/redbreach-desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectx667%2Fredbreach-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectx667%2Fredbreach-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectx667%2Fredbreach-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectx667%2Fredbreach-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projectx667","download_url":"https://codeload.github.com/projectx667/redbreach-desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectx667%2Fredbreach-desktop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33975476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ai-assistant","bun","cli","electron","infosec","offensive-security","penetration-testing","pentesting","red-teaming","security","security-audit","solidjs","tui"],"created_at":"2026-06-06T09:00:34.579Z","updated_at":"2026-06-06T09:01:07.458Z","avatar_url":"https://github.com/projectx667.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RedBreach\n\n**RedBreach** is an advanced AI agent orchestration platform specifically engineered for offensive security, penetration testing, and deep codebase auditing. This project is a **fork** of the open-source project [OpenCode](https://github.com/anomalyco/opencode), a powerful AI coding agent. RedBreach bridges the gap between conversational AI and system-level execution by fusing a powerful Terminal User Interface (TUI) with a modern Electron-based Desktop Graphical User Interface (GUI).\n\nUnlike standard chat assistants, RedBreach agents have native access to your filesystem, can execute bash commands, analyze binaries, and interact with the Model Context Protocol (MCP) to automate complex security workflows.\n\n## Key Differentiators and Optimizations from OpenCode\n\nRedBreach distinguishes itself from OpenCode through several fundamental aspects, tailored to the needs of offensive security professionals:\n\n-   **Offensive Security Specialization**: While OpenCode serves as a general-purpose AI coding agent, RedBreach is explicitly designed for red teaming, penetration testing, and vulnerability research. This specialization is reflected in custom agent behaviors and prompts (such as the `beast.txt` prompt) that authorize the generation of exploit code and the execution of security tasks without disclaimers.\n-   **Dedicated Desktop Graphical User Interface (GUI)**: RedBreach integrates a custom Electron-based desktop application (`packages/desktop-electron`). This GUI provides an enhanced user experience for visualizing file trees, managing sessions, and reviewing logs, which is critical for complex security operations.\n-   **Branding and Ecosystem Clarity**: The project is officially named **RedBreach**. While it maintains full technical compatibility with the OpenCode foundations, it is organized as a standalone suite of tools tailored for offensive security professionals. All internal logic and user interfaces are branded under the RedBreach identity to provide a cohesive experience.\n-   **Extended Tools and Capabilities**: RedBreach leverages OpenCode's robust agent architecture but extends it with security-specific tools and capabilities. This enables agents to perform advanced tasks such as vulnerability analysis, custom exploit development, reverse shell generation, and privilege escalation.\n\n## Core Capabilities\n\nThe engine powers multiple specialized tools:\n\n-   **Code Analysis \u0026 LSP**: Native Language Server Protocol integration for deep, context-aware project understanding.\n-   **Secure Bash Execution**: Agents can execute commands, audit configurations, and manipulate files directly through the integrated terminal.\n-   **Extensible Architecture**: Full support for local and remote **MCP (Model Context Protocol)** servers, plus a robust Plugin SDK.\n-   **Multi-Provider Support**: Seamlessly switch between Claude (Anthropic), GPT (OpenAI), Gemini (Google), Copilot, and local models.\n\n## Agent Modes\n\nRedBreach offers distinct agent behaviors tailored to the phase of your engagement:\n\n-   **Build Mode**: The primary active agent with write permissions. Used for remediation, crafting exploit scripts, or modifying code.\n-   **Plan Mode**: A read-only (sandboxed) agent dedicated to exploration, vulnerability auditing, and planning without the risk of accidental modifications.\n-   **Explore Mode**: A fast, specialized subagent for rapid codebase traversal, pattern matching (Glob/Grep), and structural discovery.\n-   **General Mode**: A versatile subagent for researching complex questions and executing parallel multi-step tasks.\n\n## Architecture\n\nBuilt as a modern monorepo using **Bun** and **Turbo**:\n\n-   `packages/redbreach`: The logical core, agent server, and session engine.\n-   `packages/desktop-electron`: The modern Electron-based GUI for managing sessions and visualizing workflows.\n-   `packages/sdk` \u0026 `packages/plugin`: Development interfaces for extending the platform's capabilities.\n-   `packages/core`: Low-level utilities, filesystem abstractions, and process management.\n-   `packages/ui`: Shared UI components used across the RedBreach ecosystem.\n\n## Installation\n\nClone and build the complete environment locally using [Bun](https://bun.sh):\n\n```bash\ngit clone https://github.com/projectx667/redbreach-desktop.git\ncd redbreach-desktop\nbun install\nbun run dev:desktop\n```\n\n*For CLI usage only, you can run:*\n```bash\nbun run --cwd packages/redbreach --conditions=browser src/index.ts\n```\n\n## Configuration\n\nRedBreach is highly configurable via environment variables or a local `.env` file.\n\nCopy `.env.example` to `.env` to customize your setup:\n\n```bash\ncp .env.example .env\n```\n\nKey configurations include setting the release channel, securing the embedded server endpoint, and configuring telemetry (Sentry/OpenTelemetry).\n\n---\n\n## Custom Files Protected Against Conflicts\n\nThe following files are customized for RedBreach and will likely cause conflicts during an upstream merge from OpenCode. These conflicts must be resolved manually to preserve RedBreach-specific functionalities and configurations.\n\n| File | Reason |\n|---|---|\n| `packages/redbreach/src/session/prompt/beast.txt` | Custom offensive prompt |\n| `packages/redbreach/src/session/prompt/*.txt` | All RedBreach prompts |\n| `packages/redbreach/src/session/system.ts` | Beast prompt selection logic |\n| `packages/redbreach/package.json` | Auth dependencies remain OpenCode (opencode-*) |\n\n## Validation Criteria for Upstream Synchronization\n\nTo ensure a successful and stable synchronization with the upstream OpenCode repository, the following criteria must be met after each merge:\n\n- `git remote -v` should display `upstream https://github.com/sst/opencode.git`.\n- The GitHub Action (`.github/workflows/upstream-sync.yml`) should run as scheduled and automatically open a Pull Request when a new upstream tag is detected.\n- A `bun install` command should execute without errors after the merge.\n- The custom RedBreach prompts must remain intact and functional after the merge.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectx667%2Fredbreach-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojectx667%2Fredbreach-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectx667%2Fredbreach-desktop/lists"}