### Setup development environment Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Commands to clone the repository, initialize a virtual environment, install development dependencies, and run tests and linting tools. ```bash git clone https://github.com/HR-Presents/AegisLog-AI.git cd AegisLog-AI python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e '.[dev]' pytest ruff check . bandit -q -r src ``` -------------------------------- ### Install via pipx Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/INSTALL.md Clone the repository and install the package using pipx, then run the doctor command to verify the installation. ```bash git clone https://github.com/HR-Presents/AegisLog-AI.git cd AegisLog-AI pipx install . aegislog doctor ``` -------------------------------- ### Install AegisLog-AI from source Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Clone the repository, set up a virtual environment, and install the package to run the doctor and dashboard commands. ```bash git clone https://github.com/HR-Presents/AegisLog-AI.git cd AegisLog-AI python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e . aegislog doctor aegislog dashboard examples/auth.log ``` -------------------------------- ### Install dependencies and verify AegisLog environment Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Commands to install development dependencies and run diagnostic, help, and quality assurance tools. ```bash pip install -e '.[dev]' aegislog doctor aegislog --help pytest ruff check . bandit -q -r src ``` -------------------------------- ### Launch Investigation Dashboard Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Launch the dashboard using a sanitized example log file from the repository root. ```powershell .\AegisLog.exe dashboard .\examples\auth.log ``` -------------------------------- ### Set up development environment Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/INSTALL.md Create a virtual environment, install dependencies in editable mode, and run tests. On Windows PowerShell, use .venv\Scripts\Activate.ps1 to activate the environment. ```bash python -m venv .venv source .venv/bin/activate pip install -e '.[dev]' pytest ``` -------------------------------- ### AegisLog CLI Direct Usage Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/RELEASE_V1.3.1.md Examples of executing AegisLog commands directly from the Windows command line. ```text AegisLog.exe --help AegisLog.exe dashboard AegisLog.exe live --profile security AegisLog.exe incidents AegisLog.exe explain ``` -------------------------------- ### Run local development checks Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/TESTING.md Installs development dependencies, runs the ruff linter, and executes the pytest suite. ```bash pip install -e '.[dev]' ruff check . pytest -q ``` -------------------------------- ### Start AegisLog executable Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/RELEASE_V1.3.0.md Run the AegisLog executable from a terminal to open the control center. ```text AegisLog.exe ``` -------------------------------- ### Run local development validation Source: https://github.com/hr-presents/aegislog-ai/blob/main/CONTRIBUTING.md Commands to set up a virtual environment, install development dependencies, and execute tests and security checks. ```bash python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e '.[dev]' pytest ruff check . bandit -q -r src ``` -------------------------------- ### Generate reports and hunt threats Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Examples of generating reports and performing threat hunting using the CLI. ```text AegisLog.exe report auth.log --output report.json AegisLog.exe hunt --severity HIGH ``` -------------------------------- ### Install AegisLog with build isolation disabled Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SECURITY_HARDENING.md Windows executable workflows install AegisLog using --no-deps and --no-build-isolation to ensure only locked dependencies are used. ```bash --no-deps --no-build-isolation ``` -------------------------------- ### Clone and Run AegisLog-AI Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/QUICKSTART.md Commands to clone the repository, set up a virtual environment, install dependencies, and execute basic analysis commands. Windows PowerShell users should use .venv\Scripts\Activate.ps1 to activate the environment. ```bash git clone https://github.com/HR-Presents/AegisLog-AI.git cd AegisLog-AI python -m venv .venv source .venv/bin/activate pip install -e . aegislog doctor aegislog analyze examples/auth.log aegislog incidents examples/auth.log ``` -------------------------------- ### Format co-authored commit trailers Source: https://github.com/hr-presents/aegislog-ai/blob/main/CONTRIBUTING.md Example of a GitHub-compatible co-authorship trailer for pull requests involving multiple contributors. ```text feat: improve defensive log analysis Co-authored-by: Contributor Name ``` -------------------------------- ### Incident and Evidence Workflow Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Commands to inspect incidents and investigate a specific incident ID using an example log. ```powershell .\AegisLog.exe incidents .\examples\auth.log ``` ```powershell .\AegisLog.exe investigate .\examples\auth.log ``` -------------------------------- ### JSONL External Evidence Schema Example Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXTERNAL_EVIDENCE_SUBMISSION.md Example structure for a single JSON object in the newline-delimited JSON dataset. Each object must contain a unique id, log lines, and expected categories. ```json {"id":"ext-001","label":"SSH authentication failures","lines":["",""],"expected_categories":["authentication"]} ``` -------------------------------- ### Check available native telemetry sources Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Use this command to list the telemetry sources supported by your current AegisLog installation. ```text AegisLog.exe native-sources ``` -------------------------------- ### Monitor Docker container continuously Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Starts continuous monitoring for a specific Docker container using the docker profile. Requires Docker access permissions. ```text AegisLog.exe native-live docker --container api --profile docker ``` -------------------------------- ### Monitor Linux journald continuously Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Starts continuous monitoring of journald using the operations profile. Requires journalctl access permissions. ```text AegisLog.exe native-live journald --profile operations ``` -------------------------------- ### AegisLog Terminal Control Center Commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/RELEASE_V1.3.1.md Examples of commands that can be entered directly into the AegisLog terminal control center menu. ```text native-sources native-analyze windows --channel Security native-live windows --channel Security --profile security dashboard "C:\Security Logs\auth.log" incidents "C:\Security Logs\auth.log" mitre "C:\Security Logs\auth.log" ``` -------------------------------- ### Monitor Windows Security telemetry continuously Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Starts continuous monitoring of the Windows Security channel using the security profile. ```text AegisLog.exe native-live windows --channel Security --profile security ``` -------------------------------- ### Manage AegisLog AI with pipx Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/UPGRADING.md Commands to install, upgrade, or uninstall the AegisLog AI package within an isolated pipx environment. ```bash pipx install aegislog-ai pipx upgrade aegislog-ai pipx uninstall aegislog-ai ``` -------------------------------- ### Access command help Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Run the help command to view exact syntax for any specific command. ```text AegisLog.exe --help ``` -------------------------------- ### Clone and initialize AegisLog repository Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Initial steps to clone the repository and create a Python virtual environment for development. ```bash git clone https://github.com/HR-Presents/AegisLog-AI.git cd AegisLog-AI python -m venv .venv ``` -------------------------------- ### Launch AegisLog on Linux or macOS Source: https://github.com/hr-presents/aegislog-ai/blob/main/customer_bundle/README.txt Commands to set execution permissions and run the startup script on Unix-based systems. ```bash chmod +x START_AEGISLOG.sh ./START_AEGISLOG.sh ``` -------------------------------- ### Multi-source live SOC view Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Monitor multiple growing log files simultaneously in a unified view. ```text AegisLog.exe live-multi C:\logs\auth.log C:\logs\nginx.log C:\logs\application.log ``` -------------------------------- ### Run performance benchmarks Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/PERFORMANCE.md Execute stream and live state benchmarks to verify resource usage under specified load conditions. ```bash python benchmarks/stream_benchmark.py --lines 250000 --chunk-size 2000 python benchmarks/live_state_benchmark.py --lines 100000 --window 1000 --batch-size 1000 ``` -------------------------------- ### View native-live help Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Displays the exact options supported by your specific build of AegisLog. ```text AegisLog.exe native-live --help ``` -------------------------------- ### Access CLI help Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Displays help information for the AegisLog executable or specific commands. ```text AegisLog.exe --help AegisLog.exe --help ``` -------------------------------- ### Generate external evidence with build_external_evidence.py Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXTERNAL_EVIDENCE_SUBMISSION.md Run this command from the repository root to generate the external evidence file. The generator will not overwrite existing files. ```bash python tools/build_external_evidence.py \ --evaluated-commit <40-character-lowercase-evaluated-code-SHA> \ --provenance "" \ --labeling-procedure "" \ --reviewer "" \ --reviewer-role "" \ --independent-labeling \ --sanitized \ --min-severity MEDIUM \ --output evaluation/external-release-evidence.json ``` -------------------------------- ### Run AI Analyst with local provider Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/AI_PROVIDERS.md The default mode using only deterministic recommendations without network access. ```bash aegislog ai-analyst examples/auth.log --provider local ``` -------------------------------- ### Native live control options Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md List of common flags available for the native-live command. ```text --profile --refresh --window --limit --from-start ``` -------------------------------- ### Monitor live Windows security sessions Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Commands to list native sources and initiate a live security monitoring session. ```text AegisLog.exe native-sources AegisLog.exe native-live windows --channel Security --profile security ``` -------------------------------- ### Use local AI providers Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/REMOTE_AI.md Run AI analysis locally using the local or ollama providers to avoid remote transmission. ```bash aegislog ai-analyst examples/auth.log --provider local aegislog ai-analyst examples/auth.log --provider ollama --model llama3.2 ``` -------------------------------- ### Access AegisLog command help Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Use the --help flag to view available options for specific commands. ```text AegisLog.exe --help AegisLog.exe live --help AegisLog.exe native-live --help AegisLog.exe investigate --help ``` -------------------------------- ### Handle file paths with spaces Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Use full paths and wrap them in quotes when the path contains spaces. ```text AegisLog.exe dashboard "C:\Users\YourName\Desktop\Security Logs\auth.log" ``` -------------------------------- ### PR preview build CI evidence details Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Displays the specific commit, workflow, artifact name, ID, and digest for the current validated Windows build used for PR previews. ```text Commit: 7b5269e8990fcd3743f28bfaea720dfd00828060 Workflow: Windows single executable #434 Artifact name: AegisLog-Windows-Single-EXE Artifact ID: 10074199022 Artifact digest: sha256:2514932a6687f045fa6877de20c42c70db892a1dd20808f013a43a4dbb819720 ``` -------------------------------- ### Monitor multiple log files Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Command to view a multi-file SOC dashboard for specific log paths. ```text AegisLog.exe live-multi C:\logs\auth.log C:\logs\nginx.log C:\logs\application.log --profile security ``` -------------------------------- ### Live monitoring with Watch Mode Profile Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Focus the live monitoring display using specific profiles. ```text AegisLog.exe live C:\logs\auth.log --profile security AegisLog.exe live C:\logs\auth.log --profile authentication AegisLog.exe live C:\logs\nginx.log --profile web ``` -------------------------------- ### Mission Control Output Path Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Recommended file path for the Mission Control screenshot. ```text docs/assets/screenshots/aegislog-mission-control.png ``` -------------------------------- ### Diagnostic commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Run system health checks or access help documentation. ```text AegisLog.exe doctor AegisLog.exe --help AegisLog.exe --help ``` -------------------------------- ### Live monitoring commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Monitor single or multiple log files with specific security or authentication profiles. ```text AegisLog.exe live C:\logs\auth.log --profile security AegisLog.exe live-multi C:\logs\auth.log C:\logs\web.log --profile authentication ``` -------------------------------- ### Mission Control menu options Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md The available entry points displayed within the Mission Control interface. ```text 01 ANALYZE LOG 02 LIVE MONITOR 03 MULTI-SOURCE SOC 04 NATIVE LOGS 05 NATIVE MONITOR 06 INCIDENT INTEL A AI ANALYST 07 DEMO 08 HEALTH 09 COMMANDS C COMMAND MODE Q EXIT ``` -------------------------------- ### Run AI Analyst with Ollama Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/COMMANDS.md Uses a local Ollama instance with a specified model for analysis. ```bash aegislog ai-analyst examples/auth.log --provider ollama --model llama3.2 ``` -------------------------------- ### Verify AegisLog.exe with PowerShell Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/INSTALL.md Use these commands to generate the SHA-256 hash of the executable and compare it against the provided checksum file. ```powershell Get-FileHash .\AegisLog.exe -Algorithm SHA256 Get-Content .\AegisLog.exe.sha256 ``` -------------------------------- ### Compare log behavior Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Compares a current log file against one or more baseline logs to identify behavioral differences. ```text AegisLog.exe behavior --baseline monday.log --baseline tuesday.log --current today.log ``` -------------------------------- ### Perform static log analysis Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Commands for dashboarding, incident reporting, explanation, and MITRE mapping on a log file. ```text AegisLog.exe dashboard C:\path\to\auth.log AegisLog.exe incidents C:\path\to\auth.log AegisLog.exe explain C:\path\to\auth.log AegisLog.exe mitre C:\path\to\auth.log ``` -------------------------------- ### Run suspicious authentication log workflow Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md A sequence of commands to analyze, investigate, and document suspicious authentication logs. ```text AegisLog.exe dashboard C:\logs\auth.log AegisLog.exe incidents C:\logs\auth.log AegisLog.exe investigate C:\logs\auth.log INC-XXXXXXXX AegisLog.exe explain C:\logs\auth.log INC-XXXXXXXX AegisLog.exe mitre C:\logs\auth.log AegisLog.exe save-investigation C:\logs\auth.log INC-XXXXXXXX AegisLog.exe case-history ``` -------------------------------- ### Run AI Analyst with local Ollama Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/AI_PROVIDERS.md Uses a local Ollama instance. The default endpoint is http://127.0.0.1:11434, which can be overridden via AEGISLOG_OLLAMA_URL or --base-url. ```bash aegislog ai-analyst examples/auth.log \ --provider ollama \ --model llama3.2 ``` -------------------------------- ### AegisLog Advanced Manual Commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/customer_bundle/README.txt Direct CLI commands for version checking, system diagnostics, and log analysis. ```bash aegislog --version aegislog doctor aegislog dashboard C:\path\to\your\logfile.log aegislog analyze C:\path\to\your\logfile.log aegislog stream C:\path\to\your\logfile.log ``` -------------------------------- ### Analyze Windows System and Application channels Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Performs snapshot analysis for the System and Application Windows channels. ```text AegisLog.exe native-analyze windows --channel System AegisLog.exe native-analyze windows --channel Application ``` -------------------------------- ### AegisLog CLI commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/RELEASE_V1.3.0.md Common commands for dashboarding, live monitoring, native source analysis, and incident investigation. ```text AegisLog.exe dashboard AegisLog.exe live --profile security AegisLog.exe live-multi --profile authentication AegisLog.exe native-sources AegisLog.exe native-analyze windows --channel Security AegisLog.exe native-analyze journald AegisLog.exe native-analyze docker --container AegisLog.exe native-live windows --channel Security --profile security AegisLog.exe incidents AegisLog.exe investigate AegisLog.exe explain AegisLog.exe mitre AegisLog.exe case-history ``` -------------------------------- ### Configure Aegislog CLI settings Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/CONFIGURATION.md Sets the AI provider and model preferences using the aegislog config command. ```bash aegislog config --provider none --model "" ``` -------------------------------- ### AegisLog CLI Commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/V0.2.md A collection of primary CLI commands for analyzing logs, detecting threats, monitoring files, and configuring the AegisLog environment. ```bash aegislog analyze examples/auth.log aegislog threats examples/auth.log aegislog anomalies examples/access.log aegislog ask "What looks suspicious?" examples/auth.log aegislog watch /var/log/auth.log aegislog scan /var/log aegislog report examples/auth.log --output report.json aegislog config --provider none aegislog doctor ``` -------------------------------- ### Open AegisLog control center Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Commands to launch the interactive control center interface. ```text AegisLog.exe ``` ```text AegisLog.exe start ``` -------------------------------- ### Launch Mission Control Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Launch the primary AegisLog interface to capture the main operator workflow. ```powershell .\AegisLog.exe ``` -------------------------------- ### Run AI Analyst with remote OpenAI-compatible endpoint Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/AI_PROVIDERS.md Requires the --allow-remote flag for explicit consent. Supports AEGISLOG_API_KEY or OPENAI_API_KEY, and custom base URLs via AEGISLOG_BASE_URL or --base-url. ```bash AEGISLOG_API_KEY='your-key' aegislog ai-analyst examples/auth.log \ --provider openai-compatible \ --model YOUR_MODEL \ --allow-remote ``` -------------------------------- ### Native telemetry commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Interact with native system logs including Windows Security, journald, and Docker containers. ```text AegisLog.exe native-sources AegisLog.exe native-analyze windows --channel Security AegisLog.exe native-live windows --channel Security --profile security AegisLog.exe native-live journald --profile operations AegisLog.exe native-live docker --container --profile docker ``` -------------------------------- ### Collect and analyze Docker logs with aegislog collect docker Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/COLLECTORS.md Invokes docker logs --tail without altering container state. Permissions are inherited from the current user without automatic elevation. ```bash aegislog collect docker --target my-container --lines 300 --output container.log aegislog analyze container.log ``` -------------------------------- ### Focused multi-source live view Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Apply profiles to the unified multi-source view to filter findings. ```text AegisLog.exe live-multi C:\logs\auth.log C:\logs\web.log --profile security AegisLog.exe live-multi C:\logs\auth.log C:\logs\web.log --profile authentication AegisLog.exe live-multi C:\logs\nginx.log C:\logs\application.log --profile web ``` -------------------------------- ### Incident Investigation Output Path Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Recommended file path for the Incident Investigation screenshot. ```text docs/assets/screenshots/aegislog-incident-investigation.png ``` -------------------------------- ### Live monitoring of a growing file Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Monitor a log file that is being continuously updated by another service. ```text AegisLog.exe live C:\logs\server.log ``` -------------------------------- ### Explain an incident using local AI Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Generate a local, deterministic explanation for an incident ID without sending log data to external services. ```text AegisLog.exe explain C:\logs\auth.log INC-XXXXXXXX ``` -------------------------------- ### Analyze Linux journald snapshot Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Performs a snapshot analysis of Linux journald logs. ```text AegisLog.exe native-analyze journald ``` -------------------------------- ### Web-server log investigation Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXAMPLES.md Commands to analyze and detect anomalies within web server access logs. ```bash aegislog analyze examples/access.log aegislog anomalies examples/access.log ``` -------------------------------- ### Analyze Docker container snapshot Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Performs a snapshot analysis for a specific Docker container. ```text AegisLog.exe native-analyze docker --container api ``` -------------------------------- ### Collect journald logs with aegislog collect journal Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/COLLECTORS.md Invokes journalctl without mutation options, capping requests at 5,000 lines. The first command collects 500 lines, while the second targets a specific service. ```bash aegislog collect journal --lines 500 --output journal.log aegislog collect journal --target ssh.service --lines 300 --output ssh.log ``` -------------------------------- ### AegisLog CLI Analysis Commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/DEMO.md A collection of commands to perform system diagnostics, log analysis, threat detection, incident identification, and report generation. ```bash aegislog doctor aegislog analyze examples/auth.log aegislog threats examples/auth.log aegislog incidents examples/auth.log aegislog analyze examples/access.log aegislog ask "What should I investigate first?" examples/auth.log aegislog report examples/auth.log --output aegislog-report.json ``` -------------------------------- ### Show MITRE ATT&CK context Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Map evidence-consistent MITRE ATT&CK techniques for incidents found within a log file. ```text AegisLog.exe mitre C:\logs\auth.log ``` -------------------------------- ### Analyze Windows Security channel snapshot Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Performs a snapshot analysis of the Windows Security channel. ```text AegisLog.exe native-analyze windows --channel Security ``` -------------------------------- ### Run AI Analyst Source: https://github.com/hr-presents/aegislog-ai/blob/main/README.md Analyze logs using local or remote AI providers. Remote providers require an API key and explicit consent. ```text # Deterministic local answer; no model or network required AegisLog.exe ai-analyst C:\path\to\auth.log --provider local # Local Ollama AegisLog.exe ai-analyst C:\path\to\auth.log --provider ollama --model llama3.2 # Remote OpenAI-compatible provider: explicit consent required AegisLog.exe ai-analyst C:\path\to\auth.log --provider openai-compatible --model YOUR_MODEL --allow-remote ``` -------------------------------- ### Run aegislog analysis and incident commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_SCRIPT.md Execute these commands against synthetic log files to generate clean terminal output for documentation. Ensure no real hostnames, usernames, internal addresses, tokens, or production log data are captured. ```bash aegislog analyze examples/auth.log aegislog incidents examples/auth.log aegislog analyze examples/access.log ``` -------------------------------- ### Entity-oriented CLI commands Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Additional commands for managing and indexing entities within the AegisLog CLI. ```text AegisLog.exe entities AegisLog.exe index-entities AegisLog.exe entity AegisLog.exe entity-top ``` -------------------------------- ### Generate release evidence Source: https://github.com/hr-presents/aegislog-ai/blob/main/evaluation/README.md Generates the required release evidence file for a specific commit. This tool enforces independent labeling and sanitization checks and automatically computes dataset metrics and hashes. ```text python tools/build_external_evidence.py sanitized_external.jsonl \ --evaluated-commit <40-character-release-commit> \ --provenance "Describe source population, sampling period, sanitization, and exclusions" \ --labeling-procedure "Describe independent labeling, adjudication, and review procedure" \ --reviewer "Reviewer name or approved review identifier" \ --reviewer-role "Security Analyst" \ --independent-labeling \ --sanitized ``` -------------------------------- ### Dashboard with quoted path Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Use quotes for file paths containing spaces. ```text AegisLog.exe dashboard "C:\Security Logs\auth.log" ``` -------------------------------- ### Authentication log investigation Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXAMPLES.md Commands to analyze, identify threats, detect incidents, and query authentication logs for potential brute-force activity. ```bash aegislog analyze examples/auth.log aegislog threats examples/auth.log aegislog incidents examples/auth.log aegislog ask "Could this be brute-force activity?" examples/auth.log ``` -------------------------------- ### Release Dispatch Command Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/RELEASE_HANDOFF_V1.6.1.md The command used to trigger the release workflow from the main branch. ```text RELEASE-v1.6.1 ``` -------------------------------- ### Analyze a saved log file Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Perform a fast analysis of a log file using the analyze command. ```text AegisLog.exe analyze C:\logs\auth.log ``` -------------------------------- ### Enforce runtime dependency hashes Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SECURITY_HARDENING.md The runtime-lock audit and customer-bundle workflows enforce dependency integrity using the --require-hashes flag. ```bash --require-hashes ``` -------------------------------- ### Executive Report Output Path Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Recommended file path for the HTML investigation report screenshot. ```text docs/assets/screenshots/aegislog-executive-report.png ``` -------------------------------- ### Investigation Dashboard Output Path Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SCREENSHOT_CAPTURE.md Recommended file path for the Investigation Dashboard screenshot. ```text docs/assets/screenshots/aegislog-investigation-dashboard.png ``` -------------------------------- ### Run external corpus evaluation Source: https://github.com/hr-presents/aegislog-ai/blob/main/evaluation/README.md Evaluates an external dataset. The --provenance flag is mandatory when using --dataset-kind external to document the data source and processing. ```text python tools/evaluate_detections.py sanitized_external.jsonl \ --dataset-kind external \ --provenance "Source, sampling window, labeling process, sanitization, and reviewer details" ``` -------------------------------- ### Required JSON schema for evaluation/external-release-evidence.json Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXTERNAL_DETECTION_EVIDENCE.md This JSON structure defines the mandatory fields for the external release evidence manifest. Numeric values shown are placeholders and must be replaced with actual evaluation results. ```json { "schema_version": 1, "dataset_kind": "external", "provenance": "Meaningful description of the authorized telemetry population and sampling method.", "labeling_procedure": "Meaningful description of how ground-truth labels were assigned and reviewed.", "reviewer": "Reviewer name or approved organizational reviewer identifier", "reviewer_role": "Security / detection-review role", "independent_labeling": true, "sanitized": true, "dataset_sha256": "<64 lowercase hexadecimal characters>", "evaluated_commit": "<40 lowercase hexadecimal Git commit SHA>", "sample_count": 1, "metrics": { "precision": 0.0, "recall": 0.0, "case_accuracy": 0.0, "false_positives": 0, "false_negatives": 0 } } ``` -------------------------------- ### List incidents in a log file Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Use the incidents command to identify potential security events within a specified log file. ```text AegisLog.exe incidents C:\logs\auth.log ``` -------------------------------- ### Official v1.3.0 SHA-256 hash Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md The expected SHA-256 checksum for the official v1.3.0 release. ```text 8763b843faa32e5848a4fe116dedb1e3316accbc55dd70f6fdae4601fe1b572a ``` -------------------------------- ### Access the terminal dashboard Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Launch the rich terminal dashboard to summarize risks, incidents, and findings. ```text AegisLog.exe dashboard C:\logs\auth.log ``` -------------------------------- ### List saved investigation cases Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Lists all saved investigation cases from the local store. ```text AegisLog.exe case-history ``` -------------------------------- ### Analyze journald JSON export Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXAMPLES.md Analyze a journald export file provided in JSON lines format. ```bash aegislog analyze journal.jsonl ``` -------------------------------- ### Recursive log directory scan Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/EXAMPLES.md Perform a recursive scan of a directory. Permission errors are automatically skipped as AegisLog does not elevate privileges. ```bash aegislog scan /var/log ``` -------------------------------- ### Run synthetic regression gate Source: https://github.com/hr-presents/aegislog-ai/blob/main/evaluation/README.md Executes the detection evaluator on the synthetic regression fixture with strict thresholds. These thresholds are intended for deterministic testing and not for real-world performance metrics. ```text python tools/evaluate_detections.py evaluation/labeled_events.jsonl \ --dataset-kind synthetic \ --min-precision 1.0 \ --min-recall 1.0 \ --min-case-accuracy 1.0 \ --max-fp 0 \ --max-fn 0 ``` -------------------------------- ### Extract incident entities Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Extract and summarize entities from a log file using the intel-entities command. ```text AegisLog.exe intel-entities C:\logs\auth.log ``` -------------------------------- ### Open a saved investigation case Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Opens a specific saved investigation case by its ID. ```text AegisLog.exe case-show INC-XXXXXXXX ``` -------------------------------- ### Stream large log files Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Processes large log files in chunks to keep memory usage bounded. ```text AegisLog.exe stream C:\logs\huge-server.log --chunk-size 2000 ``` -------------------------------- ### Build artifact without isolation Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/SECURITY_HARDENING.md Package construction uses the --no-isolation flag to prevent the build environment from re-downloading dependencies. ```bash python -m build --no-isolation ``` -------------------------------- ### Save investigation to case store Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Saves an incident to the local investigation case store using the save-investigation command. ```text AegisLog.exe save-investigation C:\logs\auth.log INC-XXXXXXXX ``` -------------------------------- ### Investigate a specific incident ID Source: https://github.com/hr-presents/aegislog-ai/blob/main/docs/USER_GUIDE.md Inspect a specific incident by providing the log path and the incident ID obtained from the list command. ```text AegisLog.exe investigate C:\logs\auth.log INC-XXXXXXXX ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.