Skip to content

Security: vinhnx/VTCode

docs/SECURITY.md

Security Policy

We take the security of VT Code seriously. If you discover a security vulnerability, we appreciate your responsible disclosure and will work to address it promptly.

Reporting a Vulnerability

Please do not report security vulnerabilities through public GitHub issues.

Instead, please report security vulnerabilities via one of the following channels:

What to Include in Your Report

When reporting a security vulnerability, please provide us with the following information:

  • A brief description of the vulnerability and its potential impact
  • Steps to reproduce the issue (POC code is appreciated)
  • Affected versions (if known)
  • Any possible mitigations you've identified

What to Expect

  • Acknowledgment: We will acknowledge your report within 48 hours
  • Updates: We will provide regular updates on the status of the vulnerability and fix progress
  • Resolution: We will work to fix the vulnerability as quickly as possible and coordinate the release of the fix with you
  • Credit: We will publicly acknowledge your responsible disclosure (unless you prefer to remain anonymous)

Security Best Practices for Users

API Keys and Credentials

  • Never commit API keys, tokens, or other sensitive credentials to version control
  • Use environment variables for storing API keys instead of hardcoding them
  • Consider using .env files with proper gitignore configuration
  • Rotate your API keys regularly

Configuration Security

  • Keep your vtcode.toml configuration file secure and avoid sharing sensitive values
  • Regularly review your tool policies to ensure only necessary operations are allowed
  • Use secure connections when integrating with external services

System Security

  • Only run VT Code in trusted environments
  • Be cautious when executing code or commands suggested by the AI agent
  • Regularly update VT Code to the latest version to ensure you have the latest security patches

Supported Versions

Version Supported
0.31.x Latest
0.30.x Critical fixes only
< 0.30 No longer supported

Security Features

VT Code includes several built-in security features:

  • Path Validation: Prevents file system access outside the designated workspace
  • Tool Policies: Configurable allow/deny/prompt policies for different operations
  • PII Protection: Automatic tokenization of sensitive data in code execution
  • Token Management: Secure handling of API keys and authentication tokens

CI/CD Security Controls

VT Code enforces the following CI/CD security controls for GitHub Actions:

  • Forbidden trigger policy: pull_request_target and workflow_run are blocked by policy checks.
  • Immutable action pinning: every third-party and first-party action in workflows is pinned to a full 40-character commit SHA.
  • Workflow policy check in CI: scripts/check_workflow_security.sh runs in CI and can be run locally via ./scripts/check.sh workflow-security.
  • Least-privilege token permissions: workflows default to permissions: {} and grant only job-level minimum permissions.
  • Checkout credential hardening: all actions/checkout usage sets persist-credentials: false unless explicitly required.
  • Release credential isolation: publishing runs in the dedicated release deployment environment (with reviewer gate), rather than broad repository-level credential exposure.
  • No release-path cache: release workflows do not use dependency/build cache restore to reduce cache-poisoning exposure on publish paths.

Security Architecture

For information about VT Code's security architecture, please see our documentation on:

Additional Resources

Version Updates

We regularly update dependencies and monitor for security vulnerabilities in our dependencies. To check for known vulnerabilities in Rust dependencies, you can run:

# Install cargo-audit if you haven't already
cargo install cargo-audit

# Audit dependencies for known vulnerabilities
cargo audit

Contact

For general security questions or concerns, please contact us via the channels mentioned above.

Thank you for helping keep VT Code and its users safe!

There aren’t any published security advisories