What is atria AGENTS.md?

Project-specific coding conventions for Atria, a Go terminal interface for managing multiple AI coding agents in terminal tabs or panes. They cover code style, error handling, commit messages, and the project layout.

Use them when editing Atria to follow its Go conventions, format code, return contextual errors, organize files, and write consistent commits.

They help changes fit Atria's existing Go practices and prevent common maintenance problems such as inconsistent formatting or unsafe error handling.

How sethdeckard/atria configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to sethdeckard/atria. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/sethdeckard/atria/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/sethdeckard/atria

Made for: Codex, OpenCode.

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

README.md

[![agentmods](https://agentmods.dev/badge/instructions/sethdeckard/atria/agents-md/github.svg)](https://agentmods.dev/instructions/sethdeckard/atria/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/sethdeckard/atria/agents-md"><img src="https://agentmods.dev/badge/instructions/sethdeckard/atria/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/sethdeckard/atria/agents-md"><img src="https://agentmods.dev/badge/instructions/sethdeckard/atria/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 6,769 This file is loaded in full into every session.

When invoked 6,769 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.1	$0.06769	$0.06769
Opus 5.5	$0.02708	$0.02708
Sonnet 5.5	$0.01354	$0.01354
Haiku 4.5	$0.00677	$0.00677

Measured 9d ago against content hash 07505ab24be5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

atria 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 9d 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 · 374 lines

How it starts

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

Atria - Agent Conventions

Internal development conventions. See README.md for user documentation.

Project Overview

Atria is a Go TUI tool for managing multiple AI coding agents (Claude Code, Codex, OpenCode) running in terminal tabs/panes. Built with Bubble Tea (bubbletea, lipgloss, bubbles).

Code Style

Idiomatic Go: follow Effective Go patterns, standard naming conventions
Format all code with gofmt / goimports
Error handling: return errors, don't panic. Wrap errors with context using fmt.Errorf("context: %w", err)
No log.Fatal outside main.go, in internal/ or libatria/. Only main.go may exit the process

Commit Messages

Subject: max 50 chars, capitalized, imperative mood (e.g. "Add feature" not "Added feature")
Blank line between subject and body
Body: wrapped at 72 chars, describe what and why, not how

Project Structure

main.go                          # Entry point
internal/
  config/config.go               # TOML config parsing
  model/types.go                 # App types (Project, AgentSession)
  model/store.go                 # In-memory store + JSON persistence
  tui/app.go                     # Root Bubble Tea model
  tui/messages.go                # tea.Msg types
  tui/commands.go                # tea.Cmd factories
  tui/keys.go                    # Key bindings
  tui/styles.go                  # Lip Gloss styles
  tui/settings.go                # Settings screen (config editor)
  tui/projectlist.go             # Agent list view (agents dashboard)
  tui/chatview.go                # Chat/send view
  tui/termview.go                # Embedded terminal view (PTY backend)
  tui/paths.go                   # Path display utilities (contractHome)
  tui/gitinfo.go                 # Git worktree detection
libatria/                        # Public library; see docs/libatria/README.md and API.md
  stack.go                       # Open, Stack: probe integrations, pick the primary, toggle at runtime
  registry.go                    # Names, Source, Prefix, Rank, EnvMatches
  agent/agent.go                 # Type, Status, Types, constants
  agent/detect.go                # Agent detection from session title
  agent/classify.go              # Status classification from screen text
  agent/patterns.go              # Per-agent regex registry
  agent/installed.go             # Which agent binaries are on PATH
  agent/process.go               # FindProcess: the agent process on a TTY
  agent/launch.go                # ShellQuote, LaunchCommand, Launch
  agent/send.go                  # SendPrompt (two-step send, Copilot per-rune path)
  terminal/backend.go            # Backend interface and named optional interfaces
  terminal/keys.go               # Named keys, SendKey
  terminal/errors.go             # ErrUnavailable, timeouts
  terminal/process.go            # ProcessesOnTTY, ProcessCWD
  terminal/composite.go          # Composite backend (primary + integrations)
  terminal/cache.go              # Cached session list with TTL
  terminal/cwd.go                # CWD discovery strategies (shared)
  terminal/tty.go                # TTY lookup by PID
  terminal/screentrim.go         # Screen tail trimming
  terminal/kitty/client.go       # Kitty backend (kitten @ CLI via socket)
  terminal/wezterm/client.go     # WezTerm backend (wezterm cli)
  terminal/deviceterm/client.go  # DeviceTerm backend (deviceterm CLI, Automation tab)
  terminal/iterm/proto/api.proto # iTerm2 protobuf spec (trimmed)
  terminal/iterm/proto/api.pb.go # Generated protobuf Go code
  terminal/iterm/conn.go         # iTerm2 WebSocket connection manager
  terminal/iterm/client.go       # iTerm2 backend (native protobuf API)
  terminal/tmux/client.go        # tmux backend
  terminal/pty/client.go         # PTY backend (built-in multiplexer)
  terminal/pty/session.go        # PTY session (process + vt10x emulator)
  watch/tracker.go               # Tracker: per-session status state machine
  watch/identify.go              # Identify: is this session an agent, in which directory
  watch/watcher.go               # Watcher: goroutine poller emitting events
  watch/event.go                 # Event, Snapshot, event and removal kinds

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

9d ago Changed · +1 lines · +56 tokens per session 07505ab24be5
18d ago Changed · +115 tokens per session a04cbdadbcc1
27d ago Changed · -22 lines · -217 tokens per session 6fb57080301b
28d ago Changed · +2 lines · +69 tokens per session 6ebbeb99e263
1mo ago Changed · +2 lines · +144 tokens per session e526c31b69c8
1mo ago Changed · +21 lines · +488 tokens per session 95679f95464c
1mo ago Changed · +44 lines · +1,411 tokens per session e970d11cf983
1mo ago First seen · 326 lines · 4,703 tokens per session scan A 3397bd249963

Subscribe to this mod's changes

atria AGENTS.md is an instructions file published in the GitHub repository sethdeckard/atria (20 stars, last pushed 7d ago), licensed MIT. It adds 6,769 tokens to every session, about $0.0271 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.

Claude Code agents ai-agents codex golang-application iterm2

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

microsoft/vscode · 9,715 tokens

atria: Instructions file for Codex

Borrowing it

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

Atria - Agent Conventions

Project Overview

Code Style

Commit Messages

Project Structure

What this file has done since we first saw it

Other instructions, from other repositories

vscode buildNext.instructions.md

next.js AGENTS.md

vscode oss-third-party-notices.instructions.md

langchain AGENTS.md

vscode copilot-instructions.md

vscode model-prompts.instructions.md