anomalyco / anomalyco/opencode

[FEATURE]: Custom instructions and environment-aware shell context

Open
#47,011 0 comments 0 reactions 1 assignee View on GitHub

@kitlangton is already working on this.

Since Sep 3, 2026.

Dominant language
TypeScript
Stars
209k
Forks
27.5k
PR merge metrics
PR metrics pending

Description

Feature hasn't been suggested before.
  • I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request

1. Custom instructions (free text, like Codex instructions). Today personalization only exists as files (instructions: string[] paths/URLs plus AGENTS.md/CLAUDE.md). There is no free-text field for role, machine tools, and way of working that applies to every new chat. Proposed: customInstructions?: string in opencode.json[c] (global + project, concatenated), injected into the system prompt of each new session after the env block and before AGENTS.md, with a settings editor.

2. Environment-aware shell context. The V2 <env> block only carries cwd, workspace root, git yes/no, Platform and date — the model never learns the effective shell. On Windows it then emits Linux-isms (ls, &&, grep) that break under cmd.exe/PowerShell 5.1. Proposed: add human-readable OS and resolved effective Shell (reusing the existing shell discovery) to <env> so generated commands match the runtime. Related: #42733, #41321, #22141, #35552.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.