Matlock-Logo Matlock

Matlock — Werkzeuge für Agenten & Entwickler. (Benutzerhandbuch & Betriebsreferenz)

FÜR KI-CODING-AGENTEN & ORCHESTRIERER: Springe direkt zu Teil II: Maschinen- & Autonome Agenten-Betriebsspezifikation für den lokalen stdio-MCP-Katalog mit 27 Werkzeugen, die Zwei-Wege-HTTP 402-Freischaltung, die cold_box-Grenz-Sandbox-Regeln und die Abschlussverträge.

Produkt: Matlock — Werkzeuge für Agenten & Entwickler. (Effizient. Exakt. Regelkonform.)
Positionierung: Lokale polyglotte technische Code-Prüfung in < 50ms für AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF und AICPA SOC 2 Trust Services Criteria mit Testintegritäts-Siegeln, Grenz-Pre-CI-Sandboxen, 1-Klick-CLI-Automatisierung und lokalem stdio-MCP mit 27 Werkzeugen (0 Cloud-Quellcode-Uploads, 0 offene Ports, 0 git commit-Blockade).
Herausgeber: Matlock by Dutch P2P © 2026. Alle Rechte vorbehalten.
Oberflächen: Desktop-Kommandozentrale (Windows, Linux und GoogleBook; macOS arm64 (matlock-mcp Headless bereit) — jederzeit ? oder F1 drücken) · Web-Kommandozentrale · Kostenloser Browser-Scan · Dokumentation · Online-Handbuch · MCP-URI matlock://help/appliance-manual

Geltungsbereich & Rechtlicher Hinweis: Matlock bewertet technische Codebasis- und Pipeline-Kontrollen anhand veröffentlichter Branchenspezifikationen und Benchmarks (MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, automatisierte Pre-CI-Integritätsschranken und technische Kontrollen nach AICPA SOC 2 Trust Services Criteria). Matlock garantiert keine fehlerfreie Software, stellt keine formellen Drittparteien-Testate aus und vergibt keine Zertifizierungen einer unabhängigen zugelassenen CPA-Wirtschaftsprüfungsgesellschaft.


Teil I: Benutzerhandbuch & Werkbank-Leitfaden

1. Kurzglossar & Kernablauf

2. Bildschirmaufbau, Designs & Navigation

3. Erkannte Skripte, Eigene Prüfungen, Aktionen & Stern-Favoriten

4. Walk-Away-Routinen, Computer-Befehle & Lokale Benachrichtigungen

KarteWindowsLinuxHinweise
Shutdown in 30 minutesshutdown.exe /s /t 1800shutdown -h +3030 Min. Verzögerung, nie /f; gepaart mit Cancel shutdown
Cancel shutdownshutdown.exe /ashutdown -cSofortiger 1-Klick-Abbruch
Clean temporary filesNur Benutzer-Temp-Ordner, überspringt aktiveEigene Dateien > 1 Tag in ~/.cache und /tmpRührt Projektdateien niemals an
Check disk spaceGet-PSDrive -PSProvider FileSystemdf -hNur lesend
Optimize disk (defrag or trim)Optimize-Volume -DriveLetter C -Verbosefstrim -avErfordert Admin/Root; bricht sauber ohne UAC/sudo ab
Backup copyrobocopy . "<backup-folder>" /MIRrsync -a --delete ./ "<backup-folder>/"Behält .git, lässt Caches aus; robocopy 0–7 = Bestanden
Find a Word & Expose Itfindstr /s /i /m /c:"Aluminium" *.dartgrep -rnI "Aluminium" --include="*.dart" .Anpassbare rekursive Suche ohne Groß-/Kleinschreibung
Lines Over 250 Catchfor /r %i in (*.dart) do ... find /c /v ""find . -name "*.dart" -exec awk '... c>250 ...' {} +Lesender Scan für Dateien mit mehr als 250 Zeilen

5. Ergebnis-Wasserfall, Einzel-Nachlauf, Ignorieren & Kopieren

6. Feste Manipulationssichere Schutzsperre, Testintegrität & Wiederherstellen

7. Horizontale Bewertungs- & Abdeckungsbalken sowie Modularitätsstandard

8. Zwei-Spalten-Einstellungen & Wiederherstellung Versiegelter Zustände

Klicke oben rechts auf Settings für den übersichtlichen 2-Spalten-Dialog (linke Leiste mit 6 Kategorien + kompakte Einstellungen rechts; jede Kopfzeile bietet ein ?-Symbol zum direkten Sprung ins passende Handbuchkapitel):

  1. Appearance: Sprache (9 Sprachen + Sprache kopierter Texte), Design (System Default, Light, Dark Slate), Desktop-Verknüpfung und unter Windows Minimize to System Tray when closed.
  2. Project & Runner: Modularitäts-Drehregler (Grade A..Minimum), lokales Profil Open folder aus dem privaten lokalen Benutzerprofil, Starter-Einrichtungsbanner wiederherstellen (Restore starter setup banner, blendet Set up for me wieder ein), Keep Quick Run history und Reset Ignore Registry.
  3. Safeguard & Restore: Allow Matlock to restore tests, persönlicher Schalter für automatische Safeguard-Wiederherstellung und Sync across my computers (versiegelte Ordnersynchronisation).
  4. Email Alerts (matlock://settings/alerts): Lokale email_smtp- und custom_script-Station + Test Email.
  5. AI Agent (MCP): Schalter MCP Server (stdio) (standardmäßig aus), Zwei-Wege-Brücke "Mit Headless synchronisieren" ("Sync with Headless" lädt Agenten-Karten/Sequenzen und veröffentlicht Daueraufträge per 1 Klick bei 0 Hintergrund-Polling), Test MCP Connection, Copy MCP Config & Agent Instructions, Copy a question for my phone AI und Agent Email Bridge.
  6. License & Updates: 24-stelligen Schlüssel Activate / Move license to this device, Automatically check for updates (MATLOCK_OFFLINE=1 blockiert alle ausgehenden Verbindungen), Send anonymous crash diagnostics (standardmäßig aus; MATLOCK_NO_TELEMETRY=1), Copy diagnostic info, Free up memory, Share Matlock, Contact us (dutch@dutchp2p.com) und Dutch P2P Tools.
  7. Wiederherstellung Versiegelter Zustände (Reset Ignore Registry): Falls Fremdeingriffe integrity_seal:MUTE_SEAL_TAMPERED oder storage_recovery:BAK_AUTO_RESTORE auslösen ([REMEDY] Sealed configuration was modified outside engine API. Discard manual edits to AppData/Matlock. Manage ignores only via the Desktop UI (agents cannot self-exempt). To reset: Settings -> Storage & Backup -> Reset Ignore Registry.), öffne Settings -> Project & Runner -> Storage & backup -> Reset Ignore Registry.

9. KI-Agenten Verbinden (Desktop-MCP & Mobil-/Chat-Anleitung)

{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}

10. Referenz Eingebauter Standards (10 Ökosysteme + Pre-CI)

Jede eingebaute Prüfung ist fest in Matlock kompiliert und verankert in technischen Kontrollen nach MITRE CWE, CISA SSDF (NIST SP 800-218), IEEE Std 1003.1 POSIX, Pre-CI-Schranken und AICPA SOC 2 Trust Services Criteria:

Ökosystem & BereichWas Matlock Prüft & Verhinderte Produktionsausfälle
Polyglotter Kern & Dart / FlutterStumme Catch-Blöcke (CWE-391), Null-/Grenzrisiken (CWE-476/CWE-125), unawaited Async-Rennen, offene Streams/Timer/Controller (CWE-401), Endlosschleifen (CWE-835), fest codierte Geheimnisse (CWE-798), ungeschwärzte Log-Geheimnisse (CWE-532), deaktivierte TLS-Zertifikatsprüfung über HTTP/SMTP/CLI/CI (CWE-295 / [MITRE T1557]), SQLi (CWE-89), SSRF (CWE-918), XXE (CWE-611), unsignierte JWTs (CWE-347), offene Weiterleitungen (CWE-601), fehlende Timeouts, nicht-atomare Schreibzugriffe, Pfad-Traversal (CWE-22) und leere Tests (CWE-362).
Java (.java)Eingebettete Schlüssel (CWE-798), Befehls-/SQL-Injektion (CWE-78/CWE-89), unsichere Deserialisierung (CWE-502), schwache Chiffren (CWE-327), verschluckte Ausnahmen (CWE-391), offene JDBC-/Stream-Handles (CWE-404), String-==-Fehler, hartes System.exit und Schleifen-Sleeps.
Python (.py)Fest codierte Geheimnisse (CWE-798), Shell-/SQL-Injektion (CWE-78/CWE-89), unsicheres pickle/yaml-Laden (CWE-502), schwache Hashes (CWE-328), nacktes except (CWE-391), veränderliche Standardargumente, offene Deskriptoren (CWE-775), synchrone Aufrufe in async def und leere Tests.
Rust (.rs)Eingebettete Geheimnisse (CWE-798), formatierte Shell-/SQL-Strings (CWE-78/CWE-89), ungeschützte unsafe-Umwandlungen, deaktivierte TLS-Prüfung (CWE-295), Produktions-.unwrap()/todo!(), blockierende Sleeps in Async-Tasks, absichtliche Lecks (CWE-401), verworfene Results und leere Tests.
Go (.go)Feste Tokens (CWE-798), verkettete Exec-/SQL-Strings (CWE-78/CWE-89), InsecureSkipVerify (CWE-295), schwacher RNG (CWE-330), ignorierte Fehler (CWE-252), Schleifen-defer-Lecks & ungekündigte Kontexte (CWE-404), fehlende HTTP-Timeouts, Produktions-panic und leere Tests.
TypeScript & JavaScript (.ts, .tsx, .js, .jsx)Offengelegte Geheimnisse (CWE-798), DOM-XSS- / eval-Senken (CWE-79/CWE-95), Shell-Interpolation (CWE-78), Prototyp-Verschmutzung (CWE-1321), leeres .catch() (CWE-391), Typ-Unterdrückungen, NaN-Vergleichsfehler, blockierendes Sync-I/O, debugger-Reste und Listener-/Timer-Lecks (CWE-401).
C & C++ (.c, .cpp, .cc, .h, .hpp)Feste Geheimnisse (CWE-798), unbegrenzte FFI-/Pufferkopien (CWE-787/CWE-120), Formatstring-Fehler (CWE-134), system()-Injektion (CWE-78), falsches new[]/delete (CWE-762), Use-After-Free (CWE-416), werfende Destruktoren, memset auf nicht-trivialen Typen und nicht zusammengeführte Threads.
Kotlin & Android (.kt, .kts)Feste Geheimnisse (CWE-798), SQL-Verkettung (CWE-89), unsichere WebView-Brücken, umgangenes TLS (CWE-295), weltweit lesbare Einstellungen (CWE-276), offene GlobalScope-Koroutinen (CWE-401), Main-Thread-Blockaden, !!-Abstürze, verschluckte CancellationException und fehlerhafte ZIP-/APK-Header (CWE-190).
C# & .NET (.cs)Nicht freigegebene IDisposable-Handles (CWE-404), async void-Absturzfallen, unparametrisierte SQL-/Befehlsstrings (CWE-89/CWE-78), deaktivierte TLS-Zertifikatsprüfung (CWE-295), verschluckte Exceptions (CWE-391), synchrone .Result/.Wait()-Deadlocks und leere Tests.
SQL & Speicher-Engines (.sql)Wildcard-Rechte (CWE-250), verkettetes dynamisches SQL (CWE-89), Klartext-Passwörter im DDL (CWE-256), OS-Befehlsausbrüche (CWE-78), deaktiviertes RLS, bedingungsloses DELETE/UPDATE, nicht-idempotente Migrationen, tiefe OFFSET-Scans und ungeschützte Tabellensperren.
Cross-OS Pre-CI, Bash/Shell (.sh), PowerShell (.ps1), Dockerfile & GitHub Actions YAMLGroß-/Kleinschreibungskonflikte (POSIX.1), CRLF-Shebangs, Bash-/POSIX-Portabilitätsfallen & PowerShell-$ErrorActionPreference-/LASTEXITCODE-Fehler, ungepinnte Dockerfile-Tags & Root-Container-Risiken, HTML-/Asset-Budgetüberschreitungen, nackte Windows-.cmd/.bat-Spawns, offene Handles & Nicht-Baum-Abbrüche (CWE-775), feste Pfadtrenner, nicht verfolgte Imports, Lockfile-Drift, offene GitHub-Actions-YAML-Rechte, Workflow-Injektion und fehlende +x-Bits.
Modularität & Eigene PrüfungenModularitäts-Drehregler nur für Menschen (Grade A <= 60 bis Minimum <= 1000, Standard Grade C <= 250 Datei / <= 80 Fn; CWE-1080 / CWE-1120) plus eigene Muster- und Skriptprüfungen im lokalen OS-Profil.

11. Workstation-Pro-Lizenz, Web-Vorschau & Kostenloser Browser-Scan

12. Linux, GoogleBook, Updates, Datenschutz & Direktsupport


Teil II: Maschinen- & Autonome Agenten-Betriebsspezifikation

A. Agenten-Einstiegspunkte & Transport-Einrichtung

{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}

B. Messung, Zwei-Wege-402-Freischaltung & Gas-Tank

C. Vollständiger Lokaler MCP-Katalog mit 27 Werkzeugen

  1. matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?): Index 0 (readOnlyHint: true) < 50ms AST-, CWE-, POSIX- und Pre-CI-Scan mit file:line:col (col >= 1), cwe, mitre_attack und 5-Zeilen-Diff-Vorschlägen (auch per CLI matlock-mcp scan . --format=sarif als SARIF 2.1.0).
  2. matlock_describe_project(target_path?, mode?): Optionales Workspace-Profil (0 Credits, readOnlyHint: true); übergib mode: "tool_bag" (oder CLI matlock-mcp toolbag [--json]) für ein kompaktes ~350–550-Token-Inventar aus [LOCKED]- (nur ausführbar) vs. [MODIFIABLE]-Aktionskarten (verfeinerbar), Sequenzen, [NEW]/[UPDATED]-Markierungen, [UNAVAILABLE IN CONTAINER]-Hinweisen, Daueraufträgen und E-Mail-Alarmstatus.
  3. matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?): Seitenweise Befunde (25/Seite; Desktop blendet geschützte Zeilen bis zur Entsperrung aus; --headless mit Gas-Tank schaltet Koordinaten frei).
  4. matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?): Prüft 1–5 Testdateien (test_file / test_files) über 3 Prüfungen (Laufzeit-Pass mit >= 1 Assertion, 0 Analyzer-Warnungen + LOC-Obergrenze, 0 Matlock-Befunde) vor der Safeguard-Versiegelung oder versiegelt eine Baseline (baseline_only: true).
  5. matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?): Prüft Einträge der Testintegrität und speichert erläuternde Agentennotizen (0 Löschrechte).
  6. matlock_get_history(target_path?, limit?): Schreibgeschützter Bewertungs- und Reparaturverlauf.
  7. matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?): Offline-Handbuch (9 Sprachen) und CWE/POSIX/SSDF/SOC2/Ergebnis-Nachschlagewerk (0 Credits, 0 Netzwerk).
  8. matlock_list_custom_tests: Listet benutzerdefinierte Prüfungen auf.
  9. matlock_register_custom_test: Speichert eine eigene Muster- oder Skriptprüfung.
  10. matlock_delete_custom_test: Löscht eine entsperrte eigene Prüfung (eingebaute Prüfungen sind unveränderlich).
  11. matlock_list_actions: Listet Aktionskarten (samt favorite/Sperr-/Freigabeflags) sowie unkonfigurierte recommendedTemplates (unconfiguredTemplate: true) auf.
  12. matlock_register_action(id, command, name?, favorite?): Programmiert oder aktualisiert jede entsperrte Aktion oder Startvorlage (tpl_github, tpl_save_drive, tpl_cloud_sync, tpl_save_backup, tpl_defrag_optimize, tpl_shut_down), entfernt unconfiguredTemplate, setzt/löst Favoriten (favorite: true | false) und erzwingt Require Approval auf Desktop.
  13. matlock_register_sealed_script: Versiegelt Build-/Testbefehle (Locked by User) gegen Sub-Agenten.
  14. matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?): Führt einen Befehl unter OS-Prozessbaum-Isolation aus (async: true nicht-blockierend, send_alert, eigene USB-robocopy/rsync-, Cloud-R2/S3/GCS/Azure- und git push-Karten unterstützt; 0 eingebautes git push in Matlock-Testläufen).
  15. matlock_get_action_status(id?): Fragt Live-Status, Exit-Code und kompakte Statuskapseln für async: true-Läufe ab.
  16. matlock_stop_action(id?, stop_sequence?): Beendet sofort einen aktiven Prozessbaum (stop_sequence: true stoppt eine aktive Sequenz vollständig).
  17. matlock_delete_action: Löscht eine entsperrte Aktionskarte.
  18. matlock_list_sequences: Listet mehrstufige Routinen auf.
  19. matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?): Erstellt oder bearbeitet eine entsperrte Sequenz in Serie und fügt jede Aktion oder alert::<id> exakt am 0-basierten Index insert_at_index mit failure_policy ("stop" | "stop_and_alert" | "continue_and_alert"), always_run und favorite: true | false ein.
  20. matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?): Startet seq_matlock oder seq_fast_verify (file für Einzeltestdatei, async: true für nicht-blockierende Ausführung mit Auto-Wake, send_alert für E-Mail-Trigger; cold_box: false Standard für Tempo; cold_box: true vor externem Speichern, Cloud-Sync, Backup, Push oder Release-Build mit < 15ms-Quittung bei unverändertem Workspace; deep: true erzwingt kompletten Clean- & Coverage-Lauf).
  21. matlock_delete_sequence: Löscht eine entsperrte Routine.
  22. matlock_list_alerts: Listet lokale Benachrichtigungskanäle auf (Geheimnisse maskiert).
  23. matlock_set_alert: Konfiguriert rein ausgehende Native-Dart-TLS-1.2/1.3-email_smtp-Alarme (globale Vorlagen, OS-Schlüsselbund oder passphrasenversiegelter lokaler Tresor) oder custom_script-Alarme.
  24. matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move): Sendet lokale Benachrichtigung mit verbindlichem 3-Fragen-Abschluss.
  25. matlock_delete_alert: Löscht eine entsperrte Benachrichtigungskarte.
  26. matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?): Begleicht eigenverwaltete M2M-Gas-Tank-Aufladungen oder aktiviert einen 24-stelligen Pro-license_key für ca. 23 €* ($24.99 USD/Jahr).
  27. matlock_report_issue(category, subject, description, tool_context?, output_dump?): Asynchroner bereinigter Feedback-/Wunschbericht (0 Credits, CONTINUE_IMMEDIATELY).

D. Grenz-Cold-Box-Sandbox, 3-Schleifen-Wächter & 3-Fragen-Abschluss

E. Maschinenlesbare Spezifikation für KI-Coding-Agenten (YAML)

product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/de/app"
free_local_scan: "https://matlock.dutchp2p.com/de/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/de/docs"
online_manual: "https://matlock.dutchp2p.com/de/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"

F. Agenten-Betriebsgrundsätze & Ausführungsgrenzen

Nach oben