@j3ssie/osmedeus 5.1.0-darwin-arm64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2020 j3ssie
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
22
+
package/README.md ADDED
@@ -0,0 +1,228 @@
1
+ # Osmedeus
2
+
3
+ <p align="center">
4
+ <a href="https://www.osmedeus.org"><img alt="Osmedeus" src="https://raw.githubusercontent.com/osmedeus/assets/main/osm-logo-with-white-border.png" height="140" /></a>
5
+ <br />
6
+ <strong>Osmedeus - A Modern Orchestration Engine for Security</strong>
7
+
8
+ <p align="center">
9
+ <a href="https://docs.osmedeus.org/"><img src="https://img.shields.io/badge/Documentation-0078D4?style=for-the-badge&logo=GitBook&logoColor=39ff14&labelColor=black&color=black"></a>
10
+ <a href="https://docs.osmedeus.org/donation/"><img src="https://img.shields.io/badge/Sponsors-0078D4?style=for-the-badge&logo=GitHub-Sponsors&logoColor=39ff14&labelColor=black&color=black"></a>
11
+ <a href="https://twitter.com/OsmedeusEngine"><img src="https://img.shields.io/badge/%40OsmedeusEngine-0078D4?style=for-the-badge&logo=Twitter&logoColor=39ff14&labelColor=black&color=black"></a>
12
+ <a href="https://discord.gg/mtQG2FQsYA"><img src="https://img.shields.io/badge/Discord%20Server-0078D4?style=for-the-badge&logo=Discord&logoColor=39ff14&labelColor=black&color=black"></a>
13
+ <a href="https://github.com/j3ssie/osmedeus/releases"><img src="https://img.shields.io/github/release/j3ssie/osmedeus?style=for-the-badge&labelColor=black&color=2fc414&logo=Github"></a>
14
+ </p>
15
+ </p>
16
+
17
+ ## What is Osmedeus?
18
+
19
+ [Osmedeus](https://www.osmedeus.org) is a security focused declarative orchestration engine that simplifies complex workflow automation into auditable YAML definitions, complete with encrypted data handling, secure credential management, and sandboxed execution.
20
+
21
+ Built for both beginners and experts, it delivers powerful, composable automation without sacrificing the integrity and safety of your infrastructure.
22
+
23
+ ## Key Features
24
+
25
+ - **Declarative YAML Workflows** - Define pipelines with hooks, decision routing, module exclusion, and conditional branching across multiple runners (host, Docker, SSH)
26
+ - **Distributed Execution** - Redis-based master-worker pattern with queue system, webhook triggers, and file sync across workers
27
+ - **Rich Function Library** - 80+ utility functions including nmap integration, tmux sessions, SSH execution, TypeScript/Python scripting, SARIF parsing, and CDN/WAF classification
28
+ - **Event-Driven Scheduling** - Cron, file-watch, and event triggers with filtering, deduplication, and delayed task queues
29
+ - **Agentic LLM Steps** - Tool-calling agent loops with sub-agent orchestration, memory management, and structured output; plus ACP subprocess agents (Claude Code, Codex, OpenCode, Gemini)
30
+ - **Cloud Infrastructure** - Provision and run scans across DigitalOcean, AWS, GCP, Linode, and Azure with cost controls and automatic cleanup
31
+ - **Rich CLI Interface** - Interactive database queries, bulk function evaluation, workflow linting, progress bars, and comprehensive usage examples
32
+ - **REST API & Web UI** - Full API server with webhook triggers, database queries, and embedded dashboard for visualization
33
+
34
+ See [Documentation Page](https://docs.osmedeus.org/) for more details.
35
+
36
+ ## Installation
37
+
38
+ ```bash
39
+ curl -sSL http://www.osmedeus.org/install.sh | bash
40
+ ```
41
+
42
+ ### [npm](https://www.npmjs.com/package/@j3ssie/osmedeus)
43
+
44
+ ```bash
45
+ npm install -g @j3ssie/osmedeus
46
+ ```
47
+
48
+ Ships prebuilt binaries for linux and macOS on x64/arm64.
49
+
50
+ See [Quickstart](https://docs.osmedeus.org/quickstart/) for quick setup and [Installation](https://docs.osmedeus.org/installation/) for advanced configurations.
51
+
52
+ | CLI Usage | Web UI Assets |
53
+ |-----------|---------------|
54
+ | ![CLI Usage](https://github.com/osmedeus/docs/blob/main/images/cli/cli-run-with-verbose-output.png?raw=true) | ![Web UI Assets](https://github.com/osmedeus/docs/blob/main/images/web-ui/web-ui-assets.png?raw=true) |
55
+ | **Workflow Visualization** | **Vulnerabilities** |
56
+ | ![Workflow Visualization](https://github.com/osmedeus/docs/blob/main/images/web-ui/web-ui-workflow.png?raw=true) | ![Vulnerabilities](https://github.com/osmedeus/docs/blob/main/images/web-ui/web-ui-vuln.png?raw=true) |
57
+
58
+
59
+ ## ☁️ Sponsor — Bloome
60
+
61
+ [![Bloome — humans and AI agents, working as one team](assets/bloome-home.png)](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
62
+
63
+ Automating recon with Osmedeus? [Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607) brings that same team-of-agents mindset to the rest of your workflow: multiple AI agents (Claude, ChatGPT, DeepSeek and more) in one shared chat that split the work, hand off tasks, cross-check each other, and refine the output until it's right — triage findings, draft reports, and run scheduled checks together. Zero setup, in the cloud, on web and mobile, and shareable with your team. 👉 [Try Bloome](https://bloome.im/app?ref=j3ssie&utm_medium=github&utm_source=j3ssie-osmedeus-ivor-202607)
64
+
65
+
66
+ ## Quick Start
67
+
68
+ ```bash
69
+ # Run a module workflow
70
+ osmedeus run -m recon -t example.com
71
+
72
+ # Run a flow workflow
73
+ osmedeus run -f general -t example.com
74
+
75
+ # Multiple targets with concurrency
76
+ osmedeus run -m recon -T targets.txt -c 5
77
+
78
+ # Dry-run mode (preview)
79
+ osmedeus run -f general -t example.com --dry-run
80
+
81
+ # Start API server
82
+ osmedeus serve
83
+
84
+ # List available workflows
85
+ osmedeus workflow list
86
+
87
+ # Query discovered assets
88
+ osmedeus assets -w example.com # List assets for workspace
89
+ osmedeus assets --stats # Show unique technologies, sources, types
90
+ osmedeus assets --source httpx --type web --json # Filter and output as JSON
91
+
92
+ # Query vulnerabilities, runs, and steps
93
+ osmedeus query vulns --severity high --workspace example.com
94
+ osmedeus query runs --status running
95
+ osmedeus query steps --run <run-uuid>
96
+
97
+ # Query database tables
98
+ osmedeus db list --table runs
99
+ osmedeus db list --table event_logs --search "nuclei"
100
+
101
+ # Evaluate utility functions
102
+ osmedeus func eval 'log_info("hello")'
103
+ osmedeus func eval -e 'http_get("https://example.com")' -T targets.txt -c 10
104
+
105
+ # Platform variables available in eval
106
+ osmedeus func eval 'log_info("OS: " + PlatformOS + ", Arch: " + PlatformArch)'
107
+
108
+ # Install from preset repositories
109
+ osmedeus install base --preset
110
+ osmedeus install base --preset --keep-setting # preserve existing osm-settings.yaml
111
+ osmedeus install workflow --preset
112
+
113
+ # Exclude modules from flow execution
114
+ osmedeus run -f general -t example.com -x portscan
115
+ osmedeus run -f general -t example.com -X vuln # Fuzzy exclude by substring
116
+
117
+ # Worker queue system
118
+ osmedeus worker queue new -f general -t example.com # Queue for later
119
+ osmedeus worker queue run --concurrency 5 # Process queue
120
+
121
+ # Worker management
122
+ osmedeus worker status # Show workers
123
+ osmedeus worker eval -e 'ssh_exec("host", "whoami")' # Eval with distributed hooks
124
+
125
+ # Run an ACP agent interactively
126
+ osmedeus agent "analyze this codebase"
127
+ osmedeus agent --agent codex "explain main.go"
128
+ osmedeus agent --list
129
+
130
+ # Cloud infrastructure management
131
+ osmedeus cloud create --instances 3 # Provision cloud machines
132
+ osmedeus cloud setup 1.2.3.4 5.6.7.8 # Setup existing machines
133
+ osmedeus cloud list # List active infrastructure
134
+ osmedeus cloud run -f general -t example.com --instances 3
135
+
136
+ # Show all usage examples
137
+ osmedeus --usage-example
138
+ ```
139
+
140
+ ## Docker
141
+
142
+ ```bash
143
+ # Show help
144
+ docker run --rm j3ssie/osmedeus:latest --help
145
+
146
+ # Run a scan
147
+ docker run --rm -v $(pwd)/output:/root/workspaces-osmedeus \
148
+ j3ssie/osmedeus:latest run -f general -t example.com
149
+ ```
150
+
151
+ For more CLI usage and example commands, refer to the [CLI Reference](https://docs.osmedeus.org/getting-started/cli).
152
+
153
+ ## High-Level Architecture
154
+
155
+ ```plaintext
156
+ ┌───────────────────────────────────────────────────────────────────────────┐
157
+ │ Osmedeus Orchestration Engine │
158
+ ├───────────────────────────────────────────────────────────────────────────┤
159
+ │ ENTRY POINTS │
160
+ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │
161
+ │ │ CLI │ │ REST API │ │Scheduler │ │ Distributed │ │
162
+ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬───────┘ │
163
+ │ └─────────────┴─────────────┴──────────────┘ │
164
+ │ │ │
165
+ │ ▼ │
166
+ │ ┌─────────────────────────────────────────────────────────────────────┐ │
167
+ │ │ CONFIG ──▶ PARSER ──▶ EXECUTOR ──▶ STEP DISPATCHER ──▶ RUNNER │ │
168
+ │ │ │ │ │
169
+ │ │ Step Executors: bash | function | parallel | foreach | remote-bash │ │
170
+ │ │ http | llm | agent | agent-acp | SARIF/SAST │ │
171
+ │ │ Hooks: pre_scan_steps → [main steps] → post_scan_steps │ │
172
+ │ │ │ │ │
173
+ │ │ Runners: HostRunner | DockerRunner | SSHRunner │ │
174
+ │ │ Queue: DB + Redis polling → dedup → concurrent execution │ │
175
+ │ └─────────────────────────────────────────────────────────────────────┘ │
176
+ └───────────────────────────────────────────────────────────────────────────┘
177
+ ```
178
+
179
+ For more information about the architecture, refer to the [Architecture Documentation](https://docs.osmedeus.org/architecture).
180
+
181
+ ## Roadmap and Status
182
+
183
+ The high-level ambitious plan for the project, in order:
184
+
185
+ | # | Step | Status |
186
+ | :-: | --------------------------------------------------------------------------- | :----: |
187
+ | 1 | Osmedeus Engine reforged with a next-generation architecture | ✅ |
188
+ | 2 | Flexible workflows and step types | ✅ |
189
+ | 3 | Event-driven architectural model and the different trigger event categories | ✅ |
190
+ | 4 | Beautiful UI for visualize results and workflow diagram | ✅ |
191
+ | 5 | Rewriting the workflow to adapt to new architecture and syntax | ✅ |
192
+ | 6 | Testing more utility functions like notifications | ✅ |
193
+ | 7 | SAST integration with SARIF parsing (Semgrep, Trivy, etc.) | ✅ |
194
+ | 8 | Cloud integration, which supports running the scan on the cloud provider. | ✅ |
195
+ | 9 | Generate diff reports showing new/removed/unchanged assets between runs. | ❌ |
196
+ | 10 | Adding step type from cloud provider that can be run via serverless | ❌ |
197
+ | N | Fancy features (to be discussed later) | ❌ |
198
+ ## Documentation
199
+
200
+ | Topic | Link |
201
+ |----------------------|----------------------------------------------------------------------------------------------------------|
202
+ | Getting Started | [docs.osmedeus.org/getting-started](https://docs.osmedeus.org/getting-started) |
203
+ | CLI Usage & Examples | [docs.osmedeus.org/getting-started/cli](https://docs.osmedeus.org/getting-started/cli) |
204
+ | Writing Workflows | [docs.osmedeus.org/workflows/overview](https://docs.osmedeus.org/workflows/overview) |
205
+ | Event-Driven Triggers| [docs.osmedeus.org/advanced/event-driven](https://docs.osmedeus.org/advanced/event-driven) |
206
+ | Deployment | [docs.osmedeus.org/deployment](https://docs.osmedeus.org/deployment) |
207
+ | Architecture | [docs.osmedeus.org/concepts/architecture](https://docs.osmedeus.org/concepts/architecture) |
208
+ | Development | [docs.osmedeus.org/development](https://docs.osmedeus.org/development) and [HACKING.md](HACKING.md) |
209
+ | Extending Osmedeus | [docs.osmedeus.org/development/extending-osmedeus](https://docs.osmedeus.org/development/extending-osmedeus) |
210
+ | Security Model | [SECURITY.md](SECURITY.md) and [docs.osmedeus.org/others/security-warning](https://docs.osmedeus.org/others/security-warning) |
211
+ | Full Documentation | [docs.osmedeus.org](https://docs.osmedeus.org) |
212
+
213
+ ## Disclaimer
214
+
215
+ **Osmedeus** is designed to execute arbitrary code and commands from user supplied input via CLI, API, and workflow definitions. This flexibility is intentional and central to how the engine operates.
216
+
217
+ Please refer to the [⚠️ Security Warning](https://docs.osmedeus.org/others/security-warning) page for more information on how to stay safe. [SECURITY.md](SECURITY.md) draws the line between the code execution that is intentional and what counts as a vulnerability, and is where to start if you want to report one.
218
+
219
+ **Think twice before you:**
220
+ - Run workflows downloaded from untrusted sources
221
+ - Execute commands or scans against targets you don't own or have permission to test
222
+ - Use workflows without reviewing their contents first
223
+
224
+ You are responsible for what you run. Always review workflow YAML files before execution, especially those obtained from third parties.
225
+
226
+ ## License
227
+
228
+ Osmedeus is made with ♥ by [@j3ssie](https://twitter.com/j3ssie) and it is released under the MIT license.
package/package.json ADDED
@@ -0,0 +1,23 @@
1
+ {
2
+ "name": "@j3ssie/osmedeus",
3
+ "version": "5.1.0-darwin-arm64",
4
+ "description": "Osmedeus - A Modern Orchestration Engine for Security (darwin-arm64 prebuilt binary)",
5
+ "license": "MIT",
6
+ "homepage": "https://www.osmedeus.org",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/j3ssie/osmedeus.git"
10
+ },
11
+ "os": [
12
+ "darwin"
13
+ ],
14
+ "cpu": [
15
+ "arm64"
16
+ ],
17
+ "engines": {
18
+ "node": ">=16"
19
+ },
20
+ "files": [
21
+ "vendor"
22
+ ]
23
+ }
Binary file