@neurocode-ai/web 1.18.8

package/src/content/docs/ko/custom-tools.mdx

@@ -0,0 +1,196 @@
+---
+title: Custom Tools
+description: Create tools the LLM can call in OpenCode.
+---
+
+custom tool은 대화 중 LLM이 호출할 수 있도록 사용자가 직접 만든 함수입니다. `read`, `write`, `bash` 같은 OpenCode의 [built-in tools](/docs/tools)와 함께 동작합니다.
+
+---
+
+## 도구 만들기
+
+tool은 **TypeScript** 또는 **JavaScript** 파일로 정의합니다. 다만 tool 정의에서 호출하는 스크립트는 **어떤 언어든** 사용할 수 있습니다. 즉, TypeScript/JavaScript는 tool 정의 자체에만 필요합니다.
+
+---
+
+### 위치
+
+tool은 다음 위치에 둘 수 있습니다.
+
+- 프로젝트의 `.opencode/tools/` 디렉토리(로컬)
+- `~/.config/opencode/tools/` 디렉토리(전역)
+
+---
+
+### 구조
+
+tool을 가장 쉽게 만드는 방법은 타입 안정성과 validation을 제공하는 `tool()` helper를 사용하는 것입니다.
+
+```ts title=".opencode/tools/database.ts" {1}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    // Your database logic here
+    return `Executed query: ${args.query}`
+  },
+})
+```
+
+**파일 이름**이 **tool 이름**이 됩니다. 위 예시는 `database` tool을 생성합니다.
+
+---
+
+#### 파일 하나에 여러 tool 정의
+
+하나의 파일에서 여러 tool을 export할 수도 있습니다. 각 export는 **별도의 tool**이 되며 이름은 **`<filename>_<exportname>`** 형식을 사용합니다.
+
+```ts title=".opencode/tools/math.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export const add = tool({
+  description: "Add two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a + args.b
+  },
+})
+
+export const multiply = tool({
+  description: "Multiply two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a * args.b
+  },
+})
+```
+
+이 경우 `math_add`, `math_multiply` 두 tool이 생성됩니다.
+
+---
+
+#### 기본 도구와 이름 충돌
+
+커스텀 도구는 도구 이름으로 식별됩니다. 커스텀 도구가 기본 도구와 같은 이름을 사용하면 커스텀 도구가 우선순위를 갖습니다.
+
+예를 들어, 이 파일은 기본 `bash` 도구를 대체합니다:
+
+```ts title=".opencode/tools/bash.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Restricted bash wrapper",
+  args: {
+    command: tool.schema.string(),
+  },
+  async execute(args) {
+    return `blocked: ${args.command}`
+  },
+})
+```
+
+:::note
+의도적으로 기본 도구를 대체하려는 경우가 아니라면 고유한 이름을 사용하는 것이 좋습니다. 도구를 오버라이드하지 않고 비활성화만 하려면 [permissions](/docs/permissions)를 사용하세요.
+:::
+
+---
+
+### 인자
+
+인자 타입은 `tool.schema`로 정의할 수 있습니다. `tool.schema`는 [Zod](https://zod.dev) 기반입니다.
+
+```ts "tool.schema"
+args: {
+  query: tool.schema.string().describe("SQL query to execute")
+}
+```
+
+[Zod](https://zod.dev)를 직접 import해서 일반 객체를 반환하는 방식도 사용할 수 있습니다.
+
+```ts {6}
+import { z } from "zod"
+
+export default {
+  description: "Tool description",
+  args: {
+    param: z.string().describe("Parameter description"),
+  },
+  async execute(args, context) {
+    // Tool implementation
+    return "result"
+  },
+}
+```
+
+---
+
+### Context
+
+tool은 현재 세션의 context 정보를 전달받습니다.
+
+```ts title=".opencode/tools/project.ts" {8}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Get project information",
+  args: {},
+  async execute(args, context) {
+    // Access context information
+    const { agent, sessionID, messageID, directory, worktree } = context
+    return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
+  },
+})
+```
+
+세션 작업 디렉토리는 `context.directory`를 사용하세요.
+git worktree 루트는 `context.worktree`를 사용하세요.
+
+---
+
+## 예시
+
+### Python으로 tool 작성
+
+tool은 원하는 언어로 작성할 수 있습니다. 아래는 Python으로 두 숫자를 더하는 예시입니다.
+
+먼저 Python 스크립트로 tool을 만듭니다.
+
+```python title=".opencode/tools/add.py"
+import sys
+
+a = int(sys.argv[1])
+b = int(sys.argv[2])
+print(a + b)
+```
+
+그다음 이 스크립트를 호출하는 tool 정의를 만듭니다.
+
+```ts title=".opencode/tools/python-add.ts" {10}
+import { tool } from "@opencode-ai/plugin"
+import path from "path"
+
+export default tool({
+  description: "Add two numbers using Python",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args, context) {
+    const script = path.join(context.worktree, ".opencode/tools/add.py")
+    const result = await Bun.$`python3 ${script} ${args.a} ${args.b}`.text()
+    return result.trim()
+  },
+})
+```
+
+여기서는 Python 스크립트를 실행하기 위해 [`Bun.$`](https://bun.com/docs/runtime/shell) 유틸리티를 사용합니다.

package/src/content/docs/ko/ecosystem.mdx

@@ -0,0 +1,78 @@
+---
+title: 생태계
+description: OpenCode로 구축된 프로젝트와 통합.
+---
+
+OpenCode를 기반으로 만들어진 커뮤니티 프로젝트 모음입니다.
+
+:::note
+이 목록에 OpenCode 관련 프로젝트를 추가하고 싶다면 PR을 제출하세요.
+:::
+
+[awesome-opencode](https://github.com/awesome-opencode/awesome-opencode)와 [opencode.cafe](https://opencode.cafe)도 함께 확인해 보세요. ecosystem과 community 정보를 한곳에 모아볼 수 있습니다.
+
+---
+
+## 플러그인
+
+| 이름                                                                                               | 설명                                                                                            |
+| -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| [opencode-daytona](https://github.com/daytonaio/daytona/tree/main/libs/opencode-plugin)            | git sync와 live preview를 지원하는 격리된 Daytona sandbox에서 OpenCode 세션을 자동 실행합니다.  |
+| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session)                  | 요청을 그룹화할 수 있도록 Helicone session header를 자동으로 주입합니다.                        |
+| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject)                            | 조회 tool과 함께 TypeScript/Svelte 타입 정보를 파일 읽기에 자동 주입합니다.                     |
+| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)             | API 크레딧 대신 ChatGPT Plus/Pro 구독을 사용할 수 있습니다.                                     |
+| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth)                            | API 과금 대신 기존 Gemini 플랜을 사용할 수 있습니다.                                            |
+| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth)                | API 과금 대신 Antigravity의 무료 model을 사용할 수 있습니다.                                    |
+| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers)                         | shallow clone과 자동 포트 할당을 기반으로 multi-branch devcontainer 격리를 제공합니다.          |
+| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth)   | Google Search 지원과 견고한 API 처리를 제공하는 Google Antigravity OAuth Plugin입니다.          |
+| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)  | 오래된 tool output을 정리해 token 사용량을 최적화합니다.                                        |
+| [opencode-vibeguard](https://github.com/inkdust2021/opencode-vibeguard)                            | LLM 호출 전에 secrets/PII를 VibeGuard 스타일 placeholder로 가리고, 로컬에서 복원합니다.         |
+| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git)                 | 지원 provider에서 Google grounded 스타일의 네이티브 websearch를 추가합니다.                     |
+| [opencode-pty](https://github.com/shekohex/opencode-pty.git)                                       | AI agent가 PTY에서 백그라운드 프로세스를 실행하고 대화형 입력을 보낼 수 있게 합니다.            |
+| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy)                     | 비대화형 shell 명령 실행 지침을 제공해 TTY 의존 작업으로 인한 멈춤을 방지합니다.                |
+| [opencode-wakatime](https://github.com/angristan/opencode-wakatime)                                | Wakatime으로 OpenCode 사용량을 추적합니다.                                                      |
+| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main)    | LLM이 생성한 markdown 표를 정리합니다.                                                          |
+| [opencode-morph-plugin](https://github.com/morphllm/opencode-morph-plugin)                         | Morph를 통한 Fast Apply 편집, WarpGrep 코드베이스 검색 및 컨텍스트 압축                         |
+| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)                                   | background agent, 사전 구성된 LSP/AST/MCP tool, curated agent, Claude Code 호환성을 제공합니다. |
+| [opencode-notificator](https://github.com/panta82/opencode-notificator)                            | OpenCode 세션에 데스크톱 알림과 사운드 알림을 제공합니다.                                       |
+| [opencode-notifier](https://github.com/mohak34/opencode-notifier)                                  | permission, 완료, 오류 이벤트에 대한 데스크톱 알림과 사운드 알림을 제공합니다.                  |
+| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer)                            | OpenCode 맥락을 기반으로 Zellij session 이름을 AI로 자동 지정합니다.                            |
+| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful)                                | skill 탐색과 주입을 통해 OpenCode agent가 필요 시 prompt를 lazy load하도록 합니다.              |
+| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)                      | Supermemory를 사용해 세션 간 persistent memory를 제공합니다.                                    |
+| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 시각 주석과 private/offline 공유를 포함한 인터랙티브 계획 리뷰를 제공합니다.                    |
+| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)                              | 세밀한 flow control로 opencode /commands를 강력한 orchestration 시스템으로 확장합니다.          |
+| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler)                           | cron 문법을 사용해 launchd(Mac) 또는 systemd(Linux) 기반 반복 작업을 예약합니다.                |
+| [micode](https://github.com/vtemian/micode)                                                        | Structured Brainstorm → Plan → Implement 워크플로를 session continuity와 함께 제공합니다.       |
+| [octto](https://github.com/vtemian/octto)                                                          | 다중 질문 폼 기반의 AI 브레인스토밍용 인터랙티브 브라우저 UI를 제공합니다.                      |
+| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents)              | Claude Code 스타일의 background agent를 async delegation과 context persistence로 제공합니다.    |
+| [opencode-notify](https://github.com/kdcokenny/opencode-notify)                                    | OpenCode 작업 완료 시점을 native OS 알림으로 알려줍니다.                                        |
+| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace)                              | 16개 구성요소를 한 번에 설치하는 bundled multi-agent orchestration harness를 제공합니다.        |
+| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree)                                | OpenCode용 git worktree를 손쉽게 사용할 수 있도록 돕습니다.                                     |
+| [opencode-sentry-monitor](https://github.com/stolinski/opencode-sentry-monitor)                    | Sentry AI 모니터링으로 AI 에이전트를 추적하고 디버그합니다.                                     |
+
+---
+
+## 프로젝트
+
+| 이름                                                                                       | 설명                                                                   |
+| ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
+| [kimaki](https://github.com/remorses/kimaki)                                               | SDK 기반으로 OpenCode 세션을 제어하는 Discord bot입니다.               |
+| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim)                              | API 기반 editor-aware prompt를 제공하는 Neovim plugin입니다.           |
+| [portal](https://github.com/hosenur/portal)                                                | Tailscale/VPN 환경에서 OpenCode를 쓰기 위한 mobile-first 웹 UI입니다.  |
+| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/)         | OpenCode plugin 개발을 위한 템플릿입니다.                              |
+| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim)                                 | terminal 기반 AI 코딩 agent인 opencode용 Neovim frontend입니다.        |
+| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | `@opencode-ai/sdk`로 OpenCode를 사용하는 Vercel AI SDK provider입니다. |
+| [OpenChamber](https://github.com/btriapitsyn/openchamber)                                  | OpenCode용 Web/Desktop App 및 VS Code Extension입니다.                 |
+| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian)                           | Obsidian UI에 OpenCode를 내장하는 Obsidian plugin입니다.               |
+| [OpenWork](https://github.com/different-ai/openwork)                                       | OpenCode 기반의 Claude Cowork 대체 오픈소스 프로젝트입니다.            |
+| [ocx](https://github.com/kdcokenny/ocx)                                                    | 휴대형 격리 프로필을 지원하는 OpenCode extension manager입니다.        |
+| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)                                   | OpenCode용 Desktop/Web/Mobile/Remote client app입니다.                 |
+
+---
+
+## 에이전트
+
+| 이름                                                              | 설명                                                             |
+| ----------------------------------------------------------------- | ---------------------------------------------------------------- |
+| [Agentic](https://github.com/Cluster444/agentic)                  | 구조화된 개발을 위한 모듈형 AI agent와 command를 제공합니다.     |
+| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 향상된 워크플로를 위한 config, prompt, agent, plugin 모음입니다. |

package/src/content/docs/ko/enterprise.mdx

@@ -0,0 +1,165 @@
+---
+title: 엔터프라이즈
+description: 조직에서 OpenCode를 안전하게 사용하는 방법입니다.
+---
+
+import config from "../../../../config.mjs"
+export const email = `mailto:${config.email}`
+
+OpenCode Enterprise는 코드와 데이터가 조직의 인프라 밖으로 나가지 않도록 보장하려는 조직을 위한 기능입니다. SSO 및 내부 AI gateway와 연동되는 중앙 config를 사용해 이를 구현할 수 있습니다.
+
+:::note
+OpenCode는 코드나 context 데이터를 저장하지 않습니다.
+:::
+
+OpenCode Enterprise를 시작하려면 다음 단계를 진행하세요.
+
+1. 팀 내부에서 trial을 먼저 진행하세요.
+2. 가격 및 도입 옵션을 논의하려면 **<a href={email}>문의해 주세요</a>**.
+
+---
+
+## Trial
+
+OpenCode는 오픈소스이며 코드나 context 데이터를 저장하지 않으므로, 개발자는 바로 [시작하기](/docs/)를 참고해 trial을 진행할 수 있습니다.
+
+---
+
+### Data handling
+
+**OpenCode는 코드나 context 데이터를 저장하지 않습니다.** 모든 처리는 로컬 환경 또는 AI provider로의 직접 API 호출로 이루어집니다.
+
+따라서 신뢰할 수 있는 provider 또는 내부 AI gateway를 사용한다면 OpenCode를 안전하게 사용할 수 있습니다.
+
+주의할 점은 선택 기능인 `/share`입니다.
+
+---
+
+#### Sharing conversations
+
+사용자가 `/share` 기능을 활성화하면, 대화와 관련 데이터가 opencode.ai의 share 페이지 호스팅 서비스로 전송됩니다.
+
+현재 이 데이터는 CDN edge network를 통해 제공되며, 사용자와 가까운 edge에 캐시됩니다.
+
+trial 단계에서는 이 기능을 비활성화할 것을 권장합니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+[sharing에 대해 더 알아보기](/docs/share).
+
+---
+
+### Code ownership
+
+**OpenCode가 생성한 코드는 모두 사용자에게 소유권이 있습니다.** 라이선스 제한이나 소유권 주장도 없습니다.
+
+---
+
+## Pricing
+
+OpenCode Enterprise는 seat당 과금 모델을 사용합니다. 자체 LLM gateway를 사용하는 경우에는 사용 token에 대해 별도 과금하지 않습니다. 가격 및 도입 옵션의 자세한 내용은 **<a href={email}>문의해 주세요</a>**.
+
+---
+
+## Deployment
+
+trial을 마치고 조직에서 OpenCode를 본격적으로 사용하려면, 가격 및 도입 옵션 논의를 위해 **<a href={email}>문의해 주세요</a>**.
+
+---
+
+### Central Config
+
+조직 전체에서 단일 중앙 config를 사용하도록 OpenCode를 설정할 수 있습니다.
+
+이 중앙 config는 SSO provider와 연동할 수 있으며, 모든 사용자가 내부 AI gateway만 사용하도록 보장합니다.
+
+---
+
+### SSO integration
+
+중앙 config를 통해 OpenCode는 조직의 SSO provider와 인증 연동을 구성할 수 있습니다.
+
+이를 통해 기존 ID 관리 시스템으로 내부 AI gateway credential을 안전하게 획득할 수 있습니다.
+
+---
+
+### Internal AI gateway
+
+중앙 config를 사용하면 OpenCode를 내부 AI gateway만 사용하도록 설정할 수 있습니다.
+
+또한 다른 AI provider를 모두 비활성화해, 모든 요청이 조직에서 승인한 인프라만 통과하도록 구성할 수 있습니다.
+
+---
+
+### Self-hosting
+
+데이터가 조직 외부로 나가지 않도록 share 페이지 비활성화를 권장하지만, 원하시면 해당 페이지를 조직 인프라에 self-hosting하는 방식도 지원할 수 있습니다.
+
+이 기능은 현재 로드맵에 있으며, 관심이 있다면 **<a href={email}>문의해 주세요</a>**.
+
+---
+
+## FAQ
+
+<details>
+<summary>OpenCode Enterprise란 무엇인가요?</summary>
+
+OpenCode Enterprise는 코드와 데이터가 조직 인프라 밖으로 나가지 않도록 보장하려는 조직을 위한 기능입니다. SSO 및 내부 AI gateway와 연동되는 중앙 config를 사용해 이를 구현할 수 있습니다.
+
+</details>
+
+<details>
+<summary>OpenCode Enterprise는 어떻게 시작하나요?</summary>
+
+먼저 팀 내부 trial부터 시작하세요. OpenCode는 기본적으로 코드나 context 데이터를 저장하지 않으므로 도입을 빠르게 시작할 수 있습니다.
+
+그다음 가격 및 도입 옵션 논의를 위해 **<a href={email}>문의해 주세요</a>**.
+
+</details>
+
+<details>
+<summary>엔터프라이즈 가격 정책은 어떻게 되나요?</summary>
+
+seat당 과금 방식의 엔터프라이즈 요금제를 제공합니다. 자체 LLM gateway를 사용하면 token 사용량에 대한 별도 과금은 없습니다. 자세한 내용은 **<a href={email}>문의해 주세요</a>**. 조직 상황에 맞는 맞춤 견적을 안내해 드립니다.
+
+</details>
+
+<details>
+<summary>OpenCode Enterprise에서 데이터는 안전한가요?</summary>
+
+네. OpenCode는 코드나 context 데이터를 저장하지 않습니다. 모든 처리는 로컬 또는 AI provider로의 직접 API 호출로 이루어집니다. 중앙 config와 SSO integration을 함께 사용하면 데이터는 조직 인프라 내부에서 안전하게 유지됩니다.
+
+</details>
+
+<details>
+<summary>사내 private NPM registry를 사용할 수 있나요?</summary>
+
+OpenCode는 Bun의 기본 `.npmrc` 지원을 통해 private npm registry를 사용할 수 있습니다. 조직에서 JFrog Artifactory, Nexus 등 private registry를 사용한다면 OpenCode 실행 전에 개발자 인증을 완료하세요.
+
+private registry 인증 예시는 다음과 같습니다.
+
+```bash
+npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+```
+
+이 명령은 인증 정보가 포함된 `~/.npmrc`를 생성하며, OpenCode는 이를 자동으로 인식합니다.
+
+:::caution
+OpenCode 실행 전에 private registry 로그인 상태여야 합니다.
+:::
+
+또는 `.npmrc` 파일을 수동으로 구성할 수 있습니다.
+
+```bash title="~/.npmrc"
+registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}
+```
+
+엔터프라이즈 registry에서 패키지를 정상 설치하려면, 개발자는 OpenCode 실행 전에 private registry 인증을 완료해야 합니다.
+
+</details>

package/src/content/docs/ko/formatters.mdx

@@ -0,0 +1,132 @@
+---
+title: 포매터
+description: OpenCode는 언어별 포매터를 사용합니다.
+---
+
+OpenCode는 파일을 write하거나 edit한 뒤, 언어별 포매터를 사용해 자동으로 포맷합니다. 이를 통해 생성된 코드가 프로젝트의 코드 스타일을 따르도록 보장합니다.
+
+---
+
+## 내장
+
+OpenCode는 주요 언어와 프레임워크를 위한 여러 내장 포매터를 제공합니다. 아래는 포매터 목록, 지원 확장자, 필요한 명령 또는 config 옵션입니다.
+
+| 포매터               | 확장자                                                                                               | 요구 사항                                                                                             |
+| -------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| air                  | .R                                                                                                   | `air` 명령 사용 가능                                                                                  |
+| biome                | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, [기타](https://biomejs.dev/)                   | `biome.json(c)` config 파일                                                                           |
+| cargofmt             | .rs                                                                                                  | `cargo fmt` 명령 사용 가능                                                                            |
+| clang-format         | .c, .cpp, .h, .hpp, .ino, [기타](https://clang.llvm.org/docs/ClangFormat.html)                       | `.clang-format` config 파일                                                                           |
+| cljfmt               | .clj, .cljs, .cljc, .edn                                                                             | `cljfmt` 명령 사용 가능                                                                               |
+| dart                 | .dart                                                                                                | `dart` 명령 사용 가능                                                                                 |
+| dfmt                 | .d                                                                                                   | `dfmt` 명령 사용 가능                                                                                 |
+| gleam                | .gleam                                                                                               | `gleam` 명령 사용 가능                                                                                |
+| gofmt                | .go                                                                                                  | `gofmt` 명령 사용 가능                                                                                |
+| htmlbeautifier       | .erb, .html.erb                                                                                      | `htmlbeautifier` 명령 사용 가능                                                                       |
+| ktlint               | .kt, .kts                                                                                            | `ktlint` 명령 사용 가능                                                                               |
+| mix                  | .ex, .exs, .eex, .heex, .leex, .neex, .sface                                                         | `mix` 명령 사용 가능                                                                                  |
+| nixfmt               | .nix                                                                                                 | `nixfmt` 명령 사용 가능                                                                               |
+| ocamlformat          | .ml, .mli                                                                                            | `ocamlformat` 명령 사용 가능 및 `.ocamlformat` config 파일 필요                                       |
+| ormolu               | .hs                                                                                                  | `ormolu` 명령 사용 가능                                                                               |
+| oxfmt (Experimental) | .js, .jsx, .ts, .tsx                                                                                 | `package.json`에 `oxfmt` dependency 필요 및 [experimental env variable flag](/docs/cli/#experimental) |
+| pint                 | .php                                                                                                 | `composer.json`에 `laravel/pint` dependency 필요                                                      |
+| prettier             | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, [기타](https://prettier.io/docs/en/index.html) | `package.json`에 `prettier` dependency 필요                                                           |
+| rubocop              | .rb, .rake, .gemspec, .ru                                                                            | `rubocop` 명령 사용 가능                                                                              |
+| ruff                 | .py, .pyi                                                                                            | `ruff` 명령 사용 가능 및 관련 config 필요                                                             |
+| rustfmt              | .rs                                                                                                  | `rustfmt` 명령 사용 가능                                                                              |
+| shfmt                | .sh, .bash                                                                                           | `shfmt` 명령 사용 가능                                                                                |
+| standardrb           | .rb, .rake, .gemspec, .ru                                                                            | `standardrb` 명령 사용 가능                                                                           |
+| terraform            | .tf, .tfvars                                                                                         | `terraform` 명령 사용 가능                                                                            |
+| uv                   | .py, .pyi                                                                                            | `uv` 명령 사용 가능                                                                                   |
+| zig                  | .zig, .zon                                                                                           | `zig` 명령 사용 가능                                                                                  |
+
+예를 들어 프로젝트 `package.json`에 `prettier`가 있으면 OpenCode가 자동으로 해당 포매터를 사용합니다.
+
+---
+
+## 작동 방식
+
+OpenCode가 파일을 write하거나 edit할 때 다음 순서로 동작합니다.
+
+1. 활성화된 모든 포매터와 파일 확장자를 대조합니다.
+2. 파일에 맞는 포매터 명령을 실행합니다.
+3. 포맷 변경 사항을 자동으로 적용합니다.
+
+이 과정은 background에서 실행되며, 수동 작업 없이 코드 스타일이 유지됩니다.
+
+---
+
+## 구성
+
+OpenCode config의 `formatter` 섹션에서 포매터를 커스터마이즈할 수 있습니다.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {}
+}
+```
+
+각 formatter 설정에서 지원하는 항목은 다음과 같습니다.
+
+| 속성          | 타입     | 설명                                           |
+| ------------- | -------- | ---------------------------------------------- |
+| `disabled`    | boolean  | `true`로 설정하면 해당 포매터를 비활성화합니다 |
+| `command`     | string[] | 포맷 실행 명령입니다                           |
+| `environment` | object   | 포매터 실행 시 설정할 환경 변수입니다          |
+| `extensions`  | string[] | 해당 포매터가 처리할 파일 확장자입니다         |
+
+아래 예시를 참고하세요.
+
+---
+
+### 포매터 비활성화
+
+전체 포매터를 전역에서 비활성화하려면 `formatter`를 `false`로 설정하세요.
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": false
+}
+```
+
+특정 포매터만 비활성화하려면 `disabled`를 `true`로 설정하세요.
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### 사용자 정의 포매터
+
+명령, 환경 변수, 파일 확장자를 지정해 내장 포매터를 override하거나 새 포매터를 추가할 수 있습니다.
+
+```json title="opencode.json" {4-14}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```
+
+명령의 **`$FILE` placeholder**는 포맷 대상 파일 경로로 치환됩니다.