cursorrules

A set of project rules for working on the FastLED codebase with Cursor, including how Python commands must be run.

In plain words
What is it for?
Use it to guide coding agents during FastLED development, especially when they need to run Python-based tests, builds, or tools.
Why use it?
It prevents agents from using disallowed commands and makes build, test, and analysis work follow the project's stated process.

Cursor rule for Cursor

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 rules/mangome/cybird-watching/cursorrules
Clone the repo
git clone --depth 1 https://github.com/Mangome/cybird-watching

Made for: Cursor.

Per session 24,977 This file is loaded in full into every session.
When invoked 24,977 The same file โ€” it is already loaded in full.
Security scan B 2 findings. Scan, not verified.
Origin 95% copy Near-identical to another mod 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.24977 $0.24977
Opus 5 $0.12488 $0.12488
Sonnet 5 $0.04995 $0.04995
Haiku 4.5 $0.02498 $0.02498

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

Security

Grade B, and why

cursorrules scanned grade B with 2 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 2d 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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo apt-get update

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

result = subprocess.run(['git', 'status'], capture_output=True, text=True)
Origin

This is a copy

95% identical to cursorrules โ€” 132 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

lib/FastLED/.cursorrules ยท 2,793 lines

How it starts

The opening of the file, as written. The whole thing โ€” 2,793 lines โ€” stays where its author put it; the contents beside it link to each section on GitHub.

FastLED Project Rules for Cursor

๐Ÿšจ CRITICAL: PYTHON EXECUTION REQUIREMENTS - NO EXCEPTIONS! ๐Ÿšจ

MANDATORY COMMAND EXECUTION RULES - ALL AGENTS MUST FOLLOW

๐Ÿšจ ABSOLUTELY FORBIDDEN: Direct python/python3 execution

  • โŒ NEVER use: python3 <command>
  • โŒ NEVER use: python <command>
  • โŒ NEVER use: ./python
  • โŒ NEVER use: Direct Python interpreter calls

โœ… MANDATORY: Always use uv run

  • โœ… ALWAYS use: uv run python <command>
  • โœ… ALWAYS use: uv run python -c "..."
  • โœ… ALWAYS use: uv run python script.py

NO EXCEPTIONS - ALL PYTHON CODE MUST RUN THROUGH UV:

# โœ… CORRECT - Use uv run python
uv run python test.py
uv run python ci/ci-compile.py uno --examples Blink
uv run python -c "from ci.ci.module import func; func()"
uv run python ci/ci/build_info_analyzer.py --board uno --show-defines

# โŒ FORBIDDEN - Direct python execution
python3 test.py                    # NO!
python ci/ci-compile.py            # NO!
python3 -c "import something"      # NO!
python3 script.py                  # NO!

THIS RULE APPLIES TO:

  • ๐Ÿšจ All test execution
  • ๐Ÿšจ All script execution
  • ๐Ÿšจ All build commands
  • ๐Ÿšจ All analysis tools
  • ๐Ÿšจ All development commands
  • ๐Ÿšจ ALL Python code execution without exception

WHY: The project uses UV for dependency management and execution environment. Direct python3 calls bypass the controlled environment and may use wrong Python versions or missing dependencies.

ENFORCEMENT: Any agent using direct python3/python commands is in violation of project requirements.

๐Ÿšจ UV RUN MANDATE - FINAL WARNING ๐Ÿšจ

IF YOU SEE ANY COMMANDS IN THIS PROJECT DOCUMENTATION THAT USE python3 OR python DIRECTLY:

  1. ๐Ÿšซ DO NOT COPY THEM - They are legacy commands that must be updated
  2. โœ… ALWAYS REPLACE python3 with uv run python
  3. โœ… ALWAYS REPLACE python with uv run python
  4. ๐Ÿ“ UPDATE DOCUMENTATION when you find python3 commands

EXAMPLES OF MANDATORY REPLACEMENTS:

# โŒ If you see this in docs (WRONG):
python3 script.py

# โœ… Always use this instead (CORRECT):
uv run python script.py

# โŒ If you see this in docs (WRONG):  
python -c "import something"

# โœ… Always use this instead (CORRECT):
uv run python -c "import something"

Read the full file on GitHub ยท 2,793 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. 2d ago First seen ยท 2,793 lines ยท 24,977 tokens per session scan B d8b3afca342b

Subscribe to this mod's changes

cursorrules is a cursor rule published in the GitHub repository Mangome/cybird-watching (51 stars, last pushed 8mo ago), licensed MIT. It adds 24,977 tokens to every session, about $0.1249 per session on Opus 5. A static security scan graded it B with 2 findings (asks for root, runs shell commands). It is 95% identical to cursorrules, differing in 132 lines, and is treated as a copy.