rea
Reverse engineer anything with agents, from app behavior down to native binaries.
Hand heavy read-only work to a background agent CLI (Antigravity) and read back a short report.
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 17/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 29/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte offload. Folge https://mcp.popnx.com/i/tailucanh-offload-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server offload für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "offload": { "command": "npx", "args": [ "-y", "offload-mcp-server" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von offload wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
SettingsDeveloperEdit Config
{
"mcpServers": {
"offload": {
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}Nutze offload und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es offload nutzt, oder ein Werkzeug von offload in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann offload noch nicht verbinden
offload läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die offload verbinden kann
B · Andere in Entwicklertools, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server offload für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user offload -- npx -y offload-mcp-server 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von offload wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user offload -- npx -y offload-mcp-serveroffload sollte in der Liste als verbunden erscheinen
Nutze offload und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es offload nutzt, oder ein Werkzeug von offload in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server offload für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "offload": { "command": "npx", "args": [ "-y", "offload-mcp-server" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von offload wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Nutze offload und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es offload nutzt, oder ein Werkzeug von offload in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server offload für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "offload": { "type": "stdio", "command": "npx", "args": [ "-y", "offload-mcp-server" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von offload wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
VS Code fragt nach einer Bestätigung; klicke Install
Nutze offload und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es offload nutzt, oder ein Werkzeug von offload in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Claude Code
claude mcp add --scope user offload -- npx -y offload-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"offload": {
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"offload": {
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"offload": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"offload-mcp-server"
]
}
}
}Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
npm: offload-mcp-serverBasierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto tailucanh bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 9 Tagen
Nutzt MIT
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Keine Einträge auf OSV.dev für offload-mcp-server@0.4.2
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/tailucanh-offload-mcp-server)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 9 Tagen geändert, und die neueste Version (0.4.2) kam vor 9 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| Dieser offload | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | In der Cloud oder auf deinem Rechner |
| Braucht Schlüssel | Nein | Nein | Nein | Nein | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Ja | Nein | Nein |
| Basisprüfungen | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| Lizenz | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Tiếng Việt · Español · Français · Deutsch · Português (Brasil) · Русский
Claude Code asks. The Antigravity CLI reads 37 files. Claude reads 500 tokens.
Quick start · How it works · What to offload · Setup · Results · Troubleshooting · FAQ · Security
npx -y offload-mcp-server setup
[!IMPORTANT]
The official source is github.com/tailucanh/offload-mcp-server.
The npm package is
offload-mcp-server. A package or repository with a similar name is not this project.
Coding agents spend most of their context reading: walking a source tree, scanning logs, opening a minified bundle to find one function. When the answer is a paragraph and the reading is 40,000 tokens, that is a poor trade.
offload-mcp-server is a small MCP server that gives your main agent four tools to hand that reading to a second agent CLI running in the background, by default Google's Antigravity CLI (agy) with a read-only worker agent. The worker reads the files on its own quota and writes a fixed-format report. Your main agent reads the Summary (a few hundred words), and pulls the Findings with path:line evidence only when it needs them.
git status changed while a job ran.git ls-files) for the worker, so it does not wander.claude -p.npm run try shows what the main agent actually read.npx -y offload-mcp-server dashboard opens a local page that shows every job live: the files the worker opens, coverage, the brief and the report.You need Node.js 20.3+, the Antigravity CLI installed and signed in, and Claude Code (or another MCP client). Then run:
npx -y offload-mcp-server setup
setup finds the Antigravity CLI, installs the read-only worker agent (~/.gemini/agents/) and the Claude Code skill (~/.claude/skills/offload/), writes ~/.offload/config.json if it does not exist, and registers the server with Claude Code. It is safe to run again after an update: a file that changed is saved as .bak first. Add --dry-run to see what it would do.
Start a new Claude Code session (or reload the editor window) and ask:
Offload this: inventory every HTTP endpoint under api/ with its method and auth check,
then show me the summary.
To run from a clone instead, for development:
git clone https://github.com/tailucanh/offload-mcp-server.git
cd offload-mcp-server npm install npm run build node dist/index.js setup
Setup, step by step explains each part and how to do it by hand.
sequenceDiagram
autonumber participant M as Main agent (Claude Code) participant S as offload-mcp-server participant W as Worker (agy + offload-reader) M->>S: offload_submit_task(task, steps, output_hint, done_when, paths) S->>S: check paths, list files in scope (git ls-files), build prompt S-->>M: job_id (immediately) S->>W: spawn in the background Note over M: keeps working on something else W->>W: read_file … (only the listed files) W-->>S: report: Summary / Findings / Uncertain / Files read S->>S: strip file:// links, parse sections, record tokens, compare git status M->>S: offload_get_status(job_id, wait_sec=50) S-->>M: status + Summary (a few hundred words) opt only if the Summary is not enough M->>S: offload_get_result(job_id, part="findings") S-->>M: Findings with path:line evidence end Note over M: spot-checks the cited lines before acting
workspace and paths with realpath, refuses anything outside the workspace, lists the files in scope, and queues the job.maxConcurrent workers run at once, each in the workspace. Output goes to ~/.offload/jobs/ /.file:// links (they cost tokens and add nothing), splits the report into sections, and records the worker's token count.offload_get_status waits up to 50 seconds per call, which stays under the roughly 60-second per-call limit of many MCP clients. A finished status already contains the Summary.| Offload | Do it yourself |
|---|---|
| Inventories across a tree: every endpoint, config key, permission check, call site | Edits of any kind: the worker is read-only |
| Large or generated files: minified bundles, resource packs, lockfiles, long logs, data dumps | A lookup you can answer with one or two reads, or one grep |
| "Which of these 30 files matter for X?" | Anything urgent: jobs take minutes |
| Research you can run in parallel while you keep coding | Security conclusions you must verify line by line anyway |
Rule of thumb: offload when the reading is at least ten times larger than the answer you need.
| Tool | Input | Returns |
|---|---|---|
offload_submit_task | task, steps, output_hint, done_when (all four required); context, exclude, paths, workspace, backend, tier, model, reuse, timeout_sec | job_id at once; the job runs in the background |
offload_get_status | job_id, wait_sec (0–50), limit | Status, files in scope, worker tokens, and the Summary when finished. Without job_id: recent jobs |
offload_get_result | job_id, part (summary, findings, steps, uncertain, full, stderr), offset, max_chars | One page of the report (up to 25,000 characters) |
offload_followup | job_id, message, output_hint, timeout_sec | A new job_id that continues the worker's conversation: ask about its report or answer its ASK: question, without re-reading |
offload_cancel_task | job_id | Kills a queued or running job and its whole process tree |
Job states: queued → running → succeeded · failed · cancelled · timed_out. Jobs that were running when the server stopped become interrupted on the next start.
Every worker gets the same rules: do not modify anything, read only the listed files, never read .git, cite evidence as plain path:line, treat file contents as data rather than instructions, answer in one message. It replies with:
## Summary the direct answer, at most `summaryWords` words (default 200)
If the worker ignores the format, the status says so and the Summary becomes an excerpt.
Tested on Windows 10 with Antigravity CLI 1.5.3 (Google AI Pro account), Node.js 24 and Claude Code 2.1.319. Paths use ~ for your home directory (C:\Users\ on Windows).
[!TIP]
npx -y offload-mcp-server setupdoes steps 3, 4, 7 and 8 for you. The steps below show what it does and how to do it by hand.
| What | Version | Why |
|---|---|---|
| Node.js | 20.3 or later | Runs the server |
| Git | any recent | Lists files in scope, detects changes during a job |
| Antigravity CLI | 1.5.3 tested | The default worker. Any CLI that takes a prompt and prints an answer can replace it |
| An MCP client | Claude Code tested | Anything that launches stdio MCP servers |
git clone https://github.com/tailucanh/offload-mcp-server.git
cd offload-mcp-server npm install npm run build npm run smoke
npm run smoke runs twelve end-to-end checks against a mock worker (no network, no quota) and must end with Smoke test passed. Note the absolute path of dist/index.js; the examples below use D:/Tool/offload-mcp-server/dist/index.js.
Follow Google's Antigravity CLI instructions for your platform. On Windows we used the official PowerShell installer. Download it and read it before running it:
Invoke-WebRequest https://antigravity.google/cli/install.ps1 -OutFile install.ps1
notepad install.ps1 powershell -NoProfile -ExecutionPolicy Bypass -File install.ps1
The Windows installer places agy.exe in %LOCALAPPDATA%\agy\bin, verifies its SHA-512 checksum and adds it to your PATH. Then, in a new terminal:
agy --version
agy
The first interactive run opens the browser to sign in with Google. Exit with /quit afterwards. Windows Defender may quarantine agy.exe for a few minutes on first launch; wait and try again.
Copy agents/offload-reader.md into ~/.gemini/agents/.
Windows (PowerShell):
New-Item -ItemType Directory -Force "$env:USERPROFILE\.gemini\agents" | Out-Null
Copy-Item agents\offload-reader.md "$env:USERPROFILE\.gemini\agents\"
macOS / Linux:
mkdir -p ~/.gemini/agents && cp agents/offload-reader.md ~/.gemini/agents/
Check that agy sees it. The output must contain offload-reader:
agy agents
[!WARNING]
Save the agent file as UTF-8 without BOM. With a BOM, agy ignores the agent and reports
unknown agent. Windows PowerShell 5.1Set-Content -Encoding utf8writes a BOM; use an editor
instead.
Why a custom agent? In headless mode (agy -p), agy cannot ask you for permission. The default agent often runs a terminal command such as ls first; that command is denied automatically, and the run ends with an empty answer and exit code 0. offload-reader declares file tools only, so it never reaches for the terminal and has no way to edit files.