Skip to content
Back to search

vektor

High-speed safe-Rust MCP server, sub-ms Antigravity hook engine, DevSecOps CLI auditor (Secrets, PII, Trojan Guard, GHA, SARIF 2.1.0, CycloneDX 1.5 SBOM) & 7-expert dev team plugin.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/glastor-core--vektor/badge.svg)](/listings/glastor-core--vektor)

HTML

<a href="/listings/glastor-core--vektor"><img src="/api/listings/glastor-core--vektor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install the binary

# Via Homebrew (macOS & Linux — official GLASTOR tap)
brew install glastor-core/tap/vektor

# Via cargo-binstall (downloads prebuilt release binary with SLSA provenance)
cargo binstall vektor-cli

# Or build from source (MSRV 1.90)
cargo install --path crates/vektor-cli

2. Initialize workspace & plugin

# Generate starter vektor.toml and install the Antigravity plugin
vektor init --install-plugin

# Verify binary, toolchain, config, plugin, and repo hygiene
vektor doctor

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 181 lines
  1. # Vektor
  2. [![CI](https://github.com/glastor-core/vektor/actions/workflows/ci.yml/badge.svg)](https://github.com/glastor-core/vektor/actions/workflows/ci.yml)
  3. [![Security](https://github.com/glastor-core/vektor/actions/workflows/security.yml/badge.svg)](https://github.com/glastor-core/vektor/actions/workflows/security.yml)
  4. [![Release](https://github.com/glastor-core/vektor/actions/workflows/release.yml/badge.svg)](https://github.com/glastor-core/vektor/actions/workflows/release.yml)
  5. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  6. [![MSRV: 1.90](https://img.shields.io/badge/MSRV-1.90-orange.svg)](Cargo.toml)
  7. [![Safe Rust](https://img.shields.io/badge/unsafe-forbid-brightgreen.svg)](Cargo.toml)
  8. **Vektor** is a 100% safe-Rust (`unsafe_code = "forbid"`) **MCP server**, **sub-millisecond Antigravity lifecycle hook engine**, **DevSecOps CLI auditor**, and **7-expert development team plugin** designed to complement **Gemini (Antigravity)** with **Engram** as the shared persistent memory backbone.
  9. ---
  10. ## Architecture
  11. ```mermaid
  12. flowchart LR
  13. AGY["Gemini / Antigravity<br/>(Tech Lead & Orchestrator)"]
  14. ENGRAM["Engram<br/>(Shared Persistent Memory)"]
  15. PLUGIN["plugin/<br/>7 Specialist Agents + Rules + Hooks"]
  16. subgraph VEKTOR["vektor (Single Rust Binary)"]
  17. MCP["vektor-core<br/>JSON-RPC 2.0 MCP Server<br/>13 Tools + 2 Resources"]
  18. HOOKS["vektor-cli<br/>PreToolUse / PostToolUse / Stop<br/>+ DevSecOps CLI"]
  19. ANALYZERS["vektor-analyzers<br/>Secrets · Trojan Guard · GHA · AST<br/>Cargo · SBOM · SARIF · Hygiene"]
  20. STATE["vektor-state<br/>SQLite WAL (.vektor/state.db)<br/>Swarm Tasks · Locks · AST Cache"]
  21. end
  22. AGY <--> ENGRAM
  23. AGY <--> PLUGIN
  24. AGY <-->|MCP stdio| MCP
  25. AGY -->|Lifecycle Hooks| HOOKS
  26. MCP --> ANALYZERS
  27. MCP --> STATE
  28. HOOKS --> ANALYZERS
  29. HOOKS --> STATE
  30. ```
  31. ### Workspace Crates
  32. - **`crates/vektor-core`**: Strict JSON-RPC 2.0 MCP stdio engine with protocol version negotiation (`2024-11-05`, `2025-03-26`, `2025-06-18`), `ToolAnnotations` (`readOnlyHint`, `idempotentHint`), MCP Resources, and Antigravity camelCase hook contracts.
  33. - **`crates/vektor-analyzers`**: Pure-Rust deterministic static analyzers:
  34. - **Secret Scanner**: 16 provider rules (AWS, GitHub, OpenAI/Anthropic, Stripe, npm, PyPI, SendGrid, Twilio, Telegram, Hugging Face, DB URIs, JWT, GCP Service Account, etc.) + Shannon entropy + `--staged` Git pre-commit mode.
  35. - **Trojan Guard**: Unicode BiDi overrides (CVE-2021-42574), Unicode Tags, ANSI escapes, and zero-width invisible characters.
  36. - **GitHub Actions Linter & Auto-Fixer**: SHA-40 pinning, least-privilege `permissions:`, `concurrency:`, `timeout-minutes:`, `persist-credentials: false`, `pull_request_target`, script & `$GITHUB_ENV` injection, plus deterministic `--fix`.
  37. - **Rust AST & SemVer Diff**: Incremental `tree-sitter-rust` symbol & `unsafe` extractor + public API breaking-change diff against Git revisions.
  38. - **Supply Chain**: `cargo metadata` duplicate/MSRV/license auditor, CycloneDX 1.5 SBOM generator, SARIF 2.1.0 exporter, and DevSecOps repo hygiene scorer (`0–100`).
  39. - **`crates/vektor-state`**: SQLite WAL shared state (`.vektor/state.db`) for the Swarm Task Blackboard, advisory file locks with TTL, incremental AST symbol cache, and dirty-file tracking for selective `Stop` gates.
  40. - **`crates/vektor-cli`**: Single `vektor` binary exposing both MCP/hooks and a complete standalone DevSecOps CLI.
  41. - **`plugin/`**: Native Antigravity Plugin bundling 7 specialized subagents (`rust-expert`, `crates-specialist`, `security-auditor`, `gh-actions-engineer`, `github-maintainer`, `astro-expert`, `markdown-docs-expert`), orchestration skill, rules, `mcp_config.json`, and `hooks.json`.
  42. ---
  43. ## Installation & Quick Start
  44. ### 1. Install the binary
  45. ```bash
  46. # Via Homebrew (macOS & Linux — official GLASTOR tap)
  47. brew install glastor-core/tap/vektor
  48. # Via cargo-binstall (downloads prebuilt release binary with SLSA provenance)
  49. cargo binstall vektor-cli
  50. # Or build from source (MSRV 1.90)
  51. cargo install --path crates/vektor-cli
  52. ```
  53. ### 2. Initialize workspace & plugin
  54. ```bash
  55. # Generate starter vektor.toml and install the Antigravity plugin
  56. vektor init --install-plugin
  57. # Verify binary, toolchain, config, plugin, and repo hygiene
  58. vektor doctor
  59. ```
  60. ---
  61. ## CLI Reference
  62. Vektor works both as an Antigravity MCP/hook engine **and** as a standalone DevSecOps CLI for terminals and CI/CD pipelines:
  63. ```bash
  64. # Full DevSecOps audit (formats: pretty | markdown | json | sarif)
  65. vektor audit --format pretty
  66. vektor audit --format sarif --include-pii --fail-on high > vektor.sarif
  67. vektor audit --format markdown --fail-on low # Ideal for GitHub PR comments
  68. vektor audit --staged --fail-on high # Fast Git pre-commit secret check
  69. vektor audit --fix # Auto-harden missing GHA permissions/concurrency
  70. # PII Guard & TypeScript/Astro AST
  71. vektor pii --format pretty --fail-on high # Credit cards (Luhn), SSN, IBAN, emails
  72. vektor web-ast --exported --format markdown # .ts / .tsx / .astro AST + XSS/eval sinks
  73. # Supply-chain & Rust analysis
  74. vektor sbom --offline > sbom.cdx.json # CycloneDX 1.5 SBOM
  75. vektor deps --format markdown # Duplicates, MSRV conflicts, licenses
  76. vektor api-diff --base HEAD --fail-on-breaking # AST SemVer breaking-change gate
  77. vektor hygiene --min-score 90 --format pretty # 0-100 DevSecOps hygiene score
  78. # Diagnostics & reproducible latency benchmarks
  79. vektor doctor
  80. vektor bench --iterations 200
  81. ```
  82. ### Configuration (`vektor.toml`)
  83. Vektor automatically honors `.gitignore`, `.vektorignore`, and an optional workspace `vektor.toml`:
  84. ```toml
  85. [audit]
  86. respect_gitignore = true
  87. ignore_paths = ["target/", "node_modules/", "dist/", ".vektor/"]
  88. disabled_rules = []
  89. [secrets]
  90. entropy_threshold = 3.5
  91. [hooks]
  92. stop_gate = "selective" # "selective" | "full" | "off"
  93. ```
  94. ---
  95. ## MCP Tools & Resources
  96. | MCP Tool | Purpose | Annotations |
  97. | :--- | :--- | :--- |
  98. | `vektor_health` | Server status and active modules | `readOnly`, `idempotent` |
  99. | `vektor_workspace_info` | Cargo, Git, SQLite state, and GHA inventory | `readOnly`, `idempotent` |
  100. | `vektor_team_roster` | 7-expert specialist delegation matrix | `readOnly`, `idempotent` |
  101. | `vektor_cargo_audit_deps` | Duplicate crates, MSRV conflicts, licenses/copyleft | `readOnly`, `idempotent` |
  102. | `vektor_scan_secrets` | 16 provider rules + Shannon entropy scanner | `readOnly`, `idempotent` |
  103. | `vektor_scan_pii` | Sub-ms PII Guard (Luhn cards, SSN, IBAN, emails) | `readOnly`, `idempotent` |
  104. | `vektor_lint_gha` | GitHub Actions SHA pinning, permissions, injection, timeouts | `readOnly`, `idempotent` |
  105. | `vektor_rust_ast_query` | Incremental `tree-sitter-rust` symbol & `unsafe` index | `readOnly`, `idempotent` |
  106. | `vektor_web_ast_query` | `tree-sitter-typescript` AST & XSS/eval sink scanner (`.ts`, `.tsx`, `.astro`) | `readOnly`, `idempotent` |
  107. | `vektor_rust_api_diff` | AST SemVer public API breaking-change diff vs Git | `readOnly`, `idempotent` |
  108. | `vektor_sbom_cyclonedx` | CycloneDX 1.5 JSON SBOM generator | `readOnly`, `idempotent` |
  109. | `vektor_security_sarif` | Combined Secrets + Trojan Guard + GHA SARIF 2.1.0 | `readOnly`, `idempotent` |
  110. | `vektor_repo_hygiene` | DevSecOps repository hygiene auditor (0–100) | `readOnly`, `idempotent` |
  111. | `vektor_swarm_task` | Shared Swarm Task Blackboard (`list` / `upsert`) | local mutation |
  112. | `vektor_swarm_lock` | Advisory file locks (`list` / `acquire` / `release`) with TTL | local mutation |
  113. **MCP Resources**: `vektor://workspace/summary` and `vektor://swarm/tasks`.
  114. ---
  115. ## Verified Performance (`vektor bench`)
  116. Measured via `vektor bench --iterations 200` (even in an unoptimized debug build; release builds are faster still):
  117. | Operation | Average | p50 | p95 |
  118. | :--- | ---: | ---: | ---: |
  119. | `PreToolUse` hook (JSON → secret/Trojan scan → JSON) | `109.3 µs` | **`25.9 µs`** | **`44.1 µs`** |
  120. | GitHub Actions lint (hardened workflow) | `66.3 µs` | **`52.6 µs`** | **`54.6 µs`** |
  121. | Secrets + Trojan Guard scan (100-line Rust file) | `1.76 ms` | **`1.75 ms`** | **`1.81 ms`** |
  122. ---
  123. ## GLASTOR® Core Ecosystem
  124. Vektor integrates directly with sibling tools from **[glastor-core](https://github.com/glastor-core)**:
  125. - **[homebrew-tap](https://github.com/glastor-core/homebrew-tap)**: Official `brew install glastor-core/tap/vektor` distribution.
  126. - **[byte-gauge](https://github.com/glastor-core/byte-gauge)**: Audits the compiled Linux release binary in `release.yml` (`checksec` PIE/NX, entropy, size guard).
  127. - **[specter](https://github.com/glastor-core/specter)**: Runs polyglot AST API contract & Trojan Guard checks in `ci.yml`.
  128. - **[pii-veil](https://github.com/glastor-core/pii-veil)**: Inspires `vektor pii` / `vektor_scan_pii` sub-millisecond PII detection.
  129. - **[zerho](https://github.com/glastor-core/zerho)**: Inspires [llms.txt](llms.txt) for instant AI-agent onboarding.
  130. ---
  131. ## Contributing & Security
  132. - See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for architecture, module map, and threat model.
  133. - See [CONTRIBUTING.md](CONTRIBUTING.md) for local verification gates and coding standards.
  134. - See [CHANGELOG.md](CHANGELOG.md) for release history.
  135. - See [SECURITY.md](SECURITY.md) for responsible vulnerability disclosure.
  136. - Licensed under [MIT](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.