What is drift AGENTS.md?

A project guide for Drift, a Rust terminal app that shows all Git changes in one live view and supports pull-request review. It covers commands, code structure, conventions, and documentation updates.

Use it when working on Drift’s Rust code, language support, Git or pull-request review features, and related documentation.

It gives a coding agent the project-specific rules it needs to build, test, format, and change Drift consistently.

drift AGENTS.md — Instructions file by tothalex

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/tothalex/drift/agents-md

Clone the repo

git clone --depth 1 https://github.com/tothalex/drift

Made for: Codex, OpenCode.

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

When invoked 1,335 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.01335	$0.01335
Opus 5	$0.00668	$0.00668
Sonnet 5	$0.00267	$0.00267
Haiku 4.5	$0.00134	$0.00134

Measured 2d ago against content hash 48b3a8f34087, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

drift 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 · 101 lines

How it starts

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

drift — agent instructions

drift is a Rust terminal UI for reviewing working changes like a pull request: everything since the base branch (committed, uncommitted, untracked) in one live view, plus real GitHub/GitLab PR review and a send-to-AI-agent integration.

Commands

cargo build                 # debug binary at target/debug/drift
cargo test                  # unit + integration tests (tests/git_vcs.rs)
cargo test <name>           # one test by substring
cargo clippy --all-targets  # must be warning-free
cargo fmt                   # required before committing

Architecture

src/app/ — the coordinator: event loop, key dispatch, overlay state (picker, compose, help). Fully synchronous — no async runtime; background work is std::thread::spawn + an AppEvent channel.
src/lang/ — the language registry: name, extensions, grammar, block kinds, highlight queries per language. Everything language- specific lives here. No grammar is compiled into drift: every language is a plugin (manifest + query + dylib-compiled grammar under the config dir's languages/), installed via the drift lang CLI or the in-app prompt and hot-loaded. The curated install registry is the repo's languages/ directory (manifests + drift's query stacks), embedded into the binary — adding a curated language = one manifest file there, and tests validate every entry. Unit tests see a registry built from dev-dependency grammar crates plus those curated files, so the suite runs without git or a C compiler; the crate versions in [dev-dependencies] must match the revs the curated manifests pin.
src/processor/ — tree-sitter block scoping, syntax highlighting, view flattening (view.rs is the canonical row model). Language- agnostic: grammars and queries come from src/lang/.
src/vcs/ — git via gitoxide; never shells out to git.
src/forge/ — PRs through the official gh/glab CLIs; drift never speaks HTTP itself. One submodule per forge behind the Forge trait.
src/connect/ — send-to-agent backends behind the Bridge trait; one submodule per multiplexer plus a BACKENDS registry table in mod.rs. Adding a backend touches only this directory: new file, new Backend variant, one registry row.
src/keymap.rs — bindings as data: KEY_DEFAULTS + HELP tables; tests enforce that every action is bound and appears in help.
src/theme.rs — every color drift paints; THEME_DEFAULTS is the single source (onedark_dark palette).
src/config.rs — ~/.config/drift/config.toml; each section is a serde struct with an into_config() validator, and default_toml() must stay parseable (a test round-trips it).

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

2d ago First seen · 101 lines · 1,335 tokens per session scan A 48b3a8f34087

Subscribe to this mod's changes

drift AGENTS.md is an instructions file published in the GitHub repository tothalex/drift (44 stars, last pushed 12d ago), licensed MIT. It adds 1,335 tokens to every session, about $0.0067 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.

Git and workflow Languages Rust ai-agents claude cli developer-tools diff

katamari AGENTS.md

Instructions for isamisushi/katamari, covering agents.md — working on katamari, build/test, tests, architecture pointers and style.

isamisushi/katamari · 1,490 tokens

drip CLAUDE.md

Instructions for drip-cli/drip, covering claude.md, build, test, lint, trying a local build against a real read, benchmarks (release binary only) and repository conventions.

drip-cli/drip · 2,300 tokens

cli AGENTS.md

Instructions for googleworkspace/cli, covering agents.md, project overview, build & test, changesets and architecture.

googleworkspace/cli · 2,700 tokens

turso AGENTS.md

Instructions for tursodatabase/turso, covering turso agent guidelines, quick reference, testing, running tests and test organization.

tursodatabase/turso · 2,194 tokens

intelligent-terminal rust.instructions.md

Concise Rust coding conventions for this repository.

microsoft/intelligent-terminal · 435 tokens

azure-sdk-for-rust resourcemanager.instructions.md

Instructions for Azure/azure-sdk-for-rust, a project described as: This repository is for the active development of the Azure SDK for Rust. For consumers of the SDK we recommend visiting Docs.rs and looking up the docs for any of libraries in the SDK.

Azure/azure-sdk-for-rust · 400 tokens