diff options
| author | Adam <[email protected]> | 2026-02-09 11:34:35 -0600 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-02-09 11:34:35 -0600 |
| commit | dc53086c1e73d43d3a28fc4cdf161e83d09b1877 (patch) | |
| tree | 45a1d0e38de958d0886a5120b2806b21db74145b /packages/web/src/content/docs/nb/commands.mdx | |
| parent | f74c0339cc6315f7e7743e26b7eab47ce026c239 (diff) | |
| download | opencode-dc53086c1e73d43d3a28fc4cdf161e83d09b1877.tar.gz opencode-dc53086c1e73d43d3a28fc4cdf161e83d09b1877.zip | |
wip(docs): i18n (#12681)
Diffstat (limited to 'packages/web/src/content/docs/nb/commands.mdx')
| -rw-r--r-- | packages/web/src/content/docs/nb/commands.mdx | 323 |
1 files changed, 323 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/nb/commands.mdx b/packages/web/src/content/docs/nb/commands.mdx new file mode 100644 index 000000000..7761c4f4a --- /dev/null +++ b/packages/web/src/content/docs/nb/commands.mdx @@ -0,0 +1,323 @@ +--- +title: Kommandoer +description: Lag egendefinerte kommandoer for repeterende oppgaver. +--- + +Egendefinerte kommandoer lar deg spesifisere en ledetekst du vil kjøre når kommandoen utføres i TUI. + +```bash frame="none" +/my-command +``` + +Egendefinerte kommandoer kommer i tillegg til de innebygde kommandoene som `/init`, `/undo`, `/redo`, `/share`, `/help`. [Finn ut mer](/docs/tui#commands). + +--- + +## Lag kommandofiler + +Lag nedmerkingsfiler i `commands/`-katalogen for å definere egendefinerte kommandoer. + +Opprett `.opencode/commands/test.md`: + +```md title=".opencode/commands/test.md" +--- +description: Run tests with coverage +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. +``` + +Frontmatter definerer kommandoegenskaper. Innholdet blir malen. + +Bruk kommandoen ved å skrive `/` etterfulgt av kommandonavnet. + +```bash frame="none" +"/test" +``` + +--- + +## Konfigurer + +Du kan legge til egendefinerte kommandoer gjennom OpenCode-konfigurasjonen eller ved å lage markdown-filer i katalogen `commands/`. + +--- + +### JSON + +Bruk alternativet `command` i OpenCode [config](/docs/config): + +```json title="opencode.jsonc" {4-12} +{ + "$schema": "https://opencode.ai/config.json", + "command": { + // This becomes the name of the command + "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", + "agent": "build", + "model": "anthropic/claude-3-5-sonnet-20241022" + } + } +} +``` + +Nå kan du kjøre denne kommandoen i TUI: + +```bash frame="none" +/test +``` + +--- + +### Markdown + +Du kan også definere kommandoer ved å bruke markdown-filer. Plasser dem i: + +- Globalt: `~/.config/opencode/commands/` +- Per prosjekt: `.opencode/commands/` + +```markdown title="~/.config/opencode/commands/test.md" +--- +description: Run tests with coverage +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. +``` + +Markdown-filnavnet blir kommandonavnet. For eksempel lar `test.md` +du løper: + +```bash frame="none" +/test +``` + +--- + +## Spør config + +Spørringene for de egendefinerte kommandoene støtter flere spesielle plassholdere og syntaks. + +--- + +### Argumenter + +Send argumenter til kommandoer ved å bruke plassholderen `$ARGUMENTS`. + +```md title=".opencode/commands/component.md" +--- +description: Create a new component +--- + +Create a new React component named $ARGUMENTS with TypeScript support. +Include proper typing and basic structure. +``` + +Kjør kommandoen med argumenter: + +```bash frame="none" +/component Button +``` + +Og `$ARGUMENTS` vil bli erstattet med `Button`. + +Du kan også få tilgang til individuelle argumenter ved å bruke posisjonelle parametere: + +- `$1` - Første argument +- `$2` - Andre argument +- `$3` - Tredje argument +- Og så videre... + +For eksempel: + +```md title=".opencode/commands/create-file.md" +--- +description: Create a new file with content +--- + +Create a file named $1 in the directory $2 +with the following content: $3 +``` + +Kjør kommandoen: + +```bash frame="none" +/create-file config.json src "{ \"key\": \"value\" }" +``` + +Dette erstatter: + +- `$1` med `config.json` +- `$2` med `src` +- `$3` med `{ "key": "value" }` + +--- + +### Shell-utgang + +Bruk _!`command`_ for å injisere [bash-kommando](/docs/tui#bash-commands)-utdata i ledeteksten. + +For eksempel, for å lage en egendefinert kommando som analyserer testdekning: + +```md title=".opencode/commands/analyze-coverage.md" +--- +description: Analyze test coverage +--- + +Here are the current test results: +!`npm test` + +Based on these results, suggest improvements to increase coverage. +``` + +Eller for å se gjennom nylige endringer: + +```md title=".opencode/commands/review-changes.md" +--- +description: Review recent changes +--- + +Recent git commits: +!`git log --oneline -10` + +Review these changes and suggest any improvements. +``` + +Kommandoer kjøres i prosjektets rotkatalog og utdataene deres blir en del av ledeteksten. + +--- + +### Filreferanser + +Inkluder filer i kommandoen din ved å bruke `@` etterfulgt av filnavnet. + +```md title=".opencode/commands/review-component.md" +--- +description: Review component +--- + +Review the component in @src/components/Button.tsx. +Check for performance issues and suggest improvements. +``` + +Filinnholdet blir automatisk inkludert i ledeteksten. + +--- + +## Alternativer + +La oss se på konfigurasjonsalternativene i detalj. + +--- + +### Mal + +Alternativet `template` definerer ledeteksten som vil bli sendt til LLM når kommandoen utføres. + +```json title="opencode.json" +{ + "command": { + "test": { + "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes." + } + } +} +``` + +Dette er et **obligatorisk** konfigurasjonsalternativ. + +--- + +### Beskrivelse + +Bruk alternativet `description` for å gi en kort beskrivelse av hva kommandoen gjør. + +```json title="opencode.json" +{ + "command": { + "test": { + "description": "Run tests with coverage" + } + } +} +``` + +Dette vises som beskrivelsen i TUI når du skriver inn kommandoen. + +--- + +### Agent + +Bruk `agent`-konfigurasjonen for å spesifisere hvilken [agent](/docs/agents) som skal utføre denne kommandoen. +Hvis dette er en [subagent](/docs/agents/#subagents), vil kommandoen utløse en subagent påkalling som standard. +For å deaktivere denne virkemåten, sett `subtask` til `false`. + +```json title="opencode.json" +{ + "command": { + "review": { + "agent": "plan" + } + } +} +``` + +Dette er et **valgfritt** konfigurasjonsalternativ. Hvis det ikke er spesifisert, brukes din nåværende agent som standard. + +--- + +### Deloppgave + +Bruk `subtask` boolsk for å tvinge kommandoen til å utløse en [subagent](/docs/agents/#subagents) påkalling. +Dette er nyttig hvis du vil at kommandoen ikke skal forurense din primære kontekst og vil **tvinge** agenten til å fungere som en underagent, +selv om `mode` er satt til `primary` på [agent](/docs/agents) konfigurasjonen. + +```json title="opencode.json" +{ + "command": { + "analyze": { + "subtask": true + } + } +} +``` + +Dette er et **valgfritt** konfigurasjonsalternativ. + +--- + +### Modell + +Bruk `model`-konfigurasjonen for å overstyre standardmodellen for denne kommandoen. + +```json title="opencode.json" +{ + "command": { + "analyze": { + "model": "anthropic/claude-3-5-sonnet-20241022" + } + } +} +``` + +Dette er et **valgfritt** konfigurasjonsalternativ. + +--- + +## Innebygd + +opencode inkluderer flere innebygde kommandoer som `/init`, `/undo`, `/redo`, `/share`, `/help`; [finn ut mer](/docs/tui#commands). + +:::note +Egendefinerte kommandoer kan overstyre innebygde kommandoer. +::: + +Hvis du definerer en egendefinert kommando med samme navn, vil den overstyre den innebygde kommandoen. |
