use-with-cursor

use-with-cursor is an agent for coding agents from ThreeMoonsLab/agents-shipgate. It costs 0 tokens per session (2,167 once invoked), scanned A, original, Apache-2.0.

A compatibility guide for using Shipgate with Cursor, a code editor with an AI assistant. It describes a project rule that automatically tells Cursor when to run Shipgate on relevant files.

In plain words
What is it for?
Use it to add the Shipgate rule to Cursor, check agent-tool changes, and connect Cursor's project instructions with the repository's verification process.
Why use it?
It reduces the chance that Cursor misses checks when a conversation changes agent tools, API descriptions, or Python files. It also explains how to follow Shipgate's structured control results.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/threemoonslab/agents-shipgate/use-with-cursor
Clone the repo
git clone --depth 1 https://github.com/ThreeMoonsLab/agents-shipgate

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for use-with-cursor

README.md
[![agentmods](https://agentmods.dev/badge/agents/threemoonslab/agents-shipgate/use-with-cursor.svg)](https://agentmods.dev/agents/threemoonslab/agents-shipgate/use-with-cursor)
Your own site
<a href="https://agentmods.dev/agents/threemoonslab/agents-shipgate/use-with-cursor"><img src="https://agentmods.dev/badge/agents/threemoonslab/agents-shipgate/use-with-cursor.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,167 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.02167
Opus 5 $0.00000 $0.01084
Sonnet 5 $0.00000 $0.00433
Haiku 4.5 $0.00000 $0.00217

Measured 4d ago against content hash 1e1e167ac058, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

use-with-cursor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

docs/agents/use-with-cursor.md · 166 lines

How it starts

The opening of the file, as written. The whole thing — 166 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Use Agents Shipgate with Cursor

This page is the compatibility guide for Cursor rules. For the normative agent protocol, use cursor.md and protocol.md. The canonical Cursor control command is:

shipgate check --agent cursor --workspace . --format agent-boundary-json

Parse stdout as shipgate.agent_boundary_result/v2, switch on control.state, and follow control.next_action, control.allowed_next_commands, and control.human_review. Treat decision as diagnostic context only; do not infer local control from prose.

Cursor's discoverability surface is the auto-attach project rule: a Markdown file under .cursor/rules/*.mdc with frontmatter that lists which globs cause it to attach to a chat. The canonical Shipgate rule already exists as a copy-paste snippet — drop it in and Cursor will load it whenever a chat touches shipgate.yaml, an OpenAPI/MCP spec, a tools JSON, or any .py file.

Surface What it does Source path in this repo
.cursor/rules/agents-shipgate.mdc Auto-attaches to chats that touch agent-tool surfaces. Tells Cursor when and how to run Shipgate. docs/target-repo-agent-snippets.md §.cursor/rules/agents-shipgate.mdc
Reusable prompts Cursor reads pasted Markdown directly in chat / composer (Cmd+L). Copy the body of any prompts/*.md recipe. prompts/README.md

Cursor's rule mechanism is analogous to Claude Code's skill auto-trigger, not to a slash command. It fires when the chat context matches the rule's globs — there is no manual invocation step.


Install Agents Shipgate

From the root of your agent project:

pipx install agents-shipgate
agents-shipgate self-check --json

See AGENTS.md §Install for fallbacks (pip, uv, python -m).


Drop in the Cursor rule

Open docs/target-repo-agent-snippets.md and copy the .cursor/rules/agents-shipgate.mdc snippet (the second-to-last fenced block, under §.cursor/rules/agents-shipgate.mdc) into your repo at exactly that path:

Read the full file on GitHub · 166 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 166 lines · 0 tokens per session scan A 1e1e167ac058

Subscribe to this mod's changes

use-with-cursor is an agent published in the GitHub repository ThreeMoonsLab/agents-shipgate (87 stars, last pushed today), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 2,167 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.