Skip to main content

t7 — Triple Seven agent

Threat model, verified fixes and proof for every change. Runs on the developer's machine and in your CI. Your source code never leaves your environment: Byteramp only receives an abstract architecture model and finding metadata (title, file:line, fix/proof results as hashes and pass/fail).

Get started (developer machine)

cd path/to/your-repository
curl -fsSL https://raw.githubusercontent.com/byteramp/triple-seven/main/install.sh | sh

or, if you prefer to install it yourself:

pipx install t7-agent                  # stdlib only, no third-party dependencies
cd path/to/your-repository
t7 setup

t7 setup does everything once per machine:

  1. Connects you to your organisation. Developers choose "I have a setup code" and enter their work e-mail and the code their organisation e-mailed them (valid 4 hours, once — "send me a new setup code" if it expired). No Triple Seven account needed. Administrators can instead sign in with their portal account in the browser.
  2. Stores one personal token for this machine in ~/.config/t7/credentials.json (mode 0600). It works in every repository of the organisation — the repository of each review is recognised from its git remote (only the URL, credentials stripped). Valid for 90 days and renews itself while you are on the organisation's roster and the subscription is active.
  3. Adds Triple Seven to your editors / AI assistants — VS Code (GitHub Copilot agent mode), Cursor, Windsurf, Claude Code, Codex — user-wide. No token is written into any editor config. In a new project folder without git it offers git init.

Then:

t7 scan                                # review your current branch + uncommitted work
t7 fix SEC-REQ-SHOP-004                # apply a verified fix and its regression test

…or ask your assistant: "review my change with Triple Seven".

A repository your organisation has not set up yet still works: it appears as discovered for your administrator. An active subscription is required for every review — in the terminal, the IDE and CI.

For administrators

Add your developers' e-mail addresses in the portal (Triple Seven → Developers, one or two thousand, paste or CSV). Each gets a personal setup code by e-mail. Removing someone revokes their tokens immediately. Connect CI per repository (Repositories → Connect); CI runs also teach Triple Seven each repository's canonical remote.

Command
t7 welcome and next step
t7 setup connect this machine (setup code, or --browser for administrators) and your editors; --code --email you@co.se non-interactive; --token to paste a repository token
t7 editors add Triple Seven to the editors on this machine; --show prints the configs
t7 status what this machine is connected to and token lifetime
t7 doctor check access, model, tests, editors
t7 scan [--all] review the change (or the whole repository)
t7 list / t7 fix ID fixes from the last scan / apply one
t7 logout remove the stored token for this repository

In your editor / AI assistant (MCP)

t7 setup registers t7 mcp (a Model Context Protocol server) for you. Tools: t7_scan, t7_findings, t7_explain, t7_show_fix, t7_apply_fix, t7_doctor. The server finds the open workspace itself (or the assistant passes repo_path).

  • VS Code + GitHub Copilot: Copilot Chat → Agent mode → ask. The analysis runs on your Copilot model via MCP sampling (VS Code asks once to allow it). Set T7_LLM to use another model.
  • Claude Code / Cursor / Windsurf / Codex: ask in chat. These clients do not offer sampling: the analysis uses Byteramp models (after your administrator's opt-in) or the provider you set with T7_LLM.

Manual configuration (if you skipped it): t7 editors --show.

Token lifetime

Token Lifetime Renewal
Developer (t7 setup) 90 days automatic, by t7, while you are on the roster and the subscription is active
CI (T7_TOKEN secret) 1 year portal → Repositories → Renew; the portal warns 30 days ahead

An expired or revoked developer token: run t7 setup → send me a new setup code.

GitHub Actions

# .github/workflows/triple-seven.yml
name: Triple Seven
on:
  pull_request:
  push:
    branches: [main]          # review coverage: which merges were reviewed
  issue_comment:
    types: [created]          # /t7 accept-risk | false-positive | not-applicable | reopen
permissions:
  contents: read
  pull-requests: write
  statuses: write             # the "Triple Seven" commit status carries the merge gate
jobs:
  t7:
    if: github.event_name != 'issue_comment' || startsWith(github.event.comment.body, '/t7')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - uses: byteramp/triple-seven@v0
        with:
          token: ${{ secrets.T7_TOKEN }}

Protect the branch on the Triple Seven commit status (not the job). A collaborator can clear a blocking finding from the PR with /t7 accept-risk SEC-REQ-… <reason> — the decision is recorded with an audit trail and the status flips to success. Each finding in the PR comment also has a ready prompt for Claude Code, Cursor, Codex or Copilot.

The PR comment and one-click suggested changes are posted with the runner's own GITHUB_TOKEN. Byteramp needs no access to your repository.

Models

T7_LLM Where code goes
byteramp Byteramp's own EU VPS models — requires opt-in in the portal; never forwarded to a cloud provider, never logged
azure Your Azure OpenAI deployment
openai Any OpenAI-compatible endpoint you choose
anthropic Your Anthropic account
ollama A model next to the agent (laptop / runner)

GitLab

Copy templates/gitlab-ci.yml into your .gitlab-ci.yml and add two masked CI/CD variables: T7_TOKEN (from the portal) and T7_GITLAB_TOKEN (a project access token, scope api, role Reporter, so t7 can comment on the merge request with one-click suggestions). Works with self-managed GitLab — CI_API_V4_URL is picked up automatically.

Any other CI (Bitbucket, Azure DevOps, Jenkins …)

See templates/generic-ci.sh: t7 scan --ci exits non-zero when an enforced merge gate blocks, and writes t7-report.md.

How a review runs

planner picks the chain for this diff → mapper builds the abstract architecture delta → Byteramp's threat model returns hypotheses → specialist analysts run in parallel (authz, injection, LLM, IaC, secrets/crypto, logic) → triage checks each hypothesis against the code → an adversarial critic tries to refute high/critical findings → fixer ⇄ verifier loop (isolated git worktree: applies, lint, types, independent re-check, test suite) → prover writes a regression test that must fail before and pass after the fix (L2) → noise budget → report. Every step streams to the portal timeline.

Verifying a release

Every release is Sigstore-signed with a CycloneDX SBOM and SLSA provenance — see RELEASING.md. Source is public so you can read exactly what runs on your code; what is sent to Byteramp is documented in SECURITY.md.

Metadata

Release files for t7-agent 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for t7-agent 0.3.0
File Size Uploaded Provenance Actions
t7_agent-0.3.0.tar.gz 74.8 kB With provenance Details for t7_agent-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for t7-agent 0.3.0
File Interpreter ABI Platform Actions
t7_agent-0.3.0-py3-none-any.whl Python 3 none any Details for t7_agent-0.3.0-py3-none-any.whl

Total release size: 149.7 kB

Release files / t7_agent-0.3.0.tar.gz

Download URL t7_agent-0.3.0.tar.gz
Size 74.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ee0d6a6bcb43d75f9ba088a569630f705fc55ca7764561294a1509d72cdb365e
BLAKE2b-256 checksum
How to use checksums
8e94b7fcd37127c818dbb3927fc6170bf3333dbabe746571fe5d49b5a9a35fc9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / t7_agent-0.3.0-py3-none-any.whl

Download URL t7_agent-0.3.0-py3-none-any.whl
Size 74.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
388080d4d4fc538946215c9eb80c9633d59ed8d20486a59960e1894e6c4b8c2d
BLAKE2b-256 checksum
How to use checksums
20693e26c24df64fd0bf106bc7cac1fc7b6baf0370a140267ef054785c23a156
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for t7-agent 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for t7_agent-0.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page