warp-command-runner AGENTS.md

A project instruction file for Warp Command Runner, a Swift command-line tool and MCP server that lets AI agents communicate with it through standard input/output or optional local HTTP. It defines project boundaries, coding rules, and required checks.

In plain words
What is it for?
Use it when changing, building, testing, or documenting the Warp Command Runner repository.
Why use it?
It keeps public identity, network binding, logs, credentials, and release claims within safe project limits, while ensuring documentation matches the built program.

Instructions file for CodexOpenCode

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 instructions/m-pineapple/warp-command-runner/agents-md
Clone the repo
git clone --depth 1 https://github.com/M-Pineapple/warp-command-runner

Made for: Codex, OpenCode.

Per session 645 This file is loaded in full into every session.
When invoked 645 The same file — it is already loaded in full.
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.00645 $0.00645
Opus 5 $0.00322 $0.00322
Sonnet 5 $0.00129 $0.00129
Haiku 4.5 $0.00064 $0.00064

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

Security

Grade A, and why

warp-command-runner AGENTS.md 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 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.

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.

AGENTS.md · 50 lines

How it starts

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

Warp Command Runner

Public MIT MCP server (Pineapple / M-Pineapple). Speaks MCP over stdio by default. Opt-in --http serves Streamable HTTP on 127.0.0.1 only. Users bring their own HTTPS tunnel. This project does not host a relay.

Done means the verification gate is green, docs match the binary, and the tree has no private identity.

Boundaries

  • Public identity is Pineapple / M-Pineapple only. No private-estate names, maintainer tunnels, or real hostnames in git. Sample origin: https://mcp.example.com.
  • --http binds loopback only. Never 0.0.0.0.
  • Stdio owns stdout. Logs go to stderr.
  • Do not commit tokens, tunnel credentials, or oauth-store.json.
  • No money-path. This is not a trading product.

Coding standards

SwiftPM CLI + MCP. Match existing files. ArgumentParser for flags. Agent workflow when driving this server: docs/AGENT_CODING_SOP.md.

Verification gate

Run from the repo root on macOS. Quote the summary lines. Triage every failure. There is no Xcode project; skip xcodebuild.

  1. swift package resolve && ./scripts/patch-swift-sdk.sh && swift build && swift test Green: Test Suite 'All tests' passed with 0 failures.
  2. swift build -c release Green: .build/release/warp-command-runner exists.
  3. Stdio MCP proof against that binary (not debug): ./examples/run_test.sh .build/release/warp-command-runner Green: initialize → Warp Command Runner v<version> and tools/list → 40 tools.
  4. Remote HTTP proof against the same binary: ./examples/run_http_test.sh .build/release/warp-command-runner Green: line LOOPBACK_OK and initialize version matching AppIdentity.version.
  5. Version: AppIdentity.version, .build/release/warp-command-runner --version, CHANGELOG [X.Y.Z], and README "What's new in vX.Y.Z" agree.

Known failures: none. ProcessRunnerTests.testTimeoutTerminatesHungProcess waits on a real hung child (timeout API), not a test sleep.

Whole-tree hazard: scripts/patch-swift-sdk.sh is required while pinned to swift-sdk 0.10.x. swift test without the patch fails to compile the SDK.

Read the full file on GitHub · 50 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 · 50 lines · 645 tokens per session scan A 62118e3bac14

Subscribe to this mod's changes

warp-command-runner AGENTS.md is an instructions file published in the GitHub repository M-Pineapple/warp-command-runner (17 stars, last pushed 5d ago), licensed MIT. It adds 645 tokens to every session, about $0.0032 per session on Opus 5. 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.

Related

Other instructions, from other repositories

happy AGENTS.md

Instructions for slopus/happy, covering agent workflow and sync to main.

slopus/happy · 82 tokens

the-unofficial-swift-concurrency-migration-skill CLAUDE.md

Instructions for kylehughes/the-unofficial-swift-concurrency-migration-skill, covering claude.md, repository purpose, build commands, generate the skill package and build options.

kylehughes/the-unofficial-swift-concurrency-migration-skill · 1,031 tokens

study-ios AGENTS.md

Instructions for ITlearning/study-ios, covering study-ios, skills, project structure and conventions.

ITlearning/study-ios · 170 tokens

ASD-AuDHD-PAI-Skills CLAUDE.md

Instructions for emory/ASD-AuDHD-PAI-Skills: You are the personal AI infrastructure of your user and this repository contains some Claude Skills that are intended to be used by someone that cares for or works with people with so-called "AuDHD" (ADHD+ASD), or other manifestation of pathological demand avoidance.

emory/ASD-AuDHD-PAI-Skills · 121 tokens

the-unofficial-swift-programming-language-skill CLAUDE.md

Instructions for Shada01245/the-unofficial-swift-programming-language-skill, covering claude.md, repository purpose, build commands, generate the skill package and build options.

Shada01245/the-unofficial-swift-programming-language-skill · 1,017 tokens

the-unofficial-swift-programming-language-skill AGENTS.md

Instructions for Shada01245/the-unofficial-swift-programming-language-skill, a project described as: 📦 Unlock the Swift Programming Language with this structured Skill for LLMs, providing complete access to essential Swift content.

Shada01245/the-unofficial-swift-programming-language-skill · 4 tokens