Dax
59 lines
1.5 KiB
Plaintext
59 lines
1.5 KiB
Plaintext
---
|
|
title: "Intro"
|
|
---
|
|
|
|
Run the CLI in a project to open the full-screen terminal interface:
|
|
|
|
```bash
|
|
opencode2
|
|
```
|
|
|
|
Pass a directory to work in a different project:
|
|
|
|
```bash
|
|
opencode2 ~/code/my-project
|
|
```
|
|
|
|
Suggested terminals:
|
|
|
|
- [Ghostty](https://ghostty.org)
|
|
- [WezTerm](https://wezterm.org)
|
|
- [Alacritty](https://alacritty.org)
|
|
- [Kitty](https://sw.kovidgoyal.net/kitty/)
|
|
|
|
Truecolor support gives themes their most accurate colors; terminals without it use an approximation of the available
|
|
palette.
|
|
|
|
## Automation
|
|
|
|
Use `opencode2 run` to submit a prompt without opening the interactive interface. It is designed for scripts, CI jobs, and
|
|
other workflows that need model output directly in the terminal.
|
|
|
|
```bash
|
|
opencode2 run "Explain this repository"
|
|
```
|
|
|
|
## Mini
|
|
|
|
Use `opencode2 mini` to start OpenCode's minimal interactive interface instead of the full-screen TUI.
|
|
|
|
```bash
|
|
opencode2 mini
|
|
```
|
|
|
|
Run `opencode2 mini --help` to see its session, model, agent, prompt, and replay options.
|
|
|
|
## Background service
|
|
|
|
By default, OpenCode discovers or starts one shared background server for your user account. Every local OpenCode client
|
|
connects to that server, which owns sessions, configuration, integrations, permissions, and tool execution.
|
|
|
|
Use `--standalone` to run with a private server, or `--server` to connect to a specific server URL:
|
|
|
|
```bash
|
|
opencode2 --standalone
|
|
opencode2 --server http://localhost:4096
|
|
```
|
|
|
|
See [Troubleshooting](/troubleshooting) for shared service diagnostics and the [API reference](/api) for server endpoints.
|