agentmods.dev

Opencode-Assistant AGENTS.md

Project instructions for developing Opencode-Assistant, a Telegram bot that lets users run, monitor, schedule, and remember coding tasks through Telegram.

In plain words
What is it for?
Understanding the codebase and working consistently with its TypeScript, Node.js, Telegram, OpenCode, and test conventions.
Why use it?
They give coding agents the project's purpose, tools, structure, and testing setup in one place.

Instructions file for CodexOpenCode

4 3mo ago A scan 1,972 tokens original MIT
View the source file JohanYP/Opencode-Assistant
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/johanyp/opencode-assistant/agents-md
Clone the repo
git clone --depth 1 https://github.com/JohanYP/Opencode-Assistant

Made for: Codex, OpenCode.

Per session 1,972 This file is loaded in full into every session.
When invoked 1,972 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.

ModelPer sessionOnce invoked
Fable 5 $0.01972 $0.01972
Opus 5 $0.00986 $0.00986
Sonnet 5 $0.00394 $0.00394
Haiku 4.5 $0.00197 $0.00197

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

Security

Grade A, and why

Opencode-Assistant 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 · 272 lines

How it starts

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

AGENTS.md

Instructions for AI agents working on this project.

About the project

Opencode-Assistant is a Telegram-based personal AI assistant powered by OpenCode. It lets a user run, monitor and schedule coding tasks (with continue/cancel deliveries), manage MCP servers, and keep persistent memory across sessions — all through Telegram.

Functional requirements, features, and development status are in PRODUCT.md.

Technology stack

  • Language: TypeScript 5.x
  • Runtime: Node.js 20+
  • Package manager: npm
  • Configuration: environment variables (.env)
  • Logging: custom logger with levels (debug, info, warn, error)

Core dependencies

  • grammy - Telegram Bot API framework (https://grammy.dev/)
  • @grammyjs/menu - inline keyboards and menus
  • @opencode-ai/sdk - official OpenCode Server SDK
  • dotenv - environment variable loading

Test dependencies

  • Vitest
  • Mocks/stubs via vi.mock()

Code quality

  • ESLint + Prettier
  • TypeScript strict mode

Architecture

Main components

  1. Bot Layer - grammY setup, middleware, commands, callback handlers
  2. OpenCode Client Layer - SDK wrapper and SSE event subscription
  3. State Managers - session/project/settings/question/permission/model/agent/variant/keyboard/pinned
  4. Summary Pipeline - event aggregation and Telegram-friendly formatting
  5. Process Manager - local OpenCode server process start, stop, and status
  6. Runtime/CLI Layer - runtime mode, config bootstrap, CLI commands
  7. I18n Layer - localized bot and CLI strings to multiple languages

Data flow

Telegram User
  -> Telegram Bot (grammY)
  -> Managers + OpenCodeClient
  -> OpenCode Server

OpenCode Server
  -> SSE Events
  -> Event Listener
  -> Summary Aggregator / Tool Managers
  -> Telegram Bot
  -> Telegram User

State management

  • Persistent state is stored in settings.json.
  • Active runtime state is kept in dedicated in-memory managers.
  • Session/project/model/agent context is synchronized through OpenCode API calls.
  • The app is currently single-user by design.

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

  1. 2d ago First seen · 272 lines · 1,972 tokens per session scan A 58d9822d8cd3

Subscribe to this mod's changes

Opencode-Assistant AGENTS.md is an instructions file published in the GitHub repository JohanYP/Opencode-Assistant (4 stars, last pushed 3mo ago), licensed MIT. It adds 1,972 tokens to every session, about $0.0099 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-31.

Data and AILanguagesTestingai-assistantclaudeclaude-skillsclaude-sonnetembeddingsmcp
Related

Other instructions, from other repositories

SocratiCode AGENTS.md

AGENTS.md instructions for giancarloerra/SocratiCode, covering codebase search (socraticode), workflow and when to use each tool.

giancarloerra/SocratiCode · 1,441 tokens

SocratiCode CLAUDE.md

Claude Code instructions for giancarloerra/SocratiCode, covering codebase search (socraticode), workflow and when to use each tool.

giancarloerra/SocratiCode · 1,441 tokens

SocratiCode GEMINI.md

Gemini CLI instructions for giancarloerra/SocratiCode, covering codebase search (socraticode), workflow and when to use each tool.

giancarloerra/SocratiCode · 1,441 tokens

subcog CLAUDE.md

Instructions for zircote/subcog, covering claude.md, project overview, key capabilities, build commands and primary development workflow.

zircote/subcog · 501 tokens

subcog copilot-instructions.md

Instructions for zircote/subcog, covering github copilot instructions, project context, code generation guidelines, error handling and type annotations.

zircote/subcog · 1,320 tokens

nextclaw AGENTS.md

Instructions for Peiiii/nextclaw, covering nextclaw ai 常驻内核, 产品愿景, 沟通与推进, 深思与目标模式 and 协作与 git 安全.

Peiiii/nextclaw · 3,095 tokens