LobsterAI is an open-source desktop AI agent that operates files, commands, browsers, documents, spreadsheets, slides, messaging channels, and scheduled jobs in a user's working environment. It supports office work, research, and custom multi-agent workflows, while catalogue add-ons extend the agent with additional skills and workflows.
Borrowing it
Nothing to install: this file belongs to netease-youdao/LobsterAI. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/netease-youdao/LobsterAI/main/AGENTS.mdgit clone --depth 1 https://github.com/netease-youdao/LobsterAIWrote 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.
[](https://agentmods.dev/instructions/netease-youdao/lobsterai/agents-md)<a href="https://agentmods.dev/instructions/netease-youdao/lobsterai/agents-md"><img src="https://agentmods.dev/badge/instructions/netease-youdao/lobsterai/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.
<a href="https://agentmods.dev/instructions/netease-youdao/lobsterai/agents-md"><img src="https://agentmods.dev/badge/instructions/netease-youdao/lobsterai/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.05025 | $0.05025 |
| Opus 5.5 | $0.02010 | $0.02010 |
| Sonnet 5.5 | $0.01005 | $0.01005 |
| Haiku 4.5 | $0.00502 | $0.00502 |
Grade A, and why
LobsterAI 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 13d 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.
How it starts
The opening of the file, as written. The whole thing — 533 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
This file gives coding agents the current working model for this repository.
Treat source code and package.json as the authority when something here
appears stale.
Instruction Scope
This root AGENTS.md is repository-level guidance for LobsterAI. Codex may also
load more specific AGENTS.md or AGENTS.override.md files from subdirectories
when the current working directory is inside those subtrees. More specific
instructions override broader ones.
Do not treat generated runtime workspaces, bundled OpenClaw output, or old Claude memory notes as authoritative project instructions. Use them only as historical context and verify against the current source.
Project Snapshot
LobsterAI is an Electron + React desktop application. Its core user-facing product is a desktop agent experience that can work with local projects, files, browser previews, IM channels, skills, MCP servers, scheduled tasks, and rich artifacts.
Cowork vs OpenClaw
Cowork is LobsterAI's product/session layer. The name is historical: it
started as a Claude Code-like in-house coding assistant, but in the current
codebase it means the LobsterAI layer that owns sessions, messages,
permissions, UI state, local persistence, context usage, artifacts, and IPC
contracts.
OpenClaw is the only agent runtime/gateway. CoworkAgentEngine is currently
'openclaw' only. Legacy names such as cowork:* IPC channels,
claude_session_id, and some "cowork" filenames are compatibility/history
names, not evidence of another active runtime.
Do not reintroduce or design around yd_cowork; it has been removed as a
runtime. If old docs mention it as switchable, verify against current source
before acting.
Commands
# First development run: build/sync the pinned OpenClaw runtime, then start app
npm run electron:dev:openclaw
# Daily development after runtime exists: Vite on port 5175 + Electron
npm run electron:dev
# Production renderer bundle
npm run build
# Electron main/preload TypeScript build
npm run compile:electron
# Full ESLint across src; may fail on existing legacy debt
npm run lint
# CI-equivalent lint for touched TypeScript files
npx eslint --ext ts,tsx --report-unused-disable-directives --max-warnings 0 <files>
# Official test entry used by GitHub CI
npm test
# Filter Vitest tests
npm test -- logger
npm test -- cowork
# Package for distribution
npm run dist:mac
npm run dist:win
npm run dist:linux
# Windows installer gate (runs automatically at the start of dist:win and the
# dist:win:web stub pass): re-applies patches/app-builder-lib+*.patch and runs
# the installer contract tests against node_modules. If it fails, run `npm ci`;
# never ship an installer from a tree where it fails.
npm run verify:installer-patches
# Build current-platform OpenClaw runtime manually
npm run openclaw:runtime:host
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.
- 13d ago Changed · +9 lines · +139 tokens per session e9fecbc9f3f7
- 1mo ago First seen · 524 lines · 4,886 tokens per session scan A 19cc0b867c12
LobsterAI AGENTS.md is an instructions file published in the GitHub repository netease-youdao/LobsterAI (6,150 stars, last pushed today), licensed MIT. It adds 5,025 tokens to every session, about $0.0201 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.
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).
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.
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).
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.
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).
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.