Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Tgctl Claude Channel

Telegram channel for Claude Code over the tgctl CLI — drive a persistent Claude Code session from Telegram, with sender-allowlist gating, a permission relay, and long-poll transport (no public endpoint).

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

PERMISSION_SHELL_DECLARED SECRETS_ENV_READ

Why this grade

  • PERMISSION_SHELL_DECLARED Note

    Runs shell commands, and the manifest or description says so.

    commandhook.go, line 47 out, err := exec.Command(bin, "list").Output()

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    main.go, line 46 offsetFile, legacyOffsetFile := resolveOffsetFile(stateDir, os.Getenv("TGCTL_CHANNEL_OFFSET_FILE"), os.Getenv("TGCTL_TOKEN"))

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Note

    requests shell access. The manifest names this permission.

    PERMISSION_SHELL_DECLARED

    commandhook.go, line 47

    out, err := exec.Command(bin, "list").Output()

    commandhook.go, line 81

    c := exec.CommandContext(ctx, h.bin, "run", name, args)

    commandhook.go, line 120

    c := exec.CommandContext(ctx, h.bin, "callback", cq.Data)

    Show more

    inbound.go, line 368

    cmd := exec.CommandContext(ctx, cfg.TgctlBin, args...)

    main.go, line 143

    out, err := exec.CommandContext(ctx, cfg.TgctlBin, "auth", "status", "-o", "json").Output()

    main.go, line 179

    cmd := exec.Command(t.bin, args...)

    main_test.go, line 67

    cmd := exec.CommandContext(ctx, os.Args[0], "-test.run=^TestChannelMainHelper$", "--", arg)

    main_test.go, line 118

    cmd := exec.CommandContext(ctx, os.Args[0], "-test.run=^TestChannelMainHelper$", "--")

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Pass

    No network call found.

  • Secrets

    Note

    reads an environment variable.

    SECRETS_ENV_READ

    main.go, line 46

    offsetFile, legacyOffsetFile := resolveOffsetFile(stateDir, os.Getenv("TGCTL_CHANNEL_OFFSET_FILE"), os.Getenv("TGCTL_TOKEN"))

    main.go, line 49

    BotToken: os.Getenv("TGCTL_TOKEN"),

    main.go, line 56

    InjectSecret: envOr("TGCTL_CHANNEL_INJECT_SECRET", os.Getenv("TGCTL_CHANNEL_SECRET")),

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Get the full report on this tool, £49

Note

Hygiene check of commit 738512e6c6dd. requests shell access. The manifest names this permission. reads an environment variable.

Date and source

Date checked:

View source

github.com

Commit graded: 738512e6c6dd33d5b2c0e7dec3edbca73adf68cd

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen