diff options
| author | opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com> | 2026-04-27 05:18:33 +0000 |
|---|---|---|
| committer | opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com> | 2026-04-27 05:18:33 +0000 |
| commit | 17701628bd4370067a1e2613043a9da14f8e302f (patch) | |
| tree | ea3b800db8b4d0429d5b38c25bf58a9b0c620450 | |
| parent | 0efc6163f1d58a529db327b94bea2ceab55e729b (diff) | |
| download | opencode-17701628bd4370067a1e2613043a9da14f8e302f.tar.gz opencode-17701628bd4370067a1e2613043a9da14f8e302f.zip | |
chore: generate
| -rw-r--r-- | packages/opencode/src/cli/cmd/agent.ts | 15 | ||||
| -rw-r--r-- | packages/web/src/content/docs/agents.mdx | 36 | ||||
| -rw-r--r-- | packages/web/src/content/docs/cli.mdx | 14 |
3 files changed, 39 insertions, 26 deletions
diff --git a/packages/opencode/src/cli/cmd/agent.ts b/packages/opencode/src/cli/cmd/agent.ts index f174c49d0..1d804c00e 100644 --- a/packages/opencode/src/cli/cmd/agent.ts +++ b/packages/opencode/src/cli/cmd/agent.ts @@ -18,7 +18,20 @@ type AgentMode = "all" | "primary" | "subagent" // Permission keys (not raw tool names). Multiple tools can map to a single // permission — e.g. write/edit/apply_patch all gate on `edit` — so we configure // agents at the permission level to match how the runtime actually enforces it. -const AVAILABLE_PERMISSIONS = ["bash", "read", "edit", "glob", "grep", "webfetch", "task", "todowrite", "websearch", "codesearch", "lsp", "skill"] +const AVAILABLE_PERMISSIONS = [ + "bash", + "read", + "edit", + "glob", + "grep", + "webfetch", + "task", + "todowrite", + "websearch", + "codesearch", + "lsp", + "skill", +] const AgentCreateCommand = cmd({ command: "create", diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx index 47a3effd0..7c5f21787 100644 --- a/packages/web/src/content/docs/agents.mdx +++ b/packages/web/src/content/docs/agents.mdx @@ -421,24 +421,24 @@ You can configure permissions to manage what actions an agent can take. Each per The available permission keys are: -| Key | Tools it gates | -| -------------------- | ----------------------------------------------------------------------------- | -| `read` | `read` | -| `edit` | `write`, `edit`, `apply_patch` | -| `glob` | `glob` | -| `grep` | `grep` | -| `list` | `list` | -| `bash` | `bash` | -| `task` | `task` | -| `external_directory` | Any tool that reads or writes files outside the project worktree | -| `todowrite` | `todowrite`, `todoread` | -| `webfetch` | `webfetch` | -| `websearch` | `websearch` | -| `codesearch` | `codesearch` | -| `lsp` | `lsp` | -| `skill` | `skill` | -| `question` | `question` | -| `doom_loop` | Recovery prompts when an agent appears stuck | +| Key | Tools it gates | +| -------------------- | ---------------------------------------------------------------- | +| `read` | `read` | +| `edit` | `write`, `edit`, `apply_patch` | +| `glob` | `glob` | +| `grep` | `grep` | +| `list` | `list` | +| `bash` | `bash` | +| `task` | `task` | +| `external_directory` | Any tool that reads or writes files outside the project worktree | +| `todowrite` | `todowrite`, `todoread` | +| `webfetch` | `webfetch` | +| `websearch` | `websearch` | +| `codesearch` | `codesearch` | +| `lsp` | `lsp` | +| `skill` | `skill` | +| `question` | `question` | +| `doom_loop` | Recovery prompts when an agent appears stuck | `read`, `edit`, `glob`, `grep`, `list`, `bash`, `task`, `external_directory`, `lsp`, and `skill` accept either a shorthand action (`"allow" | "ask" | "deny"`) or an object of glob/pattern → action for fine-grained control. The remaining keys accept the shorthand action only. diff --git a/packages/web/src/content/docs/cli.mdx b/packages/web/src/content/docs/cli.mdx index 2fad7c2b6..0df6b376e 100644 --- a/packages/web/src/content/docs/cli.mdx +++ b/packages/web/src/content/docs/cli.mdx @@ -97,13 +97,13 @@ This command will guide you through creating a new agent with a custom system pr #### Flags -| Flag | Description | -| ---------------- | ---------------------------------------------------------------------------------------------------------- | -| `--path` | Directory to write the agent file to (defaults to global or `.opencode/agent` based on the prompt) | -| `--description` | What the agent should do | -| `--mode` | Agent mode: `all`, `primary`, or `subagent` | -| `--permissions` | Comma-separated list of permissions to allow (default: all). Available: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `codesearch`, `lsp`, `skill`. Anything omitted is denied. Alias: `--tools` | -| `--model`, `-m` | Model to use, in `provider/model` format | +| Flag | Description | +| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `--path` | Directory to write the agent file to (defaults to global or `.opencode/agent` based on the prompt) | +| `--description` | What the agent should do | +| `--mode` | Agent mode: `all`, `primary`, or `subagent` | +| `--permissions` | Comma-separated list of permissions to allow (default: all). Available: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `codesearch`, `lsp`, `skill`. Anything omitted is denied. Alias: `--tools` | +| `--model`, `-m` | Model to use, in `provider/model` format | Passing all of `--path`, `--description`, `--mode`, and `--permissions` runs the command non-interactively. |