What is Undefined AGENTS.md?

A set of repository instructions for Undefined, a Python project with desktop chat and management applications. It describes the source layout, development commands, tests, coding conventions, and included tools.

Use it when navigating the repository, installing dependencies, building the applications, running tests, editing modules, or working with its submodule and generated data.

It gives a coding agent the project-specific rules it needs before changing or checking the code.

Undefined AGENTS.md — Instructions file by 69gg

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/69gg/undefined/agents-md

Clone the repo

git clone --depth 1 https://github.com/69gg/Undefined

Made for: Codex, OpenCode.

Per session 1,690 This file is loaded in full into every session.

When invoked 1,690 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.

Model	Per session	Once invoked
Fable 5	$0.01690	$0.01690
Opus 5	$0.00845	$0.00845
Sonnet 5	$0.00338	$0.00338
Haiku 4.5	$0.00169	$0.00169

Measured yesterday against content hash 65e6c644f311, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Undefined 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 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.

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 · 52 lines

How it starts

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

Repository Guidelines

Project Structure & Module Organization

src/Undefined/ contains the main runtime package. Core areas include ai/, services/, skills/, cognitive/, memes/, knowledge/, api/, webui/, config/, mcp/, and automations/ (AutomationService runtime plus JSON storage); media-facing integrations live in arxiv/, bilibili/, github/, and attachments.py. tests/ holds the pytest suite. apps/undefined-console/ is the Tauri + Vite management client and apps/undefined-chat/ is the native-first Tauri + React 19 chat client (both connect to the same Management/Runtime services), while code/NagaAgent/ remains a git submodule and should be updated deliberately, with upstream syncs kept separate from repo-local changes. Runtime and generated state primarily lives under data/, logs/, and dist/; the root knowledge/ directory stores knowledge-base data rather than application code. Prefer editing source files and docs over generated outputs unless the task is explicitly about runtime state.

Build, Test, and Development Commands

Use uv for the root project:

uv sync installs Python dependencies.
uv run playwright install installs browser runtimes used by screenshot and web tooling features.
uv run Undefined-webui starts the recommended Management-first local entrypoint.
uv run Undefined starts the bot directly.
uv run pytest tests/ runs the backend test suite.
uv run ruff check . and uv run ruff format --check . enforce Python linting and formatting.
uv run mypy . runs strict type checks.
uv build --wheel validates packaging and bundled resources.
bash scripts/install_git_hooks.sh enables the repository-managed git hooks.

For the console app, run cd apps/undefined-console && npm ci && npm run check. Use npm run dev for the Vite shell and npm run tauri:dev for the desktop shell.

For the native chat client, run cd apps/undefined-chat && npm ci && npm run check (Biome + TypeScript + Vitest unit/e2e + cargo fmt --check/cargo check/cargo test). Use npm run tauri:dev for the desktop shell.

Read the full file on GitHub · 52 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.

yesterday First seen · 52 lines · 1,690 tokens per session scan A 65e6c644f311

Subscribe to this mod's changes

Undefined AGENTS.md is an instructions file published in the GitHub repository 69gg/Undefined (253 stars, last pushed 5d ago), licensed MIT. It adds 1,690 tokens to every session, about $0.0085 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.

Creative and media Data and AI LLM Testing agent ai bot music qqbot

Undefined AGENTS.md

Getting it into your agent

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

Repository Guidelines

Project Structure & Module Organization

Build, Test, and Development Commands

What this file has done since we first saw it

Other instructions, from other repositories

librosa AGENTS.md

show-me-the-story AGENTS.md

nuclear AGENTS.md

lastfm-mcp CLAUDE.md

pruna-skills AGENTS.md

discogs-mcp CLAUDE.md