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.
npx agentmods add agents/distsystem/codex-desktop-linux/generated-and-runtime-notesgit clone --depth 1 https://github.com/distsystem/codex-desktop-linuxWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.01041 |
| Opus 5 | $0.00000 | $0.00521 |
| Sonnet 5 | $0.00000 | $0.00208 |
| Haiku 4.5 | $0.00000 | $0.00104 |
Grade A, and why
generated-and-runtime-notes scanned grade A with 1 finding 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 yesterday.
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.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
- `python3`, `7z`, `curl`, `unzip`, `tar`, `make`, and `g++` are required for How it starts
The opening of the file, as written. The whole thing — 94 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Generated Artifacts And Runtime Notes
This document collects the detailed generated-output and runtime-state notes that agents need without keeping them in the main quick-start.
Generated Artifacts
codex-app/Generated Linux app directory. Treat as build output.codex-app-next/Side-by-side rebuild candidate fromscripts/rebuild-candidate.sh.codex-*-app/Alternate identity app directories, such ascodex-cua-lab-app/.dist/Native package and AppImage outputs.dist/appimage.AppDir/Generated AppImage staging tree.dist-next/rebuild/Rebuild candidate reports.target/Rust build output for all workspace crates.Codex.dmgCached upstream DMG.linux-features/features.jsonGitignored local opt-in feature config.linux-features/local/Gitignored user-local feature directory.codex-app/.codex-linux/linux-features-staged.jsonStaged declarative feature ownership manifest.~/.config/codex-update-manager/config.tomlRuntime updater config.~/.local/state/codex-update-manager/state.jsonUpdater state-machine persistence.~/.local/state/codex-update-manager/service.logUpdater service log.~/.cache/codex-update-manager/Downloaded DMGs, rebuild workspaces, staged package artifacts, and build logs.~/.cache/codex-desktop/launcher.logLauncher log for the default app identity.~/.local/state/codex-desktop/app.pidandwebview.pidLauncher liveness files.$XDG_RUNTIME_DIR/codex-desktop/launch-action.sockWarm-start handoff socket.
Runtime Notes
- DMG extraction can warn when
7zcannot materialize the/Applicationssymlink. This is acceptable if a.appbundle was extracted successfully. - The managed Node.js runtime is installed under
codex-app/resources/node-runtime/. Override only withCODEX_MANAGED_NODE_VERSION,CODEX_MANAGED_NODE_URL, andCODEX_MANAGED_NODE_SHA256; the SHA must be set when overriding version or URL. - GUI launchers often do not inherit shell
PATH. The generated launcher searches common Codex CLI andnvmlocations and respectsCODEX_CLI_PATH. - CLI preflight is launcher-scoped and best-effort. It can prompt to install or update the Codex CLI, but failures should warn rather than block app launch.
- ASAR patches are fail-soft unless intentionally marked required. Each patch should be idempotent and report warnings when upstream drift prevents a needle from matching.
- Patch reports are written for installs/rebuilds. Upstream-build CI fails only for required upstream patches that are missing or skipped.
- Linux Computer Use plugin registration is default-on platform port glue, but Computer Use UI enablement remains opt-in and must not bypass upstream server-side rollouts unrelated to local Linux support.
- The Linux Chrome integration stages the bundled Chrome plugin, native host, marketplace metadata, and browser profile/native-host diagnostics for Chrome, Brave, and Chromium. Do not fix only the user cache; patch staged bundled resources.
- The generated launcher starts the local webview server before Electron and
verifies the expected startup markers. See
docs/webview-server-evaluation.mdbefore changing the server model. - Warm-start handoff uses a Unix-domain socket under
$XDG_RUNTIME_DIRso second launches can send actions to the running app. - Native package install/removal hooks start, stop, disable, and reload the
systemd --userupdater service on a best-effort basis. - Failed privileged updater installs stay failed until a newer rebuild or an explicit retry path; avoid auto-retrying every reconcile cycle.
- Manual rollback uses the last-known-good package recorded in updater state and the same format-specific command layer as normal installs.
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.
- yesterday First seen · 94 lines · 0 tokens per session scan A 4c45933b9c52
generated-and-runtime-notes is an agent published in the GitHub repository distsystem/codex-desktop-linux (11 stars, last pushed 1mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,041 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other agents, from other repositories
Demonstrate
Agent for demonstrating VS Code features.
playwright-test-generator
Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.
.NET-Notebook-Migration-Agent
Expert .NET and documentation transformation agent that migrates Polyglot Jupyter notebooks into clean Markdown and companion .NET sample code.
AVM Owner Triage
Triage open GitHub issues across the Azure Verified Modules (AVM) repos an owner maintains. Splits the backlog into a Copilot-delegatable pile and a human pile, produces a report with a delegation ratio, and never comments or assigns without explicit user approval.
Ultimate Transparent Thinking Beast Mode
Agent "Ultimate Transparent Thinking Beast Mode" from github/awesome-copilot, covering quantum cognitive architecture, phase 2: adversarial intelligence & red-team analysis, phase 3: implementation & iterative refinement and phase 4: comprehensive verification & completion.
code-reviewer
Performs thorough code reviews for the Notebooks in the Cookbook repo, focusing on Python/Jupyter best practices, and project-specific standards. Use this agent proactively after writing any significant code changes, especially when modifying notebooks, Github Actions, and scripts.