jcode: Instructions file for Codex

AGENTS.md

jcode AGENTS.md is an instructions file for Codex, OpenCode from 1jehuang/jcode. It costs 1,212 tokens per session, scanned A, original, MIT.

A set of repository instructions for developers working on the jcode project. It describes branch rules, installation paths, development workflow, and how to verify changes at runtime.

In plain words
What is it for?
Use it when changing the repository, building or installing jcode, selecting the correct build channel, and checking that a change works.
Why use it?
It reduces the risk of accidentally combining another contributor's work or installing the wrong build. It also clarifies which local executable is active during development or release testing.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md.

This is 1jehuang/jcode's own configuration. It tells Codex and OpenCode how to work on jcode itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything jcode configures →

About the project

jcode is a command-line coding-agent harness that lets developers run AI-assisted programming sessions while using relatively little memory. It is designed for developers who need efficient single- or multi-session workflows with language-model providers and related tools. The catalogue includes a skill and an instruction for working with jcode.

1jehuang/jcode · 21,528 stars · on GitHub · jcode.sh

Reuse

Borrowing it

Nothing to install: this file belongs to 1jehuang/jcode. 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/1jehuang/jcode/master/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/1jehuang/jcode

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.

agentmods badge for jcode AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/1jehuang/jcode/agents-md/github.svg)](https://agentmods.dev/instructions/1jehuang/jcode/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/1jehuang/jcode/agents-md"><img src="https://agentmods.dev/badge/instructions/1jehuang/jcode/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.

agentmods 80×15 button for jcode AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/1jehuang/jcode/agents-md"><img src="https://agentmods.dev/badge/instructions/1jehuang/jcode/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,212 This file is loaded in full into every session.
When invoked 1,212 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.01212 $0.01212
Opus 5.5 $0.00485 $0.00485
Sonnet 5.5 $0.00242 $0.00242
Haiku 4.5 $0.00121 $0.00121

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

Security

Grade A, and why

jcode 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 3d 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 · 92 lines

How it starts

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

Repository Guidelines

Repository Scope

  • Jcode Desktop is in a separate repository.

TUI style

  • UI chrome must not wrap: startup headers, account rows, status labels, and other compact UI rows should fit their available terminal-cell width or truncate with an ellipsis. Count Unicode display cells, not characters. Preserve one logical row per visual row, including at narrow widths. Chat prose and other intentionally multiline content may wrap normally.
  • Reuse the info widget's limit-bar renderer for usage indicators instead of introducing a different bar glyph, color, or used/remaining convention.

Development Workflow

  • Commit and push as you go - Make small, scoped commits and push them to the current branch's remote as meaningful work is completed, rather than waiting until the end of the task. Preserve unrelated changes and never force-push unless the user explicitly authorizes it.
  • Use the user's Git identity - Create commits with the configured user.name and user.email. Do not override them with Jcode, Jcode agent, or a fabricated agent email. Preserve existing contributor attribution when integrating work. If no identity is configured, ask rather than inventing one.
  • Welcome pull requests from everyone - Review contributions on their merits, regardless of whether the author is a maintainer, an existing contributor, a first-time contributor, or an agent. Good PRs can be merged directly after review and validation. Do not require a maintainer-authored rewrite merely because of who submitted the change. See CONTRIBUTING.md for the contribution policy.
  • Prefer master/main - Work directly on the repository's primary branch (master or main) by default. Do not create a branch or worktree merely to start a task. Only do so when the user explicitly requests it or isolation is genuinely necessary, and explain the concrete reason first.
  • Keep work scoped - Preserve unrelated work. If already on a branch with ongoing changes, finish and integrate safely rather than switching blindly. When the user asks you to review or integrate a PR or branch, you may inspect, test, and integrate that contribution regardless of author status. Do not pull in unrelated branches or merge a PR without user authorization.

Read the full file on GitHub · 92 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. 3d ago Changed · +4 lines · +62 tokens per session f007d4cad7d0
  2. 8d ago Changed · +16 lines · +192 tokens per session 87f780b8d933
  3. 20d ago Changed · +10 lines · +109 tokens per session 9fe048e74b2e
  4. 23d ago Changed · +5 lines · +80 tokens per session bb9e1d5f5413
  5. 1mo ago Changed · +4 lines · +14 tokens per session 1cdba37642d0
  6. 1mo ago Changed · +4 lines · +69 tokens per session 41ecb9dff195
  7. 1mo ago Changed · +4 lines · +53 tokens per session 5715bf9f8d0c
  8. 2mo ago First seen · 45 lines · 633 tokens per session scan A 23f9a0f60466

Subscribe to this mod's changes

jcode AGENTS.md is an instructions file published in the GitHub repository 1jehuang/jcode (21,528 stars, last pushed yesterday), licensed MIT. It adds 1,212 tokens to every session, about $0.0048 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.

Related

jcode AGENTS.md compared with instructions from other repositories

jcode AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
jcode AGENTS.md1jehuang/jcodeInstructions file22kyesterdayMITA1,212Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode