lpm: Instructions file for Codex

AGENTS.md

lpm AGENTS.md is an instructions file for Codex, OpenCode from gug007/lpm. It costs 1,431 tokens per session, scanned A, original, MIT.

A project guide for lpm, a macOS app and command-line tool that manages local development projects and runs AI coding agents beside their services.

In plain words
What is it for?
Use it when changing lpm's desktop app, Rust command-line tool, iOS companion, or website, especially when adding files or platform-specific code.
Why use it?
It keeps contributors aligned on the project's layout, coding rules, platform boundaries, and versioning requirements.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is gug007/lpm's own configuration. It tells Codex and OpenCode how to work on lpm itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything lpm configures →

Reuse

Borrowing it

Nothing to install: this file belongs to gug007/lpm. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/gug007/lpm/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/gug007/lpm

Made for: Codex, OpenCode.

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 lpm AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/gug007/lpm/agents-md/github.svg)](https://agentmods.dev/instructions/gug007/lpm/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/gug007/lpm/agents-md"><img src="https://agentmods.dev/badge/instructions/gug007/lpm/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for lpm AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/gug007/lpm/agents-md"><img src="https://agentmods.dev/badge/instructions/gug007/lpm/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,431 This file is loaded in full into every session.
When invoked 1,431 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.01431 $0.01431
Opus 5.5 $0.00572 $0.00572
Sonnet 5.5 $0.00286 $0.00286
Haiku 4.5 $0.00143 $0.00143

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

Security

Grade A, and why

lpm 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 · 81 lines

How it starts

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

Agent Guide — lpm

lpm starts, stops, duplicates, and switches between local dev projects, with a built-in terminal for running AI coding agents alongside services. The desktop app runs on macOS, Linux and Windows.

Layout

  • desktop/frontend/ — Tauri 2 desktop app: React/TypeScript UI in src/, Rust backend in src-tauri/
  • cli/ — Rust CLI (lpm)
  • mobile/ — lpm Link, the phone companion apps:
    • PROTOCOL.md — the wire contract both apps implement
    • shared/web/ — xterm.js terminal and markdown pages, bundled into both apps' WebViews
    • ios/ — iOS app (SwiftUI); .xcodeproj is generated — run xcodegen generate in mobile/ios after adding files
    • android/ — Android app (Kotlin, Compose, Hilt, Navigation 3; modules built from the build-logic convention plugins). In mobile/android run ./gradlew spotlessApply, then ./gradlew check assembleRelease. It's a port of the iOS app on Google's architecture recommendations: read mobile/android/PORTING.md first
    • parity/ — the same Maestro flows on both apps in an iPhone simulator and an Android emulator, with a side-by-side report (node mobile/parity/parity.js all --open)
  • website/ — Next.js marketing site (lpm.cx). Every interactive demo on it is the desktop UI itself in an iframe: desktop/frontend/src/demo answers its commands from sample data in memory and plays each page's tour against the real UI (npm run dev:demo in desktop/frontend, ?seed=sample for the sample workspace), built into website/public/demo-app
  • relay/ — Cloudflare Worker that lets a browser join a shared tab: a Durable Object room per share, forwarding Noise-encrypted messages, and the guest page (lpm-share-relay.lpm-share-relay.workers.dev). npm run dev / npm test / npm run deploy; see its README
  • tailnet/ — built-in Tailscale (Go, tsnet): cmd/lpm-tailnet is the desktop sidecar (scripts/build-tailnet.mjs), ios/ the static library lpm Link links (mobile/ios/build-tailnet.sh). Needs Go (brew install go)

Read the full file on GitHub · 81 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 Changed · +7 lines · +129 tokens per session bd726927d7bc
  2. 4d ago Changed · +3 lines · +74 tokens per session 5e27f0e76cf2
  3. 5d ago Changed · +1 lines · +31 tokens per session 0195042ffcba
  4. 6d ago Changed · +13 lines · +262 tokens per session 399a22c80902
  5. 11d ago Changed · +7 lines · +129 tokens per session 488e3b200d73
  6. 12d ago Changed · +5 lines · +32 tokens per session 825943aeebbe
  7. 15d ago Changed · +4 lines · +90 tokens per session 90e27c1db8af
  8. 17d ago Changed · +13 lines · +271 tokens per session 40b19a0d8c8d
  9. 1mo ago First seen · 28 lines · 413 tokens per session scan A 1f6fde5def6a

Subscribe to this mod's changes

lpm AGENTS.md is an instructions file published in the GitHub repository gug007/lpm (145 stars, last pushed today), licensed MIT. It adds 1,431 tokens to every session, about $0.0057 per session on Opus 5.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

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,549 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens