fix(docs): locale translations for nav elements and headings

This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions

View File

@@ -1,23 +1,23 @@
---
title: Suporte ACP
description: Use opencode em qualquer editor compatível com ACP.
description: Use o opencode em qualquer editor compatível com ACP.
---
opencode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis.
O opencode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis.
:::tip
Para uma lista de editores e ferramentas que suportam ACP, confira o [relatório de progresso do ACP](https://zed.dev/blog/acp-progress-report#available-now).
:::
ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de AI.
O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de IA.
---
## Configurar
## Configuração
Para usar opencode via ACP, configure seu editor para executar o comando `opencode acp`.
O comando inicia o opencode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio.
Este comando inicia o opencode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio.
Abaixo estão exemplos para editores populares que suportam ACP.
@@ -138,11 +138,11 @@ require("codecompanion").setup({
Esta configuração configura o CodeCompanion para usar opencode como o agente ACP para chat.
Se você precisar passar variáveis de ambiente (como `OPENCODE_API_KEY`), consulte [Configuring Adapters: Environment Variables](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) na documentação do CodeCompanion.nvim para detalhes completos.
Se você precisar passar variáveis de ambiente (como `OPENCODE_API_KEY`), consulte [Configurando Adaptadores: Variáveis de Ambiente](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) na documentação do CodeCompanion.nvim para detalhes completos.
## Suporte
opencode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados:
O opencode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados:
:::note
Alguns comandos de barra integrados, como `/undo` e `/redo`, atualmente não são suportados.

View File

@@ -3,10 +3,10 @@ title: Agentes
description: Configure e use agentes especializados.
---
Agentes são assistentes de AI especializados que podem ser configurados para tarefas e fluxos de trabalho específicos. Eles permitem que você crie ferramentas focadas com prompts, modelos e acesso a ferramentas personalizados.
Agentes são assistentes de IA especializados que podem ser configurados para tarefas e fluxos de trabalho específicos. Eles permitem que você crie ferramentas focadas com prompts, modelos e acesso a ferramentas personalizados.
:::tip
Use o agente de planejamento para analisar código e revisar sugestões sem fazer alterações no código.
Use o agente de planejamento (plan) para analisar código e revisar sugestões sem fazer alterações no código.
:::
Você pode alternar entre agentes durante uma sessão ou invocá-los com a menção `@`.
@@ -40,13 +40,13 @@ opencode vem com dois subagentes integrados, **General** e **Explore**. Vamos ve
---
## Integrado
## Integrados
opencode vem com dois agentes primários integrados e dois subagentes integrados.
---
### Usar build
### build
_Modo_: `primary`
@@ -54,7 +54,7 @@ Build é o agente primário **padrão** com todas as ferramentas habilitadas. Es
---
### Usar plan
### plan
_Modo_: `primary`
@@ -68,7 +68,7 @@ Este agente é útil quando você deseja que o LLM analise código, sugira alter
---
### Usar general
### general
_Modo_: `subagent`
@@ -76,7 +76,7 @@ Um agente de propósito geral para pesquisar questões complexas e executar tare
---
### Usar explore
### explore
_Modo_: `subagent`
@@ -84,7 +84,7 @@ Um agente rápido e somente leitura para explorar bases de código. Não pode mo
---
### Usar compaction
### compaction
_Modo_: `primary`
@@ -92,7 +92,7 @@ Agente de sistema oculto que compacta longos contextos em um resumo menor. Ele
---
### Usar title
### title
_Modo_: `primary`
@@ -100,7 +100,7 @@ Agente de sistema oculto que gera títulos curtos para sessões. Ele é executad
---
### Usar summary
### summary
_Modo_: `primary`
@@ -128,7 +128,7 @@ Agente de sistema oculto que cria resumos de sessões. Ele é executado automati
---
## Configurar
## Configuração
Você pode personalizar os agentes integrados ou criar os seus próprios através da configuração. Os agentes podem ser configurados de duas maneiras:
@@ -162,10 +162,10 @@ Configure os agentes em seu arquivo de configuração `opencode.json`:
}
},
"code-reviewer": {
"description": "Reviews code for best practices and potential issues",
"description": "Revisa código para melhores práticas e potenciais problemas",
"mode": "subagent",
"model": "anthropic/claude-sonnet-4-20250514",
"prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
"prompt": "Você é um revisor de código. Foque em segurança, performance e manutenibilidade.",
"tools": {
"write": false,
"edit": false
@@ -186,7 +186,7 @@ Você também pode definir agentes usando arquivos markdown. Coloque-os em:
```markdown title="~/.config/opencode/agents/review.md"
---
description: Reviews code for quality and best practices
description: Revisa código para qualidade e melhores práticas
mode: subagent
model: anthropic/claude-sonnet-4-20250514
temperature: 0.1
@@ -196,14 +196,14 @@ tools:
bash: false
---
You are in code review mode. Focus on:
Você está no modo de revisão de código. Foque em:
- Code quality and best practices
- Potential bugs and edge cases
- Performance implications
- Security considerations
- Qualidade do código e melhores práticas
- Bugs potenciais e casos de borda
- Implicações de desempenho
- Considerações de segurança
Provide constructive feedback without making direct changes.
Forneça feedback construtivo sem fazer alterações diretas.
```
O nome do arquivo markdown se torna o nome do agente. Por exemplo, `review.md` cria um agente `review`.
@@ -224,7 +224,7 @@ Use a opção `description` para fornecer uma breve descrição do que o agente
{
"agent": {
"review": {
"description": "Reviews code for best practices and potential issues"
"description": "Revisa código para melhores práticas e potenciais problemas"
}
}
}
@@ -291,8 +291,8 @@ Se isso não for definido, o agente continuará a iterar até que o modelo decid
{
"agent": {
"quick-thinker": {
"description": "Fast reasoning with limited iterations",
"prompt": "You are a quick thinker. Solve problems with minimal steps.",
"description": "Raciocínio rápido com iterações limitadas",
"prompt": "Você é um pensador rápido. Resolva problemas com etapas mínimas.",
"steps": 5
}
}
@@ -449,7 +449,7 @@ Você também pode definir permissões em agentes Markdown.
```markdown title="~/.config/opencode/agents/review.md"
---
description: Code review without edits
description: Revisão de código sem edições
mode: subagent
permission:
edit: deny
@@ -461,7 +461,7 @@ permission:
webfetch: deny
---
Only analyze code and suggest changes.
Apenas analise o código e sugira alterações.
```
Você pode definir permissões para comandos bash específicos.
@@ -645,7 +645,7 @@ Por exemplo, com os modelos de raciocínio da OpenAI, você pode controlar o esf
{
"agent": {
"deep-thinker": {
"description": "Agent that uses high reasoning effort for complex problems",
"description": "Agente que usa alto esforço de raciocínio para problemas complexos",
"model": "openai/gpt-5",
"reasoningEffort": "high",
"textVerbosity": "low"
@@ -662,7 +662,7 @@ Execute `opencode models` para ver uma lista dos modelos disponíveis.
---
## Criar agentes
## Criando agentes
Você pode criar novos agentes usando o seguinte comando:
@@ -706,20 +706,20 @@ Você tem um agente que gostaria de compartilhar? [Envie um PR](https://github.c
```markdown title="~/.config/opencode/agents/docs-writer.md"
---
description: Writes and maintains project documentation
description: Escreve e mantém a documentação do projeto
mode: subagent
tools:
bash: false
---
You are a technical writer. Create clear, comprehensive documentation.
Você é um escritor técnico. Crie documentação clara e abrangente.
Focus on:
Foque em:
- Clear explanations
- Proper structure
- Code examples
- User-friendly language
- Explicações claras
- Estrutura adequada
- Exemplos de código
- Linguagem amigável ao usuário
```
---
@@ -728,20 +728,20 @@ Focus on:
```markdown title="~/.config/opencode/agents/security-auditor.md"
---
description: Performs security audits and identifies vulnerabilities
description: Realiza auditorias de segurança e identifica vulnerabilidades
mode: subagent
tools:
write: false
edit: false
---
You are a security expert. Focus on identifying potential security issues.
Você é um especialista em segurança. Foque em identificar potenciais problemas de segurança.
Look for:
Procure por:
- Input validation vulnerabilities
- Authentication and authorization flaws
- Data exposure risks
- Dependency vulnerabilities
- Configuration security issues
- Vulnerabilidades de validação de entrada
- Falhas de autenticação e autorização
- Riscos de exposição de dados
- Vulnerabilidades de dependência
- Problemas de segurança de configuração
```

View File

@@ -27,7 +27,7 @@ Inicie a interface de usuário do terminal do opencode.
opencode [project]
```
#### Flags
#### Opções
| Flag | Curto | Descrição |
| ------------ | ----- | -------------------------------------------------------------------------- |
@@ -69,14 +69,14 @@ opencode attach [url]
Isso permite usar o TUI com um backend opencode remoto. Por exemplo:
```bash
# Start the backend server for web/mobile access
# Inicie o servidor backend para acesso web/mobile
opencode web --port 4096 --hostname 0.0.0.0
# In another terminal, attach the TUI to the running backend
# Em outro terminal, anexe o TUI ao backend em execução
opencode attach http://10.20.30.40:4096
```
#### Flags
#### Opções
| Flag | Curto | Descrição |
| ----------- | ----- | ---------------------------------------- |
@@ -185,7 +185,7 @@ Execute o agente do GitHub. Isso é tipicamente usado em GitHub Actions.
opencode github run
```
##### Flags
##### Opções
| Flag | Descrição |
| --------- | ------------------------------------------------ |
@@ -294,7 +294,7 @@ Você pode opcionalmente passar um ID de provedor para filtrar modelos por esse
opencode models anthropic
```
#### Flags
#### Opções
| Flag | Descrição |
| ----------- | --------------------------------------------------------------------- |
@@ -320,20 +320,20 @@ opencode run [message..]
Isso é útil para scripts, automação ou quando você deseja uma resposta rápida sem iniciar o TUI completo. Por exemplo.
```bash "opencode run"
opencode run Explain the use of context in Go
opencode run Explique o uso de context em Go
```
Você também pode se anexar a uma instância em execução do `opencode serve` para evitar tempos de inicialização a frio do servidor MCP em cada execução:
```bash
# Start a headless server in one terminal
# Inicie um servidor sem cabeça em um terminal
opencode serve
# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
# Em outro terminal, execute comandos que se anexam a ele
opencode run --attach http://localhost:4096 "Explique async/await em JavaScript"
```
#### Flags
#### Opções
| Flag | Curto | Descrição |
| ------------ | ----- | ----------------------------------------------------------------------------- |
@@ -362,7 +362,7 @@ opencode serve
Isso inicia um servidor HTTP que fornece acesso à funcionalidade do opencode sem a interface TUI. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`).
#### Flags
#### Opções
| Flag | Descrição |
| ------------ | ----------------------------------------------------- |
@@ -391,7 +391,7 @@ Liste todas as sessões do opencode.
opencode session list
```
##### Flags
##### Opções
| Flag | Curto | Descrição |
| ------------- | ----- | ----------------------------------------- |
@@ -408,7 +408,7 @@ Mostre o uso de tokens e estatísticas de custo para suas sessões do opencode.
opencode stats
```
#### Flags
#### Opções
| Flag | Descrição |
| ----------- | ---------------------------------------------------------------------------------------------------- |
@@ -458,7 +458,7 @@ opencode web
Isso inicia um servidor HTTP e abre um navegador para acessar o opencode através de uma interface web. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`).
#### Flags
#### Opções
| Flag | Descrição |
| ------------ | ----------------------------------------------------- |
@@ -479,7 +479,7 @@ opencode acp
Este comando inicia um servidor ACP que se comunica via stdin/stdout usando nd-JSON.
#### Flags
#### Opções
| Flag | Descrição |
| ------------ | ------------------------- |
@@ -497,7 +497,7 @@ Desinstale o opencode e remova todos os arquivos relacionados.
opencode uninstall
```
#### Flags
#### Opções
| Flag | Curto | Descrição |
| --------------- | ----- | ---------------------------------------- |
@@ -528,7 +528,7 @@ Para atualizar para uma versão específica.
opencode upgrade v0.1.48
```
#### Flags
#### Opções
| Flag | Curto | Descrição |
| ---------- | ----- | ---------------------------------------------------------------- |
@@ -536,7 +536,7 @@ opencode upgrade v0.1.48
---
## Flags Globais
## Opções Globais
A CLI do opencode aceita as seguintes flags globais.

View File

@@ -13,7 +13,7 @@ Comandos personalizados são adicionais aos comandos integrados como `/init`, `/
---
## Criar arquivos de comando
## Criando arquivos de comando
Crie arquivos markdown no diretório `commands/` para definir comandos personalizados.
@@ -21,13 +21,13 @@ Crie `.opencode/commands/test.md`:
```md title=".opencode/commands/test.md"
---
description: Run tests with coverage
description: Execute testes com cobertura
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.
Concentre-se nos testes com falha e sugira correções.
```
O frontmatter define as propriedades do comando. O conteúdo se torna o template.
@@ -40,7 +40,7 @@ Use o comando digitando `/` seguido pelo nome do comando.
---
## Configurar
## Configuração
Você pode adicionar comandos personalizados através da configuração do opencode ou criando arquivos markdown no diretório `commands/`.
@@ -54,12 +54,12 @@ Use a opção `command` na sua [configuração](/docs/config) do opencode:
{
"$schema": "https://opencode.ai/config.json",
"command": {
// This becomes the name of the command
// Isso se torna o nome do comando
"test": {
// This is the prompt that will be sent to the LLM
"template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
// This is shown as the description in the TUI
"description": "Run tests with coverage",
// Este é o prompt que será enviado ao LLM
"template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções.",
// Isso é exibido como a descrição no TUI
"description": "Execute testes com cobertura",
"agent": "build",
"model": "anthropic/claude-3-5-sonnet-20241022"
}
@@ -84,13 +84,13 @@ Você também pode definir comandos usando arquivos markdown. Coloque-os em:
```markdown title="~/.config/opencode/commands/test.md"
---
description: Run tests with coverage
description: Execute testes com cobertura
agent: build
model: anthropic/claude-3-5-sonnet-20241022
---
Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.
Concentre-se nos testes com falha e sugira correções.
```
O nome do arquivo markdown se torna o nome do comando. Por exemplo, `test.md` permite que você execute:
@@ -113,11 +113,11 @@ Passe argumentos para os comandos usando o espaço reservado `$ARGUMENTS`.
```md title=".opencode/commands/component.md"
---
description: Create a new component
description: Crie um novo componente
---
Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.
Crie um novo componente React chamado $ARGUMENTS com suporte a TypeScript.
Inclua tipagem adequada e estrutura básica.
```
Execute o comando com argumentos:
@@ -139,11 +139,11 @@ Por exemplo:
```md title=".opencode/commands/create-file.md"
---
description: Create a new file with content
description: Crie um novo arquivo com conteúdo
---
Create a file named $1 in the directory $2
with the following content: $3
Crie um arquivo chamado $1 no diretório $2
com o seguinte conteúdo: $3
```
Execute o comando:
@@ -168,26 +168,26 @@ Por exemplo, para criar um comando personalizado que analisa a cobertura de test
```md title=".opencode/commands/analyze-coverage.md"
---
description: Analyze test coverage
description: Analise cobertura de testes
---
Here are the current test results:
Aqui estão os resultados atuais dos testes:
!`npm test`
Based on these results, suggest improvements to increase coverage.
Com base nesses resultados, sugira melhorias para aumentar a cobertura.
```
Ou para revisar alterações recentes:
```md title=".opencode/commands/review-changes.md"
---
description: Review recent changes
description: Revise alterações recentes
---
Recent git commits:
Commits recentes do git:
!`git log --oneline -10`
Review these changes and suggest any improvements.
Revise essas alterações e sugira quaisquer melhorias.
```
Os comandos são executados no diretório raiz do seu projeto e sua saída se torna parte do prompt.
@@ -200,11 +200,11 @@ Inclua arquivos no seu comando usando `@` seguido pelo nome do arquivo.
```md title=".opencode/commands/review-component.md"
---
description: Review component
description: Revise componente
---
Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.
Revise o componente em @src/components/Button.tsx.
Verifique problemas de desempenho e sugira melhorias.
```
O conteúdo do arquivo é incluído automaticamente no prompt.
@@ -225,7 +225,7 @@ A opção `template` define o prompt que será enviado ao LLM quando o comando f
{
"command": {
"test": {
"template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
"template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções."
}
}
}
@@ -243,7 +243,7 @@ Use a opção `description` para fornecer uma breve descrição do que o comando
{
"command": {
"test": {
"description": "Run tests with coverage"
"description": "Execute testes com cobertura"
}
}
}
@@ -311,7 +311,7 @@ Esta é uma opção de configuração **opcional**.
---
## Integrado
## Integrados
opencode inclui vários comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`; [saiba mais](/docs/tui#commands).

View File

@@ -1,5 +1,5 @@
---
title: Config
title: Configuração
description: Usando a configuração JSON do opencode.
---
@@ -23,9 +23,9 @@ O opencode suporta os formatos **JSON** e **JSONC** (JSON com Comentários).
---
## Localizações
## Locais
Você pode colocar sua configuração em algumas localizações diferentes e elas têm uma
Você pode colocar sua configuração em alguns locais diferentes e eles têm uma
ordem de precedência diferente.
:::note
@@ -320,11 +320,11 @@ Você pode configurar agentes especializados para tarefas específicas através
"$schema": "https://opencode.ai/config.json",
"agent": {
"code-reviewer": {
"description": "Reviews code for best practices and potential issues",
"description": "Revisa código para melhores práticas e potenciais problemas",
"model": "anthropic/claude-sonnet-4-5",
"prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
"prompt": "Você é um revisor de código. Foque em segurança, performance e manutenibilidade.",
"tools": {
// Disable file modification tools for review-only agent
// Desabilitar ferramentas de modificação de arquivo para agente de apenas revisão
"write": false,
"edit": false,
},
@@ -384,14 +384,14 @@ Você pode configurar comandos personalizados para tarefas repetitivas através
"$schema": "https://opencode.ai/config.json",
"command": {
"test": {
"template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
"description": "Run tests with coverage",
"template": "Execute a suíte de testes completa com relatório de cobertura e mostre quaisquer falhas.\nConcentre-se nos testes com falha e sugira correções.",
"description": "Execute testes com cobertura",
"agent": "build",
"model": "anthropic/claude-haiku-4-5",
},
"component": {
"template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.",
"description": "Create a new component",
"template": "Crie um novo componente React chamado $ARGUMENTS com suporte a TypeScript.\nInclua tipagem adequada e estrutura básica.",
"description": "Crie um novo componente",
},
},
}

View File

@@ -1,6 +1,6 @@
---
title: Ferramentas Personalizadas
description: Crie ferramentas que o LLM pode chamar em opencode.
description: Crie ferramentas que o LLM pode chamar no opencode.
---
Ferramentas personalizadas são funções que você cria e que o LLM pode chamar durante as conversas. Elas funcionam junto com as [ferramentas integradas](/docs/tools) do opencode, como `read`, `write` e `bash`.
@@ -30,13 +30,13 @@ A maneira mais fácil de criar ferramentas é usando o helper `tool()`, que forn
import { tool } from "@opencode-ai/plugin"
export default tool({
description: "Query the project database",
description: "Consultar o banco de dados do projeto",
args: {
query: tool.schema.string().describe("SQL query to execute"),
query: tool.schema.string().describe("Consulta SQL para executar"),
},
async execute(args) {
// Your database logic here
return `Executed query: ${args.query}`
// Sua lógica de banco de dados aqui
return `Consulta executada: ${args.query}`
},
})
```
@@ -53,10 +53,10 @@ Você também pode exportar várias ferramentas de um único arquivo. Cada expor
import { tool } from "@opencode-ai/plugin"
export const add = tool({
description: "Add two numbers",
description: "Adicionar dois números",
args: {
a: tool.schema.number().describe("First number"),
b: tool.schema.number().describe("Second number"),
a: tool.schema.number().describe("Primeiro número"),
b: tool.schema.number().describe("Segundo número"),
},
async execute(args) {
return args.a + args.b
@@ -64,10 +64,10 @@ export const add = tool({
})
export const multiply = tool({
description: "Multiply two numbers",
description: "Multiplicar dois números",
args: {
a: tool.schema.number().describe("First number"),
b: tool.schema.number().describe("Second number"),
a: tool.schema.number().describe("Primeiro número"),
b: tool.schema.number().describe("Segundo número"),
},
async execute(args) {
return args.a * args.b
@@ -85,7 +85,7 @@ Você pode usar `tool.schema`, que é apenas [Zod](https://zod.dev), para defini
```ts "tool.schema"
args: {
query: tool.schema.string().describe("SQL query to execute")
query: tool.schema.string().describe("Consulta SQL para executar")
}
```
@@ -95,12 +95,12 @@ Você também pode importar [Zod](https://zod.dev) diretamente e retornar um obj
import { z } from "zod"
export default {
description: "Tool description",
description: "Descrição da ferramenta",
args: {
param: z.string().describe("Parameter description"),
param: z.string().describe("Descrição do parâmetro"),
},
async execute(args, context) {
// Tool implementation
// Implementação da ferramenta
return "result"
},
}
@@ -116,10 +116,10 @@ As ferramentas recebem contexto sobre a sessão atual:
import { tool } from "@opencode-ai/plugin"
export default tool({
description: "Get project information",
description: "Obter informações do projeto",
args: {},
async execute(args, context) {
// Access context information
// Acessar informações de contexto
const { agent, sessionID, messageID, directory, worktree } = context
return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
},
@@ -133,7 +133,7 @@ Use `context.worktree` para a raiz do worktree do git.
## Exemplos
### Escreva uma ferramenta em Python
### Escrevendo uma ferramenta em Python
Você pode escrever suas ferramentas em qualquer linguagem que desejar. Aqui está um exemplo que adiciona dois números usando Python.
@@ -154,10 +154,10 @@ import { tool } from "@opencode-ai/plugin"
import path from "path"
export default tool({
description: "Add two numbers using Python",
description: "Adicionar dois números usando Python",
args: {
a: tool.schema.number().describe("First number"),
b: tool.schema.number().describe("Second number"),
a: tool.schema.number().describe("Primeiro número"),
b: tool.schema.number().describe("Segundo número"),
},
async execute(args, context) {
const script = path.join(context.worktree, ".opencode/tools/add.py")

View File

@@ -1,6 +1,6 @@
---
title: Ecossistema
description: Projetos e integrações construídos com opencode.
description: Projetos e integrações construídos com o opencode.
---
Uma coleção de projetos da comunidade construídos sobre o opencode.
@@ -27,7 +27,7 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Plugin Google Antigravity OAuth, com suporte para Google Search e manuseio de API mais robusto |
| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | Otimize o uso de tokens podando saídas de ferramentas obsoletas |
| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Adicione suporte nativo de pesquisa na web para provedores suportados com estilo fundamentado no Google |
| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permite que agentes de AI executem processos em segundo plano em um PTY, enviando entrada interativa para eles. |
| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permite que agentes de IA executem processos em segundo plano em um PTY, enviando entrada interativa para eles. |
| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instruções para comandos de shell não interativos - evita travamentos de operações dependentes de TTY |
| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Acompanhe o uso do opencode com Wakatime |
| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Limpe tabelas markdown produzidas por LLMs |
@@ -35,14 +35,14 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Agentes em segundo plano, ferramentas LSP/AST/MCP pré-construídas, agentes curados, compatível com Claude Code |
| [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notificações de desktop e alertas sonoros para sessões do opencode |
| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Notificações de desktop e alertas sonoros para eventos de permissão, conclusão e erro |
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de AI com base no contexto do opencode |
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de IA com base no contexto do opencode |
| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Permite que agentes do opencode carreguem prompts sob demanda com descoberta e injeção de habilidades |
| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | Memória persistente entre sessões usando Supermemory |
| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | Revisão de plano interativa com anotação visual e compartilhamento privado/offline |
| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | Estenda opencode /commands em um poderoso sistema de orquestração com controle de fluxo granular |
| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | Agende trabalhos recorrentes usando launchd (Mac) ou systemd (Linux) com sintaxe cron |
| [micode](https://github.com/vtemian/micode) | Fluxo de trabalho Estruturado Brainstorm → Planejar → Implementar com continuidade de sessão |
| [octto](https://github.com/vtemian/octto) | UI interativa do navegador para brainstorming de AI com formulários de múltiplas perguntas |
| [octto](https://github.com/vtemian/octto) | UI interativa do navegador para brainstorming de IA com formulários de múltiplas perguntas |
| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Agentes em segundo plano estilo Claude Code com delegação assíncrona e persistência de contexto |
| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notificações nativas do OS para opencode saiba quando as tarefas são concluídas |
| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Conjunto de orquestração multi-agente 16 componentes, uma instalação |
@@ -58,7 +58,7 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim para prompts cientes do editor, construído sobre a API |
| [portal](https://github.com/hosenur/portal) | UI web mobile-first para opencode sobre Tailscale/VPN |
| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Template para construir plugins do opencode |
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim para opencode - um agente de codificação AI baseado em terminal |
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim para opencode - um agente de codificação IA baseado em terminal |
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Provedor Vercel AI SDK para usar opencode via @opencode-ai/sdk |
| [OpenChamber](https://github.com/btriapitsyn/openchamber) | Aplicativo Web / Desktop e Extensão do VS Code para opencode |
| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Plugin Obsidian que incorpora opencode na UI do Obsidian |
@@ -72,5 +72,5 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
| Nome | Descrição |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [Agentic](https://github.com/Cluster444/agentic) | Agentes e comandos de AI modulares para desenvolvimento estruturado |
| [Agentic](https://github.com/Cluster444/agentic) | Agentes e comandos de IA modulares para desenvolvimento estruturado |
| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | Configurações, prompts, agentes e plugins para fluxos de trabalho aprimorados |

View File

@@ -1,18 +1,18 @@
---
title: Empresa
description: Usando opencode com segurança em sua organização.
description: Usando o opencode com segurança em sua organização.
---
import config from "../../../../config.mjs"
export const email = `mailto:${config.email}`
opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de AI interno.
O opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
:::note
opencode não armazena nenhum de seus códigos ou dados de contexto.
O opencode não armazena nenhum de seus códigos ou dados de contexto.
:::
Para começar com opencode Enterprise:
Para começar com o opencode Enterprise:
1. Faça um teste internamente com sua equipe.
2. **<a href={email}>Entre em contato conosco</a>** para discutir opções de preços e implementação.
@@ -21,15 +21,15 @@ Para começar com opencode Enterprise:
## Teste
opencode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste.
O opencode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste.
---
### Manipulação de dados
**opencode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de AI.
**O opencode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA.
Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de AI interno, você pode usar o opencode com segurança.
Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de IA interno, você pode usar o opencode com segurança.
A única ressalva aqui é o recurso opcional `/share`.
@@ -76,7 +76,7 @@ Uma vez que você tenha concluído seu teste e esteja pronto para usar o opencod
Podemos configurar o opencode para usar uma única configuração central para toda a sua organização.
Essa configuração centralizada pode se integrar ao seu provedor de SSO e garante que todos os usuários acessem apenas seu gateway de AI interno.
Essa configuração centralizada pode se integrar ao seu provedor de SSO e garante que todos os usuários acessem apenas seu gateway de IA interno.
---
@@ -84,15 +84,15 @@ Essa configuração centralizada pode se integrar ao seu provedor de SSO e garan
Através da configuração central, o opencode pode se integrar ao provedor de SSO de sua organização para autenticação.
Isso permite que o opencode obtenha credenciais para seu gateway de AI interno através do seu sistema de gerenciamento de identidade existente.
Isso permite que o opencode obtenha credenciais para seu gateway de IA interno através do seu sistema de gerenciamento de identidade existente.
---
### Gateway de AI Interno
### Gateway de IA Interno
Com a configuração central, o opencode também pode ser configurado para usar apenas seu gateway de AI interno.
Com a configuração central, o opencode também pode ser configurado para usar apenas seu gateway de IA interno.
Você também pode desativar todos os outros provedores de AI, garantindo que todas as solicitações passem pela infraestrutura aprovada de sua organização.
Você também pode desativar todos os outros provedores de IA, garantindo que todas as solicitações passem pela infraestrutura aprovada de sua organização.
---
@@ -107,14 +107,14 @@ Isso está atualmente em nosso roadmap. Se você estiver interessado, **<a href=
## FAQ
<details>
<summary>O que é opencode Enterprise?</summary>
<summary>O que é o opencode Enterprise?</summary>
opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de AI interno.
O opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
</details>
<details>
<summary>Como posso começar com opencode Enterprise?</summary>
<summary>Como posso começar com o opencode Enterprise?</summary>
Basta começar com um teste interno com sua equipe. O opencode, por padrão, não armazena seu código ou dados de contexto, facilitando o início.
@@ -130,9 +130,9 @@ Oferecemos preços empresariais por assento. Se você tiver seu próprio gateway
</details>
<details>
<summary>Meus dados estão seguros com opencode Enterprise?</summary>
<summary>Meus dados estão seguros com o opencode Enterprise?</summary>
Sim. O opencode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de AI. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização.
Sim. O opencode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização.
</details>

View File

@@ -1,15 +1,15 @@
---
title: Formatadores
description: opencode usa formatadores específicos de linguagem.
description: O opencode usa formatadores específicos de linguagem.
---
opencode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto.
O opencode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto.
---
## Integrado
## Integrados
opencode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias.
O opencode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias.
| Formatador | Extensões | Requisitos |
| -------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
@@ -54,7 +54,7 @@ Esse processo acontece em segundo plano, garantindo que seus estilos de código
---
## Configurar
## Configuração
Você pode personalizar os formatadores através da seção `formatter` em sua configuração do opencode.

View File

@@ -1,9 +1,9 @@
---
title: GitHub
description: Use opencode em problemas e pull-requests do GitHub.
description: Use o opencode em problemas e pull-requests do GitHub.
---
opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions.
O opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions.
---
@@ -139,15 +139,15 @@ jobs:
with:
persist-credentials: false
- name: Run OpenCode
uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
prompt: |
Review the codebase for any TODO comments and create a summary.
If you find issues worth addressing, open an issue to track them.
- name: Run OpenCode
uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
prompt: |
Revise a base de código para quaisquer comentários TODO e crie um resumo.
Se encontrar problemas que valham a pena resolver, abra um issue para rastreá-los.
```
Para eventos agendados, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. Fluxos de trabalho agendados são executados sem um contexto de usuário para verificação de permissões, então o fluxo de trabalho deve conceder `contents: write` e `pull-requests: write` se você espera que o opencode crie branches ou PRs.
@@ -177,18 +177,18 @@ jobs:
- uses: actions/checkout@v6
with:
persist-credentials: false
- uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
model: anthropic/claude-sonnet-4-20250514
use_github_token: true
prompt: |
Review this pull request:
- Check for code quality issues
- Look for potential bugs
- Suggest improvements
- uses: anomalyco/opencode/github@latest
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
model: anthropic/claude-sonnet-4-20250514
use_github_token: true
prompt: |
Revise este pull request:
- Verifique problemas de qualidade de código
- Procure por potenciais bugs
- Sugira melhorias
```
Para eventos de `pull_request`, se nenhum `prompt` for fornecido, o opencode padrão será revisar o pull request.
@@ -233,17 +233,17 @@ jobs:
with:
persist-credentials: false
- uses: anomalyco/opencode/github@latest
if: steps.check.outputs.result == 'true'
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
prompt: |
Review this issue. If there's a clear fix or relevant docs:
- Provide documentation links
- Add error handling guidance for code examples
Otherwise, do not comment.
- uses: anomalyco/opencode/github@latest
if: steps.check.outputs.result == 'true'
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
with:
model: anthropic/claude-sonnet-4-20250514
prompt: |
Revise este issue. Se houver uma correção clara ou docs relevantes:
- Forneça links de documentação
- Adicione orientação sobre tratamento de erros para exemplos de código
Caso contrário, não comente.
```
Para eventos de `issues`, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções.
@@ -259,10 +259,10 @@ Substitua o prompt padrão para personalizar o comportamento do opencode para se
with:
model: anthropic/claude-sonnet-4-5
prompt: |
Review this pull request:
- Check for code quality issues
- Look for potential bugs
- Suggest improvements
Revise este pull request:
- Verifique problemas de qualidade de código
- Procure por potenciais bugs
- Sugira melhorias
```
Isso é útil para impor critérios de revisão específicos, padrões de codificação ou áreas de foco relevantes para seu projeto.
@@ -308,7 +308,7 @@ Aqui estão alguns exemplos de como você pode usar o opencode no GitHub.
Deixe um comentário diretamente nas linhas de código na aba "Files" do PR. O opencode detecta automaticamente o arquivo, os números das linhas e o contexto do diff para fornecer respostas precisas.
```
[Comment on specific lines in Files tab]
[Comentário em linhas específicas na aba Files]
/oc add error handling here
```

View File

@@ -1,9 +1,9 @@
---
title: GitLab
description: Use opencode em problemas e solicitações de mesclagem do GitLab.
description: Use o opencode em problemas e solicitações de mesclagem do GitLab.
---
opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.
O opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.
Em ambos os casos, o opencode será executado em seus runners do GitLab.
@@ -11,7 +11,7 @@ Em ambos os casos, o opencode será executado em seus runners do GitLab.
## GitLab CI
opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/)
O opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/)
Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
@@ -35,9 +35,9 @@ Aqui estamos usando um componente CI/CD criado pela comunidade para opencode —
- component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2
inputs:
config_dir: ${CI_PROJECT_DIR}/opencode-config
auth_json: $OPENCODE_AUTH_JSON # The variable name for your OpenCode authentication JSON
auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do OpenCode
command: optional-custom-command
message: "Your prompt here"
message: "Seu prompt aqui"
```
Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) deste componente.
@@ -46,7 +46,7 @@ Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com
## GitLab Duo
opencode se integra ao seu fluxo de trabalho do GitLab.
O opencode se integra ao seu fluxo de trabalho do GitLab.
Mencione `@opencode` em um comentário, e o opencode executará tarefas dentro do seu pipeline CI do GitLab.
---
@@ -70,7 +70,7 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent
1. Configure seu ambiente GitLab
2. Configure CI/CD
3. Obtenha uma chave de API do provedor de modelo de AI
3. Obtenha uma chave de API do provedor de modelo de IA
4. Crie uma conta de serviço
5. Configure variáveis de CI/CD
6. Crie um arquivo de configuração de fluxo, aqui está um exemplo:
@@ -82,16 +82,16 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent
```yaml
image: node:22-slim
commands:
- echo "Installing opencode"
- echo "Instalando opencode"
- npm install --global opencode-ai
- echo "Installing glab"
- echo "Instalando glab"
- export GITLAB_TOKEN=$GITLAB_TOKEN_OPENCODE
- apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/*
- curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash
- apt-get install --yes glab
- echo "Configuring glab"
- echo "Configurando glab"
- echo $GITLAB_HOST
- echo "Creating OpenCode auth configuration"
- echo "Criando configuração de auth do OpenCode"
- mkdir --parents ~/.local/share/opencode
- |
cat > ~/.local/share/opencode/auth.json << EOF
@@ -102,47 +102,47 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent
}
}
EOF
- echo "Configuring git"
- echo "Configurando git"
- git config --global user.email "opencode@gitlab.com"
- git config --global user.name "OpenCode"
- echo "Testing glab"
- echo "Testando glab"
- glab issue list
- echo "Running OpenCode"
- echo "Executando OpenCode"
- |
opencode run "
You are an AI assistant helping with GitLab operations.
Você é um assistente de IA ajudando com operações do GitLab.
Context: $AI_FLOW_CONTEXT
Task: $AI_FLOW_INPUT
Event: $AI_FLOW_EVENT
Contexto: $AI_FLOW_CONTEXT
Tarefa: $AI_FLOW_INPUT
Evento: $AI_FLOW_EVENT
Please execute the requested task using the available GitLab tools.
Be thorough in your analysis and provide clear explanations.
Por favor, execute a tarefa solicitada usando as ferramentas disponíveis do GitLab.
Seja minucioso em sua análise e forneça explicações claras.
<important>
Please use the glab CLI to access data from GitLab. The glab CLI has already been authenticated. You can run the corresponding commands.
Por favor, use a CLI glab para acessar dados do GitLab. A CLI glab já foi autenticada. Você pode executar os comandos correspondentes.
If you are asked to summarize an MR or issue or asked to provide more information then please post back a note to the MR/Issue so that the user can see it.
You don't need to commit or push up changes, those will be done automatically based on the file changes you make.
Se for solicitado a resumir um MR ou problema ou solicitado a fornecer mais informações, poste uma nota de volta no MR/Problema para que o usuário possa ver.
Você não precisa commitar ou enviar alterações, isso será feito automaticamente com base nas alterações de arquivo que você fizer.
</important>
"
- git checkout --branch $CI_WORKLOAD_REF origin/$CI_WORKLOAD_REF
- echo "Checking for git changes and pushing if any exist"
- echo "Verificando alterações no git e enviando se existirem"
- |
if ! git diff --quiet || ! git diff --cached --quiet || [ --not --zero "$(git ls-files --others --exclude-standard)" ]; then
echo "Git changes detected, adding and pushing..."
echo "Alterações git detectadas, adicionando e enviando..."
git add .
if git diff --cached --quiet; then
echo "No staged changes to commit"
echo "Nenhuma alteração preparada para commit"
else
echo "Committing changes to branch: $CI_WORKLOAD_REF"
echo "Commitando alterações para o branch: $CI_WORKLOAD_REF"
git commit --message "Codex changes"
echo "Pushing changes up to $CI_WORKLOAD_REF"
echo "Enviando alterações para $CI_WORKLOAD_REF"
git push https://gitlab-ci-token:$GITLAB_TOKEN@$GITLAB_HOST/gl-demo-ultimate-dev-ai-epic-17570/test-java-project.git $CI_WORKLOAD_REF
echo "Changes successfully pushed"
echo "Alterações enviadas com sucesso"
fi
else
echo "No git changes detected, skipping push"
echo "Nenhuma alteração git detectada, pulando envio"
fi
variables:
- ANTHROPIC_API_KEY

View File

@@ -1,9 +1,9 @@
---
title: IDE
description: A extensão opencode para VS Code, Cursor e outras IDEs
description: A extensão opencode para VS Code, Cursor e outros IDEs
---
opencode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar.
O opencode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar.
---
@@ -24,7 +24,7 @@ Para instalar o opencode no VS Code e forks populares como Cursor, Windsurf, VSC
2. Abra o terminal integrado
3. Execute `opencode` - a extensão será instalada automaticamente
Se, por outro lado, você quiser usar sua própria IDE ao executar `/editor` ou `/export` a partir do TUI, você precisará definir `export EDITOR="code --wait"`. [Saiba mais](/docs/tui/#editor-setup).
Se, por outro lado, você quiser usar seu próprio IDE ao executar `/editor` ou `/export` a partir do TUI, você precisará definir `export EDITOR="code --wait"`. [Saiba mais](/docs/tui/#editor-setup).
---
@@ -39,10 +39,10 @@ Procure por **opencode** no Marketplace de Extensões e clique em **Instalar**.
Se a extensão falhar ao instalar automaticamente:
- Certifique-se de que você está executando `opencode` no terminal integrado.
- Confirme se o CLI para sua IDE está instalado:
- Confirme se a CLI para seu IDE está instalado:
- Para VS Code: comando `code`
- Para Cursor: comando `cursor`
- Para Windsurf: comando `windsurf`
- Para VSCodium: comando `codium`
- Se não, execute `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) e procure por "Shell Command: Install 'code' command in PATH" (ou o equivalente para sua IDE)
- Se não, execute `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux) e procure por "Shell Command: Install 'code' command in PATH" (ou o equivalente para seu IDE)
- Certifique-se de que o VS Code tem permissão para instalar extensões

View File

@@ -1,13 +1,13 @@
---
title: Introdução
description: Comece com o opencode.
description: Comece a usar o opencode.
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**opencode**](/) é um agente de codificação AI de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE.
[**opencode**](/) é um agente de codificação de IA de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE.
![opencode TUI com o tema opencode](../../../assets/lander/screenshot.png)
@@ -29,7 +29,7 @@ Para usar o opencode no seu terminal, você precisará de:
---
## Instalar
## Instalação
A maneira mais fácil de instalar o opencode é através do script de instalação.
@@ -129,7 +129,7 @@ Você também pode baixar o binário na seção [Releases](https://github.com/an
---
## Configurar
## Configuração
Com o opencode, você pode usar qualquer provedor de LLM configurando suas chaves de API.
@@ -157,7 +157,7 @@ Alternativamente, você pode selecionar um dos outros provedores. [Saiba mais](/
---
## Inicializar
## Inicialização
Agora que você configurou um provedor, pode navegar até um projeto no qual deseja trabalhar.
@@ -191,11 +191,11 @@ Isso ajuda o opencode a entender a estrutura do projeto e os padrões de codific
Agora você está pronto para usar o opencode para trabalhar em seu projeto. Sinta-se à vontade para perguntar qualquer coisa!
Se você é novo no uso de um agente de codificação AI, aqui estão alguns exemplos que podem ajudar.
Se você é novo no uso de um agente de codificação de IA, aqui estão alguns exemplos que podem ajudar.
---
### Fazer perguntas
### Fazendo perguntas
Você pode pedir ao opencode para explicar a base de código para você.
@@ -211,7 +211,7 @@ Isso é útil se houver uma parte da base de código na qual você não trabalho
---
### Adicionar recursos
### Adicionando recursos
Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embora primeiro recomendemos pedir para ele criar um plano.
@@ -270,7 +270,7 @@ Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embor
---
### Fazer alterações
### Fazendo alterações
Para alterações mais simples, você pode pedir ao opencode para construí-las diretamente sem precisar revisar o plano primeiro.
@@ -284,7 +284,7 @@ Você quer ter certeza de fornecer uma boa quantidade de detalhes para que o ope
---
### Desfazer alterações
### Desfazendo alterações
Vamos supor que você peça ao opencode para fazer algumas alterações.
@@ -318,7 +318,7 @@ Ou você **pode refazer** as alterações usando o comando `/redo`.
---
## Compartilhar
## Compartilhamento
As conversas que você tem com o opencode podem ser [compartilhadas com sua equipe](/docs/share).
@@ -336,7 +336,7 @@ Aqui está uma [conversa de exemplo](https://opencode.ai/s/4XP1fce5) com o openc
---
## Personalizar
## Personalização
E é isso! Agora você é um profissional em usar o opencode.

View File

@@ -3,7 +3,7 @@ title: Atalhos de Teclado
description: Personalize seus atalhos de teclado.
---
opencode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do opencode.
O opencode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do opencode.
```json title="opencode.json"
{
@@ -107,7 +107,7 @@ opencode tem uma lista de atalhos de teclado que você pode personalizar atravé
## Tecla líder
opencode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal.
O opencode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal.
Por padrão, `ctrl+x` é a tecla líder e a maioria das ações requer que você primeiro pressione a tecla líder e depois o atalho. Por exemplo, para iniciar uma nova sessão, você primeiro pressiona `ctrl+x` e depois pressiona `n`.

View File

@@ -1,15 +1,15 @@
---
title: Servidores LSP
description: opencode integra-se aos seus servidores LSP.
description: O opencode integra-se aos seus servidores LSP.
---
opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
O opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
---
## Integrado
## Integrados
opencode vem com vários servidores LSP integrados para linguagens populares:
O opencode vem com vários servidores LSP integrados para linguagens populares:
| Servidor LSP | Extensões | Requisitos |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
@@ -63,7 +63,7 @@ Quando o opencode abre um arquivo, ele:
---
## Configurar
## Configuração
Você pode personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode.

View File

@@ -21,7 +21,7 @@ Certos servidores MCP, como o servidor MCP do GitHub, tendem a adicionar muitos
---
## Habilitar
## Habilitando
Você pode definir servidores MCP em sua [Configuração do opencode](https://opencode.ai/docs/config/) sob `mcp`. Adicione cada MCP com um nome único. Você pode se referir a esse MCP pelo nome ao solicitar ao LLM.
@@ -216,7 +216,7 @@ Se você tiver credenciais de cliente do provedor do servidor MCP, pode configur
---
### Autenticando
### Autenticação
Você pode iniciar manualmente a autenticação ou gerenciar credenciais.
@@ -289,7 +289,7 @@ O comando `mcp debug` mostra o status de autenticação atual, testa a conectivi
---
## Gerenciar
## Gerenciamento
Seus MCPs estão disponíveis como ferramentas no opencode, juntamente com ferramentas integradas. Portanto, você pode gerenciá-los através da configuração do opencode como qualquer outra ferramenta.

View File

@@ -3,7 +3,7 @@ title: Modelos
description: Configurando um provedor e modelo LLM.
---
opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
O opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
---
@@ -15,7 +15,7 @@ Saiba mais sobre [provedores](/docs/providers).
---
## Selecione um modelo
## Selecionando um modelo
Depois de configurar seu provedor, você pode selecionar o modelo que deseja digitando:
@@ -46,7 +46,7 @@ Aqui estão vários modelos que funcionam bem com o opencode, em nenhuma ordem e
---
## Defina um padrão
## Definindo um padrão
Para definir um desses como o modelo padrão, você pode definir a chave `model` na sua configuração do opencode.
@@ -63,7 +63,7 @@ Se você configurou um [provedor personalizado](/docs/providers#custom), o `prov
---
## Configurar modelos
## Configurando modelos
Você pode configurar globalmente as opções de um modelo através da configuração.

View File

@@ -15,19 +15,19 @@ Você pode alternar entre os modos durante uma sessão ou configurá-los no seu
---
## Integrado
## Integrados
O opencode vem com dois modos integrados.
---
### Build
### build
Build é o modo **padrão** com todas as ferramentas habilitadas. Este é o modo padrão para trabalho de desenvolvimento onde você precisa de acesso total a operações de arquivos e comandos do sistema.
---
### Plan
### plan
Um modo restrito projetado para planejamento e análise. No modo plan, as seguintes ferramentas estão desativadas por padrão:
@@ -36,7 +36,7 @@ Um modo restrito projetado para planejamento e análise. No modo plan, as seguin
- `patch` - Não pode aplicar patches
- `bash` - Não pode executar comandos de shell
Este modo é útil quando você deseja que a AI analise o código, sugira alterações ou crie planos sem fazer modificações reais em sua base de código.
Este modo é útil quando você deseja que a IA analise o código, sugira alterações ou crie planos sem fazer modificações reais em sua base de código.
---
@@ -48,7 +48,7 @@ Veja também: [Formatadores](/docs/formatters) para informações sobre configur
---
## Configurar
## Configuração
Você pode personalizar os modos integrados ou criar os seus próprios através da configuração. Os modos podem ser configurados de duas maneiras:
@@ -132,7 +132,7 @@ Use a configuração `model` para substituir o modelo padrão para este modo. Ú
### Temperatura
Controle a aleatoriedade e a criatividade das respostas da AI com a configuração `temperature`. Valores mais baixos tornam as respostas mais focadas e determinísticas, enquanto valores mais altos aumentam a criatividade e a variabilidade.
Controle a aleatoriedade e a criatividade das respostas da IA com a configuração `temperature`. Valores mais baixos tornam as respostas mais focadas e determinísticas, enquanto valores mais altos aumentam a criatividade e a variabilidade.
```json title="opencode.json"
{

View File

@@ -3,13 +3,13 @@ title: Rede
description: Configure proxies e certificados personalizados.
---
opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa.
O opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa.
---
## Proxy
opencode respeita variáveis de ambiente de proxy padrão.
O opencode respeita variáveis de ambiente de proxy padrão.
```bash
# HTTPS proxy (recommended)
@@ -30,7 +30,7 @@ Você pode configurar a porta e o nome do host do servidor usando [flags da CLI]
---
### Autenticar
### Autenticação
Se o seu proxy requer autenticação básica, inclua as credenciais na URL.

View File

@@ -3,7 +3,7 @@ title: Permissões
description: Controle quais ações requerem aprovação para serem executadas.
---
opencode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada.
O opencode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada.
A partir da versão `v1.1.1`, a configuração booleana legada `tools` foi descontinuada e mesclada na `permission`. A antiga configuração `tools` ainda é suportada para compatibilidade retroativa.

View File

@@ -9,7 +9,7 @@ Para exemplos, confira os [plugins](/docs/ecosystem#plugins) criados pela comuni
---
## Usar um plugin
## Usando um plugin
Existem duas maneiras de carregar plugins.
@@ -64,7 +64,7 @@ Pacotes npm duplicados com o mesmo nome e versão são carregados uma vez. No en
---
## Criar um plugin
## Criando um plugin
Um plugin é um **módulo JavaScript/TypeScript** que exporta uma ou mais funções de plugin. Cada função recebe um objeto de contexto e retorna um objeto de hooks.
@@ -214,7 +214,7 @@ Aqui estão alguns exemplos de plugins que você pode usar para estender o openc
---
### Enviar notificações
### Enviando notificações
Envie notificações quando certos eventos ocorrerem:
@@ -257,7 +257,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree })
---
### Injetar variáveis de ambiente
### Injetando variáveis de ambiente
Injete variáveis de ambiente em todas as execuções de shell (ferramentas de AI e terminais de usuário):

View File

@@ -258,11 +258,11 @@ Para perfis de inferência personalizados, use o nome do modelo e do provedor na
2. Aqui você pode selecionar a opção **Claude Pro/Max** e isso abrirá seu navegador e pedirá para você se autenticar.
```txt
┌ Select auth method
┌ Selecione o método de autenticação
│ Claude Pro/Max
│ Create an API Key
Manually enter API Key
│ Criar uma chave de API
Inserir manualmente a chave de API
```
@@ -278,9 +278,9 @@ Usar sua assinatura Claude Pro/Max no opencode não é oficialmente suportado pe
##### Usando chaves da API
Você também pode selecionar **Criar uma chave da API** se não tiver uma assinatura Pro/Max. Isso também abrirá seu navegador e pedirá que você faça login na Anthropic e lhe dará um código que você pode colar no seu terminal.
Você também pode selecionar **Criar uma chave de API** se não tiver uma assinatura Pro/Max. Isso também abrirá seu navegador e pedirá que você faça login na Anthropic e lhe dará um código que você pode colar no seu terminal.
Ou, se você já tiver uma chave da API, pode selecionar **Inserir chave da API manualmente** e colá-la no seu terminal.
Ou, se você já tiver uma chave da API, pode selecionar **Inserir manualmente a chave de API** e colá-la no seu terminal.
---
@@ -642,10 +642,10 @@ GitLab Duo fornece um chat agente com suporte a ferramentas nativas através do
2. Escolha seu método de autenticação:
```txt
┌ Select auth method
┌ Selecione o método de autenticação
│ OAuth (Recommended)
Personal Access Token
│ OAuth (Recomendado)
Token de Acesso Pessoal
```
@@ -797,13 +797,13 @@ Alguns modelos precisam ser habilitados manualmente nas suas [configurações do
2. Navegue até [github.com/login/device](https://github.com/login/device) e insira o código.
```txt
┌ Login with GitHub Copilot
┌ Login com GitHub Copilot
│ https://github.com/login/device
Enter code: 8F43-6FCF
Digite o código: 8F43-6FCF
Waiting for authorization...
Aguardando autorização...
```
3. Agora execute o comando `/models` para selecionar o modelo que você deseja.
@@ -1305,10 +1305,10 @@ Recomendamos se inscrever para [ChatGPT Plus ou Pro](https://chatgpt.com/pricing
2. Aqui você pode selecionar a opção **ChatGPT Plus/Pro** e isso abrirá seu navegador e pedirá para você se autenticar.
```txt
┌ Select auth method
┌ Selecione o método de autenticação
│ ChatGPT Plus/Pro
Manually enter API Key
Inserir manualmente a chave de API
```
@@ -1749,11 +1749,12 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior
```bash
$ /connect
┌ Add credential
┌ Adicionar credencial
◆ Select provider
...
● Other
▲ Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos.
Digite sua chave de API
│ sk-...
```
@@ -1762,10 +1763,12 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior
```bash
$ /connect
┌ Add credential
┌ Adicionar credencial
Enter provider id
myprovider
Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos.
◇ Digite sua chave de API
│ sk-...
```
@@ -1778,11 +1781,11 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior
```bash
$ /connect
┌ Add credential
┌ Adicionar credencial
This only stores a credential for myprovider - you will need to configure it in opencode.json, check the docs for examples.
Isso armazena apenas uma credencial para myprovider - você precisará configurá-lo no opencode.json, verifique a documentação para exemplos.
Enter your API key
Digite sua chave de API
│ sk-...
```
@@ -1795,16 +1798,18 @@ Você pode usar qualquer provedor compatível com OpenAI com o opencode. A maior
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "My AI ProviderDisplay Name",
"name": "Nome de Exibição do Meu Provedor de IA",
"options": {
"baseURL": "https://api.myprovider.com/v1"
},
"models": {
"my-model-name": {
"name": "My Model Display Name"
"name": "Nome de Exibição do Meu Modelo"
}
}
}
}
}
}
}
```
@@ -1833,7 +1838,7 @@ Aqui está um exemplo definindo as opções `apiKey`, `headers` e `limit` do mod
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "My AI ProviderDisplay Name",
"name": "Nome de Exibição do Meu Provedor de IA",
"options": {
"baseURL": "https://api.myprovider.com/v1",
"apiKey": "{env:ANTHROPIC_API_KEY}",
@@ -1843,7 +1848,19 @@ Aqui está um exemplo definindo as opções `apiKey`, `headers` e `limit` do mod
},
"models": {
"my-model-name": {
"name": "My Model Display Name",
"name": "Nome de Exibição do Meu Modelo",
"limit": {
"context": 200000,
"output": 65536
}
}
}
}
}
},
"models": {
"my-model-name": {
"name": "Nome de Exibição do Meu Modelo",
"limit": {
"context": 200000,
"output": 65536

View File

@@ -9,7 +9,7 @@ Por padrão, todas as ferramentas estão **ativadas** e não precisam de permiss
---
## Configurar
## Configuração
Use o campo `permission` para controlar o comportamento das ferramentas. Você pode permitir, negar ou exigir aprovação para cada ferramenta.

View File

@@ -22,7 +22,7 @@ Você pode definir o nível de log com a opção de linha de comando `--log-leve
## Armazenamento
opencode armazena dados de sessão e outros dados do aplicativo no disco em:
O opencode armazena dados de sessão e outros dados do aplicativo no disco em:
- **macOS/Linux**: `~/.local/share/opencode/`
- **Windows**: Pressione `WIN+R` e cole `%USERPROFILE%\.local\share\opencode`
@@ -39,7 +39,7 @@ Este diretório contém:
## Aplicativo de Desktop
opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta.
O opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta.
### Verificações rápidas
@@ -49,11 +49,11 @@ opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) e
---
### Desativar plugins
### Desativando plugins
Se o aplicativo de desktop estiver travando ao iniciar, pendurado ou se comportando de maneira estranha, comece desativando os plugins.
#### Verifique a configuração global
#### Verificando a configuração global
Abra seu arquivo de configuração global e procure uma chave `plugin`.
@@ -70,9 +70,9 @@ Se você tiver plugins configurados, desative-os temporariamente removendo a cha
}
```
#### Verifique os diretórios de plugins
#### Verificando os diretórios de plugins
opencode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop:
O opencode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop:
- **Plugins globais**
- **macOS/Linux**: `~/.config/opencode/plugins/`
@@ -84,7 +84,7 @@ Se o aplicativo voltar a funcionar, reative os plugins um por um para descobrir
---
### Limpar o cache
### Limpando o cache
Se desativar plugins não ajudar (ou se a instalação de um plugin estiver travada), limpe o cache para que o opencode possa reconstruí-lo.
@@ -99,21 +99,21 @@ Se desativar plugins não ajudar (ou se a instalação de um plugin estiver trav
---
### Corrigir problemas de conexão com o servidor
### Corrigindo problemas de conexão com o servidor
opencode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou.
O opencode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou.
Se você ver um diálogo **"Conexão Falhou"** (ou o aplicativo nunca passa da tela de inicialização), verifique se há uma URL de servidor personalizada.
#### Limpar a URL do servidor padrão do desktop
#### Limpando a URL do servidor padrão do desktop
Na tela inicial, clique no nome do servidor (com o ponto de status) para abrir o seletor de Servidor. Na seção **Servidor padrão**, clique em **Limpar**.
#### Remover `server.port` / `server.hostname` da sua configuração
#### Removendo `server.port` / `server.hostname` da sua configuração
Se seu `opencode.json(c)` contiver uma seção `server`, remova-a temporariamente e reinicie o aplicativo de desktop.
#### Verifique as variáveis de ambiente
#### Verificando as variáveis de ambiente
Se você tiver `OPENCODE_PORT` definido em seu ambiente, o aplicativo de desktop tentará usar essa porta para o servidor local.
@@ -130,7 +130,7 @@ No Linux, algumas configurações do Wayland podem causar janelas em branco ou e
---
### Windows: WebView2 runtime
### Windows: Runtime do WebView2
No Windows, o opencode Desktop requer o **WebView2 Runtime** do Microsoft Edge. Se o aplicativo abrir em uma janela em branco ou não iniciar, instale/atualize o WebView2 e tente novamente.
@@ -151,7 +151,7 @@ O opencode Desktop só mostra notificações do sistema quando:
---
### Redefinir o armazenamento do aplicativo de desktop (último recurso)
### Redefinindo o armazenamento do aplicativo de desktop (último recurso)
Se o aplicativo não iniciar e você não conseguir limpar as configurações pela interface, redefina o estado salvo do aplicativo de desktop.
@@ -195,7 +195,7 @@ Aqui estão alguns problemas comuns e como resolvê-los.
---
### opencode não inicia
### O opencode não inicia
1. Verifique os logs em busca de mensagens de erro
2. Tente executar com `--print-logs` para ver a saída no terminal
@@ -251,7 +251,7 @@ Para resolver isso:
### AI_APICallError e problemas com pacotes de provedores
Se você encontrar erros de chamada de API, isso pode ser devido a pacotes de provedores desatualizados. opencode instala dinamicamente pacotes de provedores (OpenAI, Anthropic, Google, etc.) conforme necessário e os armazena em cache localmente.
Se você encontrar erros de chamada de API, isso pode ser devido a pacotes de provedores desatualizados. O opencode instala dinamicamente pacotes de provedores (OpenAI, Anthropic, Google, etc.) conforme necessário e os armazena em cache localmente.
Para resolver problemas com pacotes de provedores:
@@ -296,4 +296,4 @@ Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0
```
opencode detectará se você está usando Wayland e preferirá `wl-clipboard`, caso contrário, tentará encontrar ferramentas de área de transferência na ordem: `xclip` e `xsel`.
O opencode detectará se você está usando Wayland e preferirá `wl-clipboard`, caso contrário, tentará encontrar ferramentas de área de transferência na ordem: `xclip` e `xsel`.

View File

@@ -5,7 +5,7 @@ description: Usando a interface de usuário de terminal opencode.
import { Tabs, TabItem } from "@astrojs/starlight/components"
opencode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM.
O opencode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM.
Executar opencode inicia o TUI para o diretório atual.
@@ -22,7 +22,7 @@ opencode /path/to/project
Uma vez que você esteja no TUI, você pode solicitar com uma mensagem.
```text
Give me a quick summary of the codebase.
Faça um resumo rápido da base de código.
```
---
@@ -36,7 +36,7 @@ Você também pode usar `@` para referenciar arquivos em suas mensagens.
:::
```text "@packages/functions/src/api/index.ts"
How is auth handled in @packages/functions/src/api/index.ts?
Como a autenticação é tratada em @packages/functions/src/api/index.ts?
```
O conteúdo do arquivo é adicionado à conversa automaticamente.
@@ -290,12 +290,12 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v
<Tabs>
<TabItem label="Linux/macOS">
```bash
# Example for nano or vim
# Exemplo para nano ou vim
export EDITOR=nano
export EDITOR=vim
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
# Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# inclua --wait
export EDITOR="code --wait"
```
@@ -308,8 +308,8 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v
```bash
set EDITOR=notepad
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
# Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# inclua --wait
set EDITOR=code --wait
```
@@ -321,8 +321,8 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v
```powershell
$env:EDITOR = "notepad"
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
# Para editores GUI, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# inclua --wait
$env:EDITOR = "code --wait"
```
@@ -350,7 +350,7 @@ Alguns editores precisam de argumentos de linha de comando para rodar em modo bl
---
## Configurar
## Configuração
Você pode personalizar o comportamento do TUI através do seu arquivo de configuração do opencode.

View File

@@ -1,13 +1,13 @@
---
title: Web
description: Usando opencode no seu navegador.
description: Usando o opencode no seu navegador.
---
opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com AI sem precisar de um terminal.
O opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com IA sem precisar de um terminal.
![opencode Web - Nova Sessão](../../../assets/web/web-homepage-new-session.png)
## Começando
## Primeiros passos
Inicie a interface web executando:

View File

@@ -1,11 +1,11 @@
---
title: Windows (WSL)
description: Execute o opencode no Windows com WSL para melhor experiencia.
description: Execute o opencode no Windows com WSL para melhor experiência.
---
import { Steps } from "@astrojs/starlight/components"
Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiencia. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode.
Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiência. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode.
:::tip[Por que WSL?]
O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o opencode depende.
@@ -13,17 +13,17 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi
---
## Configuracao
## Configuração
<Steps>
1. **Instale o WSL**
Se ainda nao instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft.
Se ainda não instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft.
2. **Instale o opencode no WSL**
Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [metodos de instalacao](/docs/).
Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [métodos de instalação](/docs/).
```bash
curl -fsSL https://opencode.ai/install | bash
@@ -31,7 +31,7 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi
3. **Use o opencode pelo WSL**
Va para o diretorio do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode.
Vá para o diretório do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode.
```bash
cd /mnt/c/Users/YourName/project
@@ -44,9 +44,9 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi
## App desktop + servidor WSL
Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL:
Se você prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL:
1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexoes externas:
1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexões externas:
```bash
opencode serve --hostname 0.0.0.0 --port 4096
@@ -55,7 +55,7 @@ Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL
2. **Conecte o app desktop** em `http://localhost:4096`
:::note
Se `localhost` nao funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: `hostname -I`) e use `http://<wsl-ip>:4096`.
Se `localhost` não funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: `hostname -I`) e use `http://<wsl-ip>:4096`.
:::
:::caution
@@ -71,7 +71,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
## Cliente web + WSL
Para a melhor experiencia web no Windows:
Para a melhor experiência web no Windows:
1. **Execute `opencode web` no terminal WSL** em vez do PowerShell:
@@ -81,13 +81,13 @@ Para a melhor experiencia web no Windows:
2. **Acesse pelo navegador do Windows** em `http://localhost:<port>` (o opencode mostra a URL)
Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integracao com o terminal, continuando acessivel no navegador do Windows.
Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integração com o terminal, continuando acessível no navegador do Windows.
---
## Acessar arquivos do Windows
O WSL pode acessar todos os arquivos do Windows pelo diretorio `/mnt/`:
O WSL pode acessar todos os arquivos do Windows pelo diretório `/mnt/`:
- Unidade `C:` → `/mnt/c/`
- Unidade `D:` → `/mnt/d/`
@@ -101,7 +101,7 @@ opencode
```
:::tip
Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por la.
Para uma experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por lá.
:::
---
@@ -109,5 +109,5 @@ Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o
## Dicas
- Mantenha o opencode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
- Use a [extensao WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado
- Sua configuracao e suas sessoes do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/`
- Use a [extensão WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado
- Sua configuração e suas sessões do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/`

View File

@@ -1,28 +1,28 @@
---
title: Zen
description: Lista selecionada de modelos fornecidos pela opencode.
description: Lista selecionada de modelos fornecidos pelo opencode.
---
import config from "../../../../config.mjs"
export const console = config.console
export const email = `mailto:${config.email}`
OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe da opencode.
O OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe do opencode.
:::note
OpenCode Zen está atualmente em beta.
O OpenCode Zen está atualmente em beta.
:::
Zen funciona como qualquer outro provedor na opencode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-la para utilizar a opencode.
O Zen funciona como qualquer outro provedor no opencode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-lo para utilizar o opencode.
---
## Contexto
Existem um grande número de modelos disponíveis, mas apenas alguns desses modelos funcionam bem como agentes de codificação. Além disso, a maioria dos provedores é configurada de maneira muito diferente; portanto, você obtém desempenhos e qualidades muito diferentes.
Existe um grande número de modelos disponíveis, mas apenas alguns desses modelos funcionam bem como agentes de codificação. Além disso, a maioria dos provedores é configurada de maneira muito diferente; portanto, você obtém desempenhos e qualidades muito diferentes.
:::tip
Testamos um grupo selecionado de modelos e provedores que funcionam bem com a opencode.
Testamos um grupo selecionado de modelos e provedores que funcionam bem com o opencode.
:::
Portanto, se você estiver usando um modelo através de algo como OpenRouter, você nunca pode ter certeza se está obtendo a melhor versão do modelo que deseja.
@@ -33,17 +33,17 @@ Para resolver isso, fizemos algumas coisas:
2. Trabalhamos com alguns provedores para garantir que esses modelos estivessem sendo servidos corretamente.
3. Finalmente, realizamos benchmarks da combinação modelo/provedor e elaboramos uma lista que nos sentimos bem em recomendar.
OpenCode Zen é um gateway de AI que lhe dá acesso a esses modelos.
O OpenCode Zen é um gateway de IA que lhe dá acesso a esses modelos.
---
## Como funciona
OpenCode Zen funciona como qualquer outro provedor na opencode.
O OpenCode Zen funciona como qualquer outro provedor no opencode.
1. Você faz login no **<a href={console}>OpenCode Zen</a>**, adiciona seus dados de cobrança e copia sua chave de API.
2. Você executa o comando `/connect` na TUI, seleciona OpenCode Zen e cola sua chave de API.
3. Execute `/models` na TUI para ver a lista de modelos que recomendamos.
2. Você executa o comando `/connect` no TUI, seleciona OpenCode Zen e cola sua chave de API.
3. Execute `/models` no TUI para ver a lista de modelos que recomendamos.
Você é cobrado por solicitação e pode adicionar créditos à sua conta.
@@ -85,7 +85,7 @@ Você também pode acessar nossos modelos através dos seguintes endpoints da AP
| Qwen3 Coder 480B | qwen3-coder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
| Big Pickle | big-pickle | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
O [id do modelo](/docs/config/#models) na sua configuração da opencode usa o formato `opencode/<model-id>`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração.
O [id do modelo](/docs/config/#models) na sua configuração do opencode usa o formato `opencode/<model-id>`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração.
---
@@ -147,10 +147,10 @@ As taxas de cartão de crédito são repassadas ao custo (4,4% + $0,30 por trans
Os modelos gratuitos:
- GLM 4.7 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- Kimi K2.5 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- MiniMax M2.1 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- Big Pickle é um modelo oculto que está gratuito na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- GLM 4.7 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- Kimi K2.5 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- MiniMax M2.1 Free está disponível no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
- Big Pickle é um modelo oculto que está gratuito no opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
<a href={email}>Entre em contato conosco</a> se você tiver alguma dúvida.
@@ -158,7 +158,7 @@ Os modelos gratuitos:
### Recarga automática
Se seu saldo cair abaixo de $5, Zen recarregará automaticamente $20.
Se seu saldo cair abaixo de $5, o Zen recarregará automaticamente $20.
Você pode alterar o valor da recarga automática. Você também pode desativar a recarga automática completamente.
@@ -168,7 +168,7 @@ Você pode alterar o valor da recarga automática. Você também pode desativar
Você também pode definir um limite de uso mensal para todo o espaço de trabalho e para cada membro de sua equipe.
Por exemplo, digamos que você defina um limite de uso mensal de $20, Zen não usará mais de $20 em um mês. Mas se você tiver a recarga automática ativada, Zen pode acabar cobrando mais de $20 se seu saldo cair abaixo de $5.
Por exemplo, digamos que você defina um limite de uso mensal de $20, o Zen não usará mais de $20 em um mês. Mas se você tiver a recarga automática ativada, o Zen pode acabar cobrando mais de $20 se seu saldo cair abaixo de $5.
---
@@ -187,7 +187,7 @@ Todos os nossos modelos estão hospedados nos EUA. Nossos provedores seguem uma
## Para Equipes
Zen também funciona muito bem para equipes. Você pode convidar colegas de equipe, atribuir funções, selecionar os modelos que sua equipe usa e muito mais.
O Zen também funciona muito bem para equipes. Você pode convidar colegas de equipe, atribuir funções, selecionar os modelos que sua equipe usa e muito mais.
:::note
Os espaços de trabalho estão atualmente gratuitos para equipes como parte do beta.
@@ -233,4 +233,4 @@ Criamos o OpenCode Zen para:
1. **Benchmark** os melhores modelos/provedores para agentes de codificação.
2. Ter acesso às opções de **mais alta qualidade** e não degradar o desempenho ou redirecionar para provedores mais baratos.
3. Repassar quaisquer **reduções de preço** vendendo ao custo; assim, a única margem é para cobrir nossas taxas de processamento.
4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com a opencode também.
4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com o opencode também.